Zum Hauptinhalt springen
Führe mit dem TypeScript Agent SDK einen Agenten mit Tools aus und speichere seinen Zustand nach jedem Schritt, damit ein abgestürzter oder neu gestarteter Prozess dort weitermacht, wo er aufgehört hat. Am Ende hast du ein Skript, das eine Frage zur Dokumentation mit einem Nachschlage-Tool beantwortet, jeden Lauf in .agent-runs/<run id>.json schreibt und einen Lauf fortsetzt, wenn du seine ID übergibst. Das Skript dient der Veranschaulichung: Der Dateispeicher eignet sich für einen einzelnen Rechner. Behalte in der Produktion dasselbe load/save-Paar bei, aber hinterlege es mit deiner Datenbank. Phaseo speichert Agent-SDK-Läufe nicht für dich.

Agenten bauen

1

Installieren

@phaseo/agent-sdk installiert @phaseo/sdk mit. Setze deinen Schlüssel:
2

Agenten schreiben

agent.ts
3

Ausführen

Um das Fortsetzen zu testen, stoppe das Skript nach der ersten checkpoint-Zeile mit Ctrl+C und übergib dann die ausgegebene Lauf-ID (eine UUID):

Prüfen, ob es funktioniert hat

  • Das Skript gibt pro Schritt einmal checkpoint aus, danach die Lauf-ID, completed und eine Antwort mit einer phaseo.app/docs-URL.
  • .agent-runs/<run id>.json enthält Lauf-ID, Status, Nachrichtenverlauf, die Tool-Aufrufe und Ergebnisse jedes Schritts sowie die endgültige Ausgabe.
  • Nach einem unterbrochenen Lauf schließt der Fortsetzungsbefehl dieselbe Lauf-ID ab, statt einen neuen Lauf zu starten.
  • Jeder Modellzug erscheint unter Einstellungen → Nutzung → Protokolle. Protokolliere die Lauf-ID neben jeder Anfrage-ID, damit du sie zuordnen kannst.

Was der gespeicherte Zustand enthält

Jedes gespeicherte Ergebnis ist das vollständige AgentRunResult: run (ID, Status, Nachrichten, Nutzung, eine eventuelle Pause), steps mit ihren Gateway-Anfrage-IDs und Tool-Aufrufen sowie output, sobald der Lauf abgeschlossen ist. continueRun() akzeptiert es direkt, oder eine runId zusammen mit state, und ruft dann selbst load() auf. Ein Tool-Aufruf, der lief, als der Prozess stoppte, kann seine Wirkung bereits gehabt haben, halte Tools also idempotent. Das SDK repariert den Verlauf eines Aufrufs, der nie ein Ergebnis bekommen hat, bevor es fortfährt. Status und Freigabe behandelt Pausen und Freigaben.

Behutsam erweitern

Behalte einen Agenten pro Workflow, eine kurze Tool-Liste und eine Protokollzeile pro Lauf mit Lauf-ID und Anfrage-IDs. Wenn du Freigabepausen oder mehrere Agenten mit gemeinsamen Tools brauchst, behalte dieses Paar aus Gateway-Client und Zustand bei und baue darum herum: Der Code-Review-Agent ergänzt eine Freigabepause, und Parallele Tools führt Tools nebeneinander aus. Für gemeinsame Anfrage-Standards rufe ein Preset statt eines festen Modells auf.
Zuletzt geändert am 5. November 2026