Skip to main content

​
O que são as ferramentas

As ferramentas são capacidades que o agente pode invocar durante uma conversa: encerrar a chamada, transferir para uma pessoa, consultar dados externos, validar informações, etc. A aba Ferramentas do agente tem dois painéis: as funções gerais (sempre disponíveis) e as ferramentas específicas atribuídas ao bot.

​
Funções gerais

São ferramentas nativas da plataforma que você pode ativar ou desativar com um toggle para cada agente: Painel de funções gerais com toggles por agente
Não é necessário ativar todas as funções em todos os agentes. Ative apenas as que fazem sentido para o papel daquele agente no fluxo. Por exemplo, só o agente de encerramento precisa de “Encerrar Conversa”.

​
Ferramentas atribuídas

Além das funções gerais, um agente pode ter ferramentas personalizadas — integrações com sistemas externos, consultas a APIs, registros em bancos de dados, etc. Essas ferramentas são exibidas em uma tabela com:
  • Nome — como o agente as identifica.
  • Documentação — descrição do que faz e quando usar (o LLM lê isso para decidir se deve chamá-la).
  • Parâmetros — os dados que a ferramenta precisa para ser executada.
Tabela de ferramentas atribuídas ao agente
A documentação de cada ferramenta é fundamental. O LLM a usa para decidir se deve chamar essa ferramenta e com quais parâmetros. Quanto mais clara e específica, melhor — veja Documente bem suas ferramentas para mais detalhes.
Para adicionar ferramentas a um agente, use o botão Atribuir ferramentas: um painel se abre com duas abas. Painel Atribuir ferramentas com a lista de ferramentas disponíveis para atribuir
  • Atribuir: escolha entre as ferramentas já criadas para o bot (busca + checkbox por ferramenta, ou “Selecionar todas”).
  • Criar nova: o mesmo formulário de criação do botão Novo de Ferramentas do bot (Nome, Parâmetros, Documentação, Código e Tipo de dado de retorno) — a ferramenta que você criar aqui também fica disponível para os outros agentes do bot.
Aba Criar nova do painel Atribuir ferramentas, com o formulário de criação
Quer confirmar que o agente chama a ferramenta no momento certo? Teste com Abrir conversa antes de publicar as alterações.

​
Variáveis capturadas pelo bot durante a conversa

O agente Pós-Conversa (veja O canvas de agentes) não só atribui a etiqueta de resultado — ele tem sua própria ferramenta atribuída, assim como qualquer agente pode ter as suas, e é essa ferramenta que dispara a classificação. Editor da ferramenta atribuída ao agente Pós-Conversa, com seus parâmetros e código Além do parâmetro que indica a etiqueta, essa ferramenta pode ter outros parâmetros que o LLM preenche a partir do que o contato disse durante a chamada — por exemplo, o motivo pelo qual não pôde pagar, um dado específico que mencionou, ou um resumo curto da conversa.
Esses parâmetros são adicionados igual a qualquer ferramenta, com Adicionar parâmetro (veja Ferramentas do bot) — a diferença é que aqui o LLM os preenche analisando toda a conversa, não uma única mensagem do contato.

​
Tornar esses valores visíveis com extra_metadata

Sozinhos, esses parâmetros só existem dentro do código da ferramenta. Para que um valor fique disponível mais tarde — por exemplo, para que sua equipe o veja no caso dentro do Bot Manager — é preciso carregá-lo explicitamente no dicionário especial extra_metadata, dentro do campo Código da ferramenta:
Qualquer variável que você carregar ali fica visível no caso daquela chamada: Caso no Bot Manager mostrando os valores carregados em extra_metadata
Use o extra_metadata para tudo o que sua equipe precisar conferir rapidamente sem ouvir a chamada inteira — um resumo da conversa, um dado específico que o contato deu, o motivo por trás de uma recusa, etc.