Ferramentas Dinâmicas

Uma Ferramenta é uma ação que um cliente de IA pode executar — chamar um endpoint de API, rodar uma query de banco de dados, ou executar uma cadeia. Ferramentas são o que transforma uma API passiva em algo sobre o qual um agente de IA pode realmente agir.

O que você pode fazer

• Gerar ferramentas automaticamente a partir de cada operação em uma especificação OpenAPI/Postman importada.
• Adicionar, editar ou excluir ferramentas manualmente quando precisar de controle total sobre o que é exposto.
• Definir o JSON Schema de entrada e saída de cada ferramenta, para que o cliente de IA saiba exatamente o que enviar e o que vai receber de volta.
• Testar uma ferramenta diretamente na aplicação antes de entregá-la a um cliente de IA.
• Anexar notas e comentários a uma ferramenta para que os colegas saibam por que ela existe ou o que mudou.
• Transformar a resposta JSON bruta de uma ferramenta em uma view HTML renderizada usando um template Handlebars, para clientes de IA que conseguem exibir saída rica. Veja Como Adicionar Saída HTML a uma Ferramenta.

Como usar

1. Abra um servidor e vá na aba Ferramentas.
2. Selecione uma ferramenta para revisar ou editar seu nome, descrição e schema — uma redação clara e específica aqui afeta diretamente o quão bem um cliente de IA a utiliza.
3. Use o painel de teste embutido para chamar a ferramenta e inspecionar a resposta antes de confiar nela.
4. Habilite ou desabilite ferramentas individualmente para controlar o que fica visível para clientes de IA e na página de documentação pública, sem excluí-las.

Bom saber

• A descrição de uma ferramenta é o que a IA lê para decidir quando e como chamá-la — trate-a como documentação voltada a um leitor muito literal.
• Relacionado: Cadeias para combinar várias ferramentas em uma única chamada, Gerenciamento de Servidores MCP.