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.
- 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:
- Abra o assistente e vá até a aba Cenários.
- Clique em Adicionar cenário.
- Preencha o Título com um nome claro para o sub-comportamento.
- Escreva a Instrução descrevendo como a Eva deve agir nesse cenário.
- Deixe o alternador Ativado ligado para que o cenário fique em uso.
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.
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.
- Para revisar as configurações básicas do assistente, veja Criar um assistente Eva.