Skip to main content
Verwende dieses Rezept, wenn ein Agenten-Workflow Folgendes soll:
  • über das TypeScript Agent SDK ausgeführt werden
  • verwaltete Websuche nutzen
  • streng strukturiertes JSON zurückgeben
  • fast gültiges, fehlerhaftes JSON deterministisch wiederherstellen

1. Die SDKs installieren

2. Einen eng gefassten Ausgabevertrag definieren

Halte das erste Rechercheergebnis so klein, dass Betreiber es in den Protokollen leicht prüfen können.

3. Den Agenten erstellen

Verwende parseOutput, damit die Laufzeit typisierte Daten statt Rohtext zurückgibt.

4. Den Gateway-Adapter einmalig konfigurieren

Darauf kommt es an:
  • responseFormat legt das Ausgabeschema ausdrücklich fest
  • plugins aktiviert die Reparatur fast gültiger JSON-Antworten
  • gatewayTools stellt dem Modell die verwaltete Websuche bereit
  • toolChoice erzwingt das Such-Tool, wenn sich der Workflow immer auf Quellen stützen soll

5. Den Workflow ausführen

6. In den Protokollen prüfen

Prüfe nach einem erfolgreichen Lauf die Anfragedetails und bestätige:
  • dass angeforderte native Websuch-Tools oder verwaltete Suchaktivität angezeigt werden
  • dass Suchergebnisse und Zitate gespeichert wurden
  • dass die Plugin-Ausführung response-healing nur bei tatsächlich nötiger Wiederherstellung zeigt
  • dass die endgültige Ausgabe dem angeforderten JSON-Schema entspricht

7. Wann sich dieses Muster eignet

Verwende dieses Rezept, wenn:
  • der Workflow hauptsächlich eine einmalige Recherche und keine umfangreiche lokale Tool-Schleife ist
  • das Modell vor der Antwort Quellen heranziehen soll
  • nachgelagerte Aufrufer typisiertes JSON statt Prosa benötigen
Verwende dieses Muster nicht, wenn:
  • der Workflow die genauen URLs bereits kennt und phaseo:web_fetch genügt
  • der Agent mehr leistungsfähige lokale Tools als Anbieter-Tools benötigt
  • der Ausgabevertrag so offen ist, dass striktes JSON mehr Aufwand als Nutzen verursacht

Verwandte Anleitungen

Zuletzt geändert am 2. Oktober 2026