Estado y aprobación

Usa la continuación cuando un agente deba esperar a una persona, un trabajo externo o una herramienta administrada por la aplicación antes de proseguir. El Agent SDK devuelve el estado completo necesario para continuar más adelante.

Phaseo no guarda las ejecuciones del Agent SDK en un servicio de agentes alojado. Almacena el estado reanudable en tu propia aplicación si debe sobrevivir a una solicitud o al reinicio de un proceso.

Aprobar una llamada a herramienta

Exige aprobación solo para las llamadas que la necesiten:

const deploy = defineTool({
  id: "deploy",
  requireApproval: ({ environment }) => environment === "production",
  async execute(input: { environment: string }) {
    return deployRelease(input.environment);
  },
});

La ejecución se pausa con las llamadas pendientes en run.pause.pendingToolCalls. Reanúdala usando el ID exacto de la llamada para no confundir llamadas simultáneas:

const resumed = await agent.continueRun({
  run: paused,
  client,
  approvals: [{ toolCallId: "call_deploy_42" }],
  rejections: [
    { toolCallId: "call_delete_17", reason: "Not authorized" },
  ],
});

Pausar para revisión humana

Usa humanReview cuando quieras comprobar la respuesta completa del modelo antes de iniciar otro turno:

const agent = createAgent({
  id: "support-agent",
  humanReview: ({ response }) =>
    response.message.content.includes("needs approval")
      ? {
          reason: "approval_required",
          payload: { draft: response.message.content },
        }
      : null,
});

Continúa con una entrada explícita de una persona:

const continued = await agent.continueRun({
  run: pausedResult,
  client,
  humanInput: "Approved. Continue and return the final answer.",
});

Guardar el estado de una ejecución

Guarda el AgentRunResult devuelto directamente o proporciona un acceso state con métodos asíncronos load(runId) y save(result). Así, una ejecución continuada puede usar runId en lugar de pasar el registro serializado por cada capa. El SDK no incluye adaptadores de persistencia ni un backend de estado alojado. La aplicación puede mantener en memoria las ejecuciones de una sola vez y guardar solo las pausadas o incompletas.

Empieza aquí

Desarrollar

Observar

Referencia

Aprobar una llamada a herramienta

Pausar para revisión humana

Guardar el estado de una ejecución

Guías relacionadas

​Aprobar una llamada a herramienta

​Pausar para revisión humana

​Guardar el estado de una ejecución

​Guías relacionadas

Aprobar una llamada a herramienta

Pausar para revisión humana

Guardar el estado de una ejecución

Guías relacionadas