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.
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
Próximo: Pergunta 2 de 3
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.