Crie um loop de agente persistente em TypeScript

• loops de ferramentas com várias etapas
• ferramentas locais do runtime
• execuções retomáveis
• um único ponto de entrada via Gateway para o trabalho do agente

​

1. Instale os SDKs

npm install @phaseo/sdk @phaseo/agent-sdk

pnpm add @phaseo/sdk @phaseo/agent-sdk

yarn add @phaseo/sdk @phaseo/agent-sdk

bun add @phaseo/sdk @phaseo/agent-sdk

​

2. Defina uma ferramenta pequena do runtime

import { defineTool } from "@phaseo/agent-sdk";

export const lookupDocs = defineTool({
  id: "lookup-docs",
  description: "Look up internal docs by slug.",
  async execute(input: { slug: string }) {
    return {
      slug: input.slug,
      url: `https://phaseo.app/docs/v1/${input.slug}`,
    };
  },
});

​

3. Crie o agente

import { createAgent } from "@phaseo/agent-sdk";
import { lookupDocs } from "./tools";

export const supportDocsAgent = createAgent({
  id: "support-docs-agent",
  model: "phaseo/free",
  instructions: "Use tools when helpful and finish with a concise answer.",
  tools: [lookupDocs],
});

​

4. Use o adaptador conectado ao Gateway

import {
  createGatewayAgentClient,
} from "@phaseo/agent-sdk";
import { supportDocsAgent } from "./agent";

const result = await supportDocsAgent.run({
  input: "Find the docs page for presets and explain when to use them.",
  client: createGatewayAgentClient({
    clientOptions: {
      apiKey: process.env.PHASEO_API_KEY!,
    },
  }),
});

console.log(result.output);

​

5. O que persiste entre as etapas

• o ID da execução
• o histórico de mensagens
• as chamadas de ferramentas retornadas
• os resultados de ferramentas locais
• a saída final quando a execução termina

​

6. Quando manter a primeira versão simples

• um agente por fluxo de trabalho
• serialização feita pela aplicação antes de qualquer retomada entre solicitações
• uma lista pequena de ferramentas antes de criar registros genéricos
• uma linha de log por execução com o ID da execução e o ID da solicitação do Gateway

​

7. Quando ir além desta receita

• pausas para aprovação
• persistência do estado retornado controlada pela aplicação
• várias definições de agente com ferramentas compartilhadas do runtime

​

Guias relacionados

• Agent SDK de TypeScript
• Presets
• Roteamento e alternativas
• Configure agentes de programação com SKILL.md
• Implante no roteador gratuito