Tool Calling

AgentsTool Calling
Zoen

Um bloco Agent puro é texto entrando, uma passagem pelo modelo, texto saindo — ele não consegue consultar nada. Dê ferramentas a ele, e ele começa a trabalhar em um loop: decidindo qual ferramenta precisa, chamando-a (várias de uma vez quando pode), lendo o que volta, e chamando de novo com argumentos melhores até ter o suficiente para responder.

What you will learn

O loop de ferramentas

A cada turno o modelo decide se precisa de uma ferramenta e qual. Cada resultado é adicionado ao contexto, então cada passo se apoia no anterior até convergir.

Qualquer bloco pode ser uma ferramenta

Ferramentas são adicionadas na seção Tools do bloco. Fixe os parâmetros que quiser travados; o que deixar vazio, o modelo preenche de forma inteligente a partir da tarefa.

Auto vs Force

Por padrão o modelo escolhe quando usar uma ferramenta. Force garante que use: o controle de uso em cada entrada de ferramenta.

Audite nos logs

O registro da execução guarda cada chamada em ordem: o nome da ferramenta, os argumentos que o modelo preencheu, e o resultado que voltou. Você rastreia exatamente por que ele respondeu do jeito que respondeu.

Aqui está o agente do vídeo com suas ferramentas anexadas:

O que as ferramentas mudam

Sem ferramentas, um agente tem só o prompt e o treinamento — pedido para qualificar um lead, só consegue dizer que não tem como consultar nada. Com ferramentas anexadas, o mesmo bloco planeja: pesquisar a empresa, checar o funding, ler a página de carreiras. Ele chama ferramentas em paralelo quando as chamadas não dependem umas das outras, revisa o plano conforme os resultados chegam, e só responde quando o contexto tem o suficiente.

Ferramentas são blocos

Qualquer coisa que você usaria como passo de workflow pode ser entregue a um agente como ferramenta. Na seção Tools você trava os parâmetros que nunca devem mudar e deixa o resto vazio: o modelo preenche esses por tarefa. E quando nenhum bloco faz o que você precisa, você escreve uma ferramenta customizada: um schema e uma descrição, onde a descrição é como o modelo sabe quando alcançá-la. Conjuntos inteiros de ferramentas externas se conectam do mesmo jeito via MCP.

A trilha de auditoria

Toda execução de agente registra suas chamadas de ferramenta em ordem. Abra o log e percorra: o nome de cada ferramenta, os argumentos exatos que o modelo escolheu, o resultado que voltou para o contexto. Depurar um agente é ler essa sequência, não chutar o que o modelo estava pensando.

Common Questions

Qualquer integração ou bloco do Zoen: busca na web, GitHub, HubSpot, Slack, consultas a banco, outros workflows. Você também pode definir ferramentas customizadas com um schema e uma descrição, ou conectar conjuntos inteiros de ferramentas externas via MCP.
A partir do nome e da descrição de cada ferramenta, julgados contra a tarefa no contexto. Por isso uma descrição clara importa: é o único sinal que o modelo tem de quando alcançar a ferramenta.
Sim. Quando as chamadas não dependem umas das outras, o modelo as dispara em paralelo e lê todos os resultados juntos no próximo turno do loop.
Sim. Cada entrada de ferramenta tem um controle de uso: Auto deixa o modelo decidir, e Force garante que a ferramenta rode durante o loop.
Abra o log da execução. Cada chamada de ferramenta é registrada em ordem com o nome da ferramenta, os argumentos que o modelo preencheu, e o resultado que voltou para o contexto.

Documentação relacionada