Bau deine ersten Agenten · Kapitel 5 von 8
Tools und Tool-Calls
Tools mit zod definieren, an ein Modell binden und die Tool-Calls des Modells verarbeiten.
Ziele
- Füg dem Schema eines Tools ein beschriebenes Feld hinzu und sieh, wie sich sein JSON Schema ändert.Offen
- Sende ungültige Argumente und sieh, wie die Validierung sie ablehnt.Offen
- Besteh den Check.Offen
Schritt 1 von 4: Der Text
Ein Tool ist eine Funktion mit Schema
tool(fn, { name, description, schema }) aus @langchain/core/tools macht aus einer async-Funktion ein Tool. Das Schema ist ein zod-Objekt: z.object({ order_id: z.string().describe("The order number") }). Es legt fest, welche Argumente das Tool nimmt, welche Typen sie haben und welche optional sind.
Das Schema dient zweimal. LangChain wandelt es in JSON Schema um, und das liest das Modell. Und dein Code prüft damit die Argumente, die das Modell schickt, bevor deine Funktion läuft.
Was das Modell sieht
model.bindTools(tools) gibt ein Modell zurück, das bei jedem Aufruf Name, Beschreibung und JSON Schema jedes Tools mitschickt. Die Funktion selbst verlässt deinen Code nie. Das Modell weiß nur, was diese drei ihm sagen, also sind Beschreibungen Prompts: Schreib sie für das Modell und beschreib jedes Feld mit .describe().
Ein Tool-Call und seine Antwort
Will das Modell ein Tool, ist seine Antwort eine AIMessage mit tool_calls: Jeder Call hat name, args und eine id. Dein Code führt das Tool aus und antwortet mit einer ToolMessage, die dieselbe tool_call_id trägt. Ein Modell kann mehrere Calls auf einmal anfordern, daher ordnet die id jedes Ergebnis seinem Call zu.
Gib den ganzen Tool-Call an tool.invoke(). Das Tool validiert die args gegen sein Schema, führt deine Funktion aus und gibt dir die ToolMessage zurück. Passen die args nicht, wirft es ToolInputParsingException, und deine Funktion läuft nie. Ein Agent-Loop fängt den Fehler ab und schickt ihn als ToolMessage mit status "error" zurück, damit das Modell seinen Call korrigieren kann. In Kapitel 6 erledigt ToolNode das für dich.
Schritt 2 von 4: Probier es aus: Von zod zum Tool-Call
Von zod zum Tool-Call
Füg dem Schema eines Tools ein Feld hinzu und sieh, was das Modell liest. Führ dann den Call des Modells durch die echte Validierung, einmal mit gültigen Argumenten und einmal mit Argumenten, die du wählst.
Modus:EchtSimuliertEcht: zod, LangChains tool(), die Umwandlung in JSON Schema und die Validierung laufen auf dieser Seite. Simuliert: Das Modell ist geskriptet und liest das Schema nicht. Seine Tool-Calls stehen vorher fest, und im letzten Schritt wählst du ihre Argumente. Die Bestelldaten sind fiktiv.
Schritt 3 von 4: Check
Check
Als Nächstes: Frage 2 von 3
Schritt 4 von 4: Was du jetzt kannst
Was du jetzt kannst
- Ein Tool mit tool() und einem zod-Schema definieren, mit hilfreichen Beschreibungen.
- Tools an ein Modell binden und seine tool_calls lesen.
- Einen Tool-Call mit einer ToolMessage beantworten und ungültige Argumente behandeln.