Skip to main content
Verwende diese Seite, wenn du den Ablauf des Agent SDK bereits kennst und den genauen öffentlichen Einstiegspunkt oder die passende Option suchst.

Einstiegspunkte

Agent-Methodeen

Stream-Verbraucher

Definitionsoptionen

AgentDefinition umfasst:
  • id
  • model oder models
  • preset
  • instructions
  • tools
  • maxSteps und stopWhen
  • modelRetry und toolExecution
  • temperature, maxOutputTokens und topP
  • parseOutput und outputSchema
  • requireApproval und humanReview
Modell-, Anweisungs- und Sampling-Felder können feste oder dynamische Werte verwenden.

Optionen für Ausführung und Fortsetzung

AgentRunOptions enthält Eingabe, Modellclient, Anwendungskontext, optionale Überschreibungen, Abbruch, Lebenszyklus-Hooks, DevTools und einen von der Anwendung verwalteten Statuszugriff. AgentContinueOptions akzeptiert zusätzlich:
  • einen vorherigen run oder eine runId
  • humanInput
  • Genehmigungen und Ablehnungen anhand der genauen Tool-Aufruf-ID
  • extern erzeugte toolOutputs

Ergebnisdatensätze

AgentRunResult enthält:
  • run: dauerhaften Laufstatus, Kontext, Pausendetails und Abbruchgrund
  • steps: gespeicherte Modell- und Tool-Schrittdatensätze
  • stepResults: normalisierte Schrittergebnisse, falls verfügbar
  • usage: kumulierte Tokens und gemeldete Kosten
  • output: geparste endgültige Ausgabe
  • messages: den vollständigen Gesprächsverlauf der Schleife
  • items: geordnete typisierte Nachrichten, Denkprozesse, Tool-Aktivität, Fehler und endgültige Ausgabe

Fehlertypen

  • AgentGatewayError beschreibt Fehler bei Gateway- oder vorgelagerten Anfragen.
  • AgentSchemaValidationError beschreibt ungültige Tool-, Fortschritts- oder Ausgabedaten.

Weiterführende Anleitungen

Zuletzt geändert am 2. Oktober 2026