![Visão geral dos Cenários e Ferramentas personalizadas da Eva: cenários são sub-comportamentos especializados, ferramentas personalizadas chamam suas APIs HTTPS, a referência tool:// faz um cenário acionar uma ferramenta e a autenticação usa credenciais somente gravação.](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcFVRIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--dc22b3ecf0cb8d8ae1a9b3c51964c7c7ead0b748/cenarios-e-ferramentas-da-eva.png)

A Eva vai além de um único conjunto de instruções. Com os **Cenários**, você cria sub-comportamentos especializados para situações específicas; com as **Ferramentas personalizadas**, permite que a Eva chame as suas próprias APIs durante a conversa. Este artigo mostra as abas **Cenários** e **Ferramentas personalizadas** do editor do assistente.

## Antes de começar

- Você precisa ter um assistente Eva já criado. Se ainda não tem, veja [Criar um assistente Eva](criar-um-assistente-eva).
- **Salve o assistente primeiro.** As abas **Cenários** e **Ferramentas personalizadas** só ficam disponíveis depois que o assistente é salvo.
- Cenários e ferramentas se complementam: um cenário pode acionar uma ferramenta pela referência `tool://`.

## Cenários

Um cenário é um sub-comportamento especializado da Eva. Use-os quando quiser que a Eva conduza um tipo específico de atendimento de forma diferente — por exemplo, um especialista em reembolsos.

Cada cenário tem dois campos:

- **Título** — o nome do sub-comportamento (ex.: *Especialista em reembolsos*).
- **Instrução** — como esse especialista deve conduzir a conversa.

Para criar um cenário:

1. Abra o assistente e vá até a aba **Cenários**.
2. Clique em **Adicionar cenário**.
3. Preencha o **Título** com um nome claro para o sub-comportamento.
4. Escreva a **Instrução** descrevendo como a Eva deve agir nesse cenário.
5. Deixe o alternador **Ativado** ligado para que o cenário fique em uso.

![Aba Cenários do assistente Eva: campos Título e Instrução, a lista de ferramentas disponíveis (tool://) e o cenário "Especialista em reembolsos" já cadastrado](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcFlRIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--5f7753e2f653ebd4030ef5a314d47ec1574f6135/eva-cenarios.png)

### Referenciar ferramentas em um cenário

Dentro do texto da **Instrução**, você pode referenciar uma ferramenta usando o formato `tool://nome_da_ferramenta` — por exemplo, `tool://resolve_conversation`.

A lista **Ferramentas disponíveis:** mostra os identificadores válidos que você pode referenciar. Referências que não correspondem a nenhum identificador válido são simplesmente **ignoradas**, portanto confira o nome exato antes de salvar.

## Ferramentas personalizadas

As **Ferramentas personalizadas** permitem que a Eva chame as suas próprias APIs HTTPS durante a conversa — por exemplo, para consultar um sistema externo e usar o resultado na resposta.

Para adicionar uma ferramenta, abra a aba **Ferramentas personalizadas** e preencha os campos:

- **Nome** — o nome da ferramenta (ex.: *Consulta de pedido*).
- **Slug** — o identificador usado nas referências `tool://` (ex.: `weather_lookup`).
- **Método** — o método HTTP da requisição: **GET** ou **POST**.
- **Endpoint** — o endereço da sua API. Aceita **apenas HTTPS**, com um **domínio fixo** (sem IP e sem `localhost`).
- **Descrição** — o texto exibido ao modelo, explicando o que a ferramenta faz e quando usá-la.

Clique em **Adicionar ferramenta** para salvá-la. Ela passa a aparecer na lista abaixo, onde você pode ligá-la ou desligá-la pelo alternador, **Testar** a chamada, **Editar** ou **Excluir**.

![Aba Ferramentas personalizadas: formulário Nome, Slug, método GET/POST, Endpoint e Descrição, com a ferramenta "Consulta de pedido" já cadastrada](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcGNRIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--ba23d59351c8abfe4aaf4862c0d9b4b062f14bdb/eva-ferramentas.png)

### Autenticação e credenciais

Se a sua API exigir autenticação, configure-a em **Editar**, na própria ferramenta. Os tipos disponíveis são:

- **Nenhuma**
- **Token Bearer**
- **Autenticação básica**
- **Cabeçalho de chave de API**

As credenciais são **somente gravação**: por segurança, elas não são exibidas de volta na tela.

- Para **alterar** uma credencial, digite-a novamente.
- Para **manter** a credencial atual, deixe o campo em branco.

## Lembre-se

- **Salve o assistente antes** de gerenciar cenários e ferramentas — sem isso, as abas não ficam disponíveis.
- Uma ferramenta só é acionada em um cenário quando referenciada corretamente por `tool://` com o **Slug** exato.

## Próximos passos

- Para alimentar a Eva com conteúdo de apoio, veja [Base de conhecimento da Eva](base-de-conhecimento-da-eva).
- Para revisar as configurações básicas do assistente, veja [Criar um assistente Eva](criar-um-assistente-eva).