Pular para o conteúdo
Voltar para Construa seus primeiros agentes

Construa seus primeiros agentes · Capítulo 5 de 8

Ferramentas e chamadas de ferramenta

Definir ferramentas com zod, vinculá-las a um modelo e tratar as chamadas de ferramenta que o modelo faz.

20 minutos0 de 3 objetivos concluídos

Objetivos

  • Adicione um campo descrito ao schema de uma ferramenta e veja o JSON Schema mudar.A fazer
  • Envie argumentos inválidos e veja a validação rejeitá-los.A fazer
  • Passe na verificação.A fazer

Passo 1 de 4: A leitura

Uma ferramenta é uma função com um schema

tool(fn, { name, description, schema }), de @langchain/core/tools, transforma uma função async em uma ferramenta. O schema é um objeto zod: z.object({ order_id: z.string().describe("The order number") }). Ele diz quais argumentos a ferramenta recebe, seus tipos e quais são opcionais.

O schema serve duas vezes. O LangChain o converte em JSON Schema, que é o que o modelo lê. E seu código o usa para verificar os argumentos que o modelo envia antes que sua função rode.

O que o modelo vê

model.bindTools(tools) devolve um modelo que envia o nome, a descrição e o JSON Schema de cada ferramenta em toda chamada. A função em si nunca sai do seu código. O modelo só sabe o que esses três lhe dizem, então as descrições são prompts: escreva-as para o modelo e descreva cada campo com .describe().

Uma chamada de ferramenta e sua resposta

Quando o modelo quer uma ferramenta, sua resposta é um AIMessage com tool_calls: cada chamada tem um name, args e um id. Seu código executa a ferramenta e responde com um ToolMessage que traz o mesmo tool_call_id. Um modelo pode pedir várias chamadas de uma vez, então é o id que liga cada resultado à sua chamada.

Passe a chamada de ferramenta inteira para tool.invoke(). A ferramenta valida os args contra o seu schema, executa sua função e devolve o ToolMessage para você. Se os args não batem, ela lança ToolInputParsingException e sua função nunca roda. Um loop de agente captura o erro e o envia de volta como um ToolMessage com status "error", para que o modelo possa corrigir a chamada. No capítulo 6, o ToolNode faz isso por você.

Passo 2 de 4: Experimente: Do zod à chamada de ferramenta

Do zod à chamada de ferramenta

Adicione um campo ao schema de uma ferramenta e veja o que o modelo lê. Depois passe a chamada do modelo pela validação real, uma vez com argumentos válidos e outra com argumentos que você escolhe.

Modo:RealSimuladoReal: o zod, o tool() do LangChain, a conversão para JSON Schema e a validação rodam nesta página. Simulado: o modelo é roteirizado e não lê o schema. As chamadas de ferramenta dele são definidas de antemão, e no último passo você escolhe os argumentos. Os dados do pedido são fictícios.

Passo 3 de 4: Verificação

Verificação

Pergunta 1 de 3O que o modelo recebe sobre uma ferramenta vinculada?

Próximo: Pergunta 2 de 3

Pergunta 2 de 3O que liga um ToolMessage à chamada que ele responde?
Pergunta 3 de 3O modelo envia order_id como number, mas o schema diz z.string(). O que acontece?

Passo 4 de 4: O que você já sabe fazer

O que você já sabe fazer

  • Definir uma ferramenta com tool() e um schema zod, com descrições úteis.
  • Vincular ferramentas a um modelo e ler seus tool_calls.
  • Responder a uma chamada de ferramenta com um ToolMessage e tratar argumentos inválidos.