KI-Agenten
Regeln
- Definieren Sie Werkzeuge als getypte Funktionen mit Beschreibungen – das Modell wählt aus, welches Werkzeug aufgerufen werden soll
- Werkzeugschema:
{ name, description, parameters: zodSchema, execute: async (args) => result }
- Mehrschrittige Schleife: Nachrichten senden → Modell gibt Werkzeugaufruf zurück → Werkzeug ausführen → Ergebnis zurückführen → wiederholen, bis fertig
maxSteps-Grenze, um Endlosschleifen zu verhindern – Standard 5-10 Schritte, je nach Komplexität- Strukturierte Ausgaben mit Zod:
generateObject({ schema: z.object({...}) }) für garantierte Form
- Wiederholungslogik: Werkzeugausführung in try/catch einbetten, vorübergehende Fehler 2-3 Mal mit exponentiellem Backoff wiederholen
- Agentenorchestrierung: Zerlegen Sie komplexe Aufgaben in Unter-Agenten mit fokussierten Werkzeugsätzen, Koordinator-Agent delegiert
- Validieren Sie Werkzeugergebnisse immer, bevor Sie sie an das Modell zurückgeben – bereinigen Sie nicht vertrauenswürdige Daten
- Verwenden Sie
streamText mit onToolCall für Echtzeit-Einblick in die Argumentation des Agenten
Muster
const tools = {
searchDatabase: tool({
description: "Durchsuchen Sie die Produktdatenbank",
parameters: z.object({ query: z.string(), limit: z.number().default(10) }),
execute: async ({ query, limit }) => db.products.search(query, limit),
}),
};
const result = await generateText({
model,
tools,
maxSteps: 10,
messages,
});
Vermeiden
- Agenten uneingeschränkten Werkzeugzugriff geben – schränken Sie Werkzeuge auf die Aufgabe ein
- Fehlende
maxSteps – Agenten können sich in Endlosschleifen befinden
- Werkzeugausgaben ohne Validierung vertrauen – überprüfen Sie immer, bevor Sie auf Ergebnisse reagieren
- Monolithische Agenten – bevorzugen Sie fokussierte Unter-Agenten gegenüber einem Agenten mit 20+ Werkzeugen