Ferramentas de Agentes
Ir para notas que citam estaFerramentas de agentes (tools) são as ações concretas que um agente de IA pode executar além de responder em texto, como chamar uma API, consultar um banco ou enviar um e-mail.
São elas que separam um agente de uma chamada comum a um modelo de linguagem. Um LLM sozinho só conhece o que aprendeu no treinamento e não interfere em nada fora da conversa; com ferramentas, ele busca informação que não tem, calcula, grava, dispara processos. Por isso, interagir com o ambiente por meio de tools é tratado como pré-requisito para chamar um código com LLM de agente.
O que transforma uma função em ferramenta
Por baixo, uma ferramenta é código comum: uma função simples que faz um cálculo ou exibe algo, ou uma integração completa com um sistema externo. O que a torna utilizável pelo modelo é a forma como ela se apresenta. Cada tool tem um nome que a identifica, uma descrição do que faz e de quando deve ser usada, e uma lista de parâmetros tipados, com a indicação de quais são obrigatórios e do que cada um representa. O retorno precisa voltar num formato que o modelo consiga ler e incorporar à resposta; uma tool de busca, por exemplo, pode anteceder o texto recuperado com um aviso de que aquilo é contexto adicional.
A descrição funciona como prompt. É lendo nome e descrição que o modelo decide qual ferramenta acionar para cada pedido, sem que ninguém diga explicitamente qual usar. Descrição vaga leva à ferramenta errada ou a nenhuma; descrição precisa, tanto da tool quanto de cada parâmetro, é o que faz o agente acertar. O ciclo em que o modelo pede a execução e recebe o resultado é o Function Calling; a forma padronizada de expor ferramentas a qualquer agente é o Model Context Protocol.
Exemplos e decisões de desenho
O repertório típico inclui ler PDF, pesquisar na web, fazer requisições HTTP, consultar um banco relacional e buscar num banco vetorial, caso em que a recuperação vira mais uma ferramenta que o agente decide quando usar, como no RAG Agêntico. Num agente de e-mail, uma tool pode consultar o padrão de escrita do usuário guardado em banco, outra escolher entre modelos de mensagem, outra ler o perfil corporativo para descobrir o gerente e seu endereço. Num fluxo de compra, cada ação vira uma tool separada: adicionar ao carrinho, ver carrinho, buscar no catálogo, fechar o pedido. Ferramentas também podem cuidar da apresentação, como exibir o carrinho em tabela.
Cálculo merece ferramenta própria. Modelos nem sempre acertam contas, e uma função simples resolve de forma mais barata e confiável do que gastar processamento do modelo. Outro agente também pode servir de ferramenta: o agente principal chama, como se fosse uma tool, um subagente especializado em escrever e-mails com boas práticas.
Cada tool amplia o poder de agência, mas também o que o agente consegue fazer de errado. Dar acesso a uma conta de e-mail corporativa é conveniente e perigoso ao mesmo tempo. Os Guardrails e as permissões de acesso precisam crescer junto com a lista de ferramentas, e o agente nunca deve conhecer a senha em si.