Ferramentas do agente
Ferramentas são o que o agente consegue fazer além de conversar: consultar um sistema, exibir um card, coletar um formulário, mostrar um mapa, pesquisar na web, gerar uma imagem.
A tabela lista Nome, Tipo, Habilitada, Ordem e Atualizada em, com as ações Editar e Excluir. Desabilitar uma ferramenta é mais seguro que excluí-la quando você só quer testar o comportamento sem ela.
Clique em + Nova Ferramenta. O primeiro campo é o Tipo, e é ele que determina o restante do formulário. Em seguida vêm Nome, Ativar ferramenta e Descrição.
| Tipo | Para que serve | Onde está detalhado |
|---|---|---|
| External API | Chamar um endpoint de outro sistema | API Externa |
| Sub Agent | Delegar parte do trabalho a outro agente | Ferramentas nativas |
| Generic Card / HTML Card | Exibir conteúdo formatado no chat | Ferramentas nativas |
| Mapa | Mostrar pontos no mapa | Ferramentas nativas |
| Forms | Coletar dados estruturados | Ferramentas nativas |
| Geração de imagens | Criar imagens durante a conversa | Ferramentas nativas |
| Pesquisa Web | Buscar informação atual, com fontes | Ferramentas nativas |
| Enviar Texto / Enviar Arquivo / Resolver Conteúdo de Arquivo | Enviar conteúdo e ler arquivos da conversa | Ferramentas nativas |
A descrição é o que faz a ferramenta funcionar
Seção intitulada “A descrição é o que faz a ferramenta funcionar”Todo tipo tem o campo Descrição, com o aviso “Esta descrição ajuda o LLM a entender quando usar esta ferramenta”. Não é documentação interna: é a instrução que decide se o agente aciona ou não a ferramenta.
Escreva-a como um gatilho, não como um rótulo:
| Evite | Prefira |
|---|---|
| ”Consulta de pedidos" | "Consulta a situação de um pedido pelo número. Use sempre que a pessoa perguntar onde está o pedido, se já foi enviado ou qual o código de rastreio." |
| "Busca na web" | "Pesquisa informações públicas e atuais na internet. Use quando a resposta depender de dados que não estão nos documentos do agente.” |
Diga também quando não usar, se houver risco de acionamento indevido.
A coluna Ordem organiza a apresentação das ferramentas ao modelo. Na prática, agentes com muitas ferramentas erram mais na escolha: se o agente está acionando a ferramenta errada, o caminho não é reordenar, é reduzir o número de ferramentas ou tornar as descrições mais distintas entre si.
Abra o chat e faça a pergunta que deveria acionar a ferramenta. O bloco Atividade, acima da resposta, mostra o que o agente executou naquele turno — é onde você confirma se a ferramenta foi chamada.