Ferramentas em nível de bot
A seção Ferramentas do bot (não do agente) é o repositório central de ferramentas personalizadas disponíveis para esse bot. É diferente da aba Ferramentas dentro de cada agente — aqui é onde as ferramentas são definidas, e a partir dos agentes elas são atribuídas.Esta visão mostra apenas as ferramentas customizadas criadas para o seu bot — integrações com sistemas externos, consultas a APIs, etc. As funções gerais da plataforma (Encerrar Conversa, Transferir para Agente Humano, Detectar Correio de Voz, etc.) não aparecem aqui: essas são ativadas por agente, na aba Ferramentas de cada agente.
Como as ferramentas funcionam
Quando o agente decide chamar uma ferramenta, a plataforma:1
Extrai os parâmetros
O LLM identifica os valores necessários a partir do contexto da conversa e dos parâmetros do arquivo de campanha.
2
Executa a ferramenta
A plataforma chama o serviço externo (API, banco de dados, etc.) com os parâmetros extraídos.
3
Retorna o resultado ao agente
O resultado é incorporado ao contexto do LLM para que o agente possa usá-lo em sua resposta.
Como criar uma ferramenta
Você pode criar uma ferramenta nova a partir do botão Novo nesta visão, ou na aba Ferramentas de um agente (veja Ferramentas do agente) — o formulário é o mesmo nos dois casos.
1
Nome
O identificador com o qual o agente vai referenciar a ferramenta.
2
Parâmetros
Com Adicionar parâmetro você define cada dado que a ferramenta precisa: seu nome, o tipo de dado (
str, int, float, bool, dict, listas desses tipos, ou uma versão opcional com valor padrão) e uma descrição.3
Documentação
O docstring da ferramenta: o que faz, quando usar e o que retorna. É isso que o LLM lê para decidir se deve chamá-la — quanto mais clara e específica, melhor.
4
Código
O corpo da função, em Python — não inclui a linha
def, a plataforma a adiciona automaticamente. Precisa incluir um return (um valor, None, ou vazio) e pode ler e modificar o dicionário context da conversa, assim como na aba Lógica do agente.5
Tipo de dado de retorno
O tipo de dado que a ferramenta retorna (
str, int, float, bool, dict, listas desses tipos, ou Outro para especificar um tipo personalizado).