Pular para o conteúdo principal
Execute um agente que usa ferramentas com o Agent SDK de TypeScript e salve o estado dele após cada etapa, para que um processo que travou ou reiniciou continue de onde parou. Ao final, você terá um único script que responde a uma pergunta sobre a documentação com uma ferramenta de consulta, grava cada execução em .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

Para testar a retomada, pare o script com 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 checkpoint uma vez por etapa e depois o ID da execução, completed e uma resposta com uma URL phaseo.app/docs.
  • .agent-runs/<run id>.json guarda 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 é o AgentRunResult 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.

Faça-o crescer com cuidado

Mantenha um agente por fluxo de trabalho, uma lista curta de ferramentas e uma linha de log por execução com o ID da execução e os IDs de solicitação. Quando precisar de pausas para aprovação ou de vários agentes compartilhando ferramentas, mantenha este par de cliente do gateway e estado e construa em torno dele: o agente de revisão de código adiciona uma pausa para aprovação, e Ferramentas em paralelo executa ferramentas lado a lado. Para padrões de solicitação compartilhados, chame uma predefinição em vez de um modelo fixo.
Última modificação em 5 de novembro de 2026