.agent-runs/<run id>.json e retoma uma execução quando você passa o ID dela.
O script é ilustrativo: o armazenamento em arquivos serve para uma única máquina. Em produção, mantenha o mesmo par load/save, mas apoiado no seu banco de dados. A Phaseo não armazena as execuções do Agent SDK para você.
Crie o agente
1
Instale
@phaseo/agent-sdk instala o @phaseo/sdk junto. Defina sua chave:2
Escreva o agente
agent.ts
3
Execute
Ctrl+C depois da primeira linha checkpoint e passe o ID da execução que ele imprimiu (um UUID):Verifique se funcionou
- O script imprime
checkpointuma vez por etapa e depois o ID da execução,completede uma resposta com uma URLphaseo.app/docs. .agent-runs/<run id>.jsonguarda o ID da execução, o status, o histórico de mensagens, as chamadas de ferramentas e os resultados de cada etapa e a saída final.- Depois de uma execução interrompida, o comando de retomada conclui o mesmo ID de execução em vez de iniciar uma nova.
- Cada turno do modelo aparece em Configurações → Uso → Registros. Registre o ID da execução ao lado de cada ID de solicitação para poder relacioná-los.
O que o estado salvo contém
Cada resultado salvo é oAgentRunResult completo: run (ID, status, mensagens, uso e qualquer pausa), steps com os IDs de solicitação do gateway e as chamadas de ferramentas, e output quando a execução termina. continueRun() aceita esse resultado diretamente, ou um runId mais state, e nesse caso chama load() por conta própria.
Uma chamada de ferramenta que estava em andamento quando o processo parou pode já ter produzido seu efeito, então mantenha as ferramentas idempotentes. O SDK repara o histórico de uma chamada que nunca recebeu resultado antes de continuar. Estado e aprovação cobre pausas e aprovações.