.agent-runs/<run id>.json y reanuda una ejecución cuando le pasas su ID.
El script es ilustrativo: el almacén en archivos sirve para una sola máquina. En producción, conserva el mismo par load/save, pero respáldalo con tu base de datos. Phaseo no guarda por ti las ejecuciones del Agent SDK.
Créalo
1
Instala
@phaseo/agent-sdk instala @phaseo/sdk junto con él. Configura tu clave:2
Escribe el agente
agent.ts
3
Ejecútalo
Ctrl+C después de la primera línea checkpoint y pasa el ID de ejecución que imprimió (un UUID):Comprueba que funciona
- El script imprime
checkpointuna vez por paso y después el ID de ejecución,completedy una respuesta con una URL dephaseo.app/docs. .agent-runs/<run id>.jsoncontiene el ID de ejecución, el estado, el historial de mensajes, las llamadas a herramientas y los resultados de cada paso, y la salida final.- Tras una ejecución interrumpida, el comando de reanudación termina el mismo ID de ejecución en lugar de empezar uno nuevo.
- Cada turno del modelo aparece en Ajustes → Uso → Registros. Registra el ID de ejecución junto a cada ID de solicitud para poder relacionarlos.
Qué contiene el estado guardado
Cada resultado guardado es elAgentRunResult completo: run (ID, estado, mensajes, uso y cualquier pausa), steps con sus ID de solicitud del gateway y sus llamadas a herramientas, y output cuando la ejecución termina. continueRun() lo acepta directamente, o bien un runId junto con state, y en ese caso llama a load() por sí mismo.
Una llamada a herramienta que estaba en curso cuando el proceso se detuvo puede haber tenido ya su efecto, así que mantén las herramientas idempotentes. Antes de continuar, el SDK repara el historial de una llamada que nunca obtuvo resultado. Estado y aprobación explica las pausas y las aprobaciones.