.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
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
checkpointaus, danach die Lauf-ID,completedund eine Antwort mit einerphaseo.app/docs-URL. .agent-runs/<run id>.jsonenthä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ändigeAgentRunResult: 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.