Zum Hauptinhalt springen
Baue einen TypeScript-Triage-Agenten, dessen Modell, Prompt und Anbieterregeln aus einem Preset im Dashboard stammen, sodass der Code nur den Workflow behandelt. Am Ende gibt er eine streng strukturierte JSON-Triage-Entscheidung zurück, hält Fälle an, die eine Person brauchen, wiederholt Modellaufrufe eine begrenzte Anzahl von Malen und protokolliert Gateway-Fehler mit den IDs, die du brauchst, um sie zu finden. Das Skript ist produktionsreif, sobald das Preset existiert und du angehaltene Läufe speicherst, wie in der robusten Agent-Schleife. Eine fertig verpackte Version liegt in packages/sdk/agent-sdk-ts/examples/support-triage-agent.ts.

Agenten bauen

1

Preset anlegen

Lege unter Einstellungen → Voreinstellungen das Preset support-triage mit dem gerouteten Modell, den Anbieterpräferenzen, dem Support-Systemprompt und stabilen Decoding-Parametern an. Das Modell muss JSON-Schema-Ausgabe unterstützen. Presets erklärt, wie ein Preset mit jeder Anfrage zusammengeführt wird.
2

Installieren

3

Agenten schreiben

triage-agent.ts
4

Ausführen

Um einen angehaltenen Fall abzuschließen, setze ihn mit der Entscheidung der prüfenden Person fort:

Prüfen, ob es funktioniert hat

Führe ein Routineticket und ein riskantes Ticket aus und prüfe dann:
  • Unter Einstellungen → Nutzung → Protokolle zeigt das Modell der Anfrage, dass das Preset verwendet wurde.
  • Der riskante Fall endet bei waiting_for_human, mit der Entscheidung in pause.payload.
  • Ein wiederholter Modellaufruf wird im Schritt als modelAttempts erfasst, und jede Wiederholung protokolliert model.retrying.
  • Eine blockierte Anfrage wird mit ihrer requestId und ihrem reason protokolliert, und dieselbe Anfrage in den Protokollen zeigt den Grund.

Gateway-Fehler sichtbar halten

Verschlucke keine Fehler in Agent-Callbacks. Fange AgentGatewayError am Rand ab, protokolliere seine IDs und wirf ihn erneut. Sobald ein Lauf fehlschlägt, behält sein gespeicherter Zustand dieselben Details in run.errorDetails und steps[n].errorDetails, sodass ein späterer Wiederherstellungsjob sie lesen kann, nachdem die Ausnahme verschwunden ist. Diese Fehler stammen aus Gateway-Richtlinien, nicht vom Agenten, deshalb ist die Anfrage in den Protokollen der richtige Ort zum Nachsehen:
Zuletzt geändert am 5. November 2026