Zum Inhalt springen
Zurück zu Bau deine ersten Agenten

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.

20 Minuten0 von 3 Zielen erreicht

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

Frage 1 von 3Was erhält das Modell über ein gebundenes Tool?

Als Nächstes: Frage 2 von 3

Frage 2 von 3Was verbindet eine ToolMessage mit dem Call, auf den sie antwortet?
Frage 3 von 3Das Modell schickt order_id als Zahl, aber das Schema sagt z.string(). Was passiert?

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.