Saltar al contenido principal
Ejecuta un agente que usa herramientas con el Agent SDK de TypeScript y guarda su estado después de cada paso, para que un proceso que falla o se reinicia continúe donde se detuvo. Al terminar tendrás un script que responde a una pregunta sobre la documentación con una herramienta de búsqueda, escribe cada ejecución en .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

Para probar una reanudación, detén el script con 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 checkpoint una vez por paso y después el ID de ejecución, completed y una respuesta con una URL de phaseo.app/docs.
  • .agent-runs/<run id>.json contiene 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 el AgentRunResult 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.

Hazlo crecer con cuidado

Mantén un agente por flujo de trabajo, una lista corta de herramientas y una línea de registro por ejecución con el ID de ejecución y los ID de solicitud. Cuando necesites pausas de aprobación o varios agentes que compartan herramientas, conserva este par de cliente del gateway y estado y construye a su alrededor: Agente de revisión de código añade una pausa de aprobación, y Herramientas en paralelo ejecuta herramientas a la vez. Para valores predeterminados de solicitud compartidos, llama a un preset en lugar de a un modelo fijo.
Última modificación el 5 de noviembre de 2026