Crea un ciclo de agente persistente en TypeScript

• ciclos de herramientas con varios pasos
• herramientas locales del entorno de ejecución
• ejecuciones reanudables
• un único punto de entrada de Gateway para el trabajo del agente

​

1. Instala los SDK

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. Define una herramienta pequeña del entorno de ejecución

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. Crea el 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. Usa el adaptador conectado a 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. Qué se conserva entre pasos

• el ID de ejecución
• el historial de mensajes
• las llamadas a herramientas devueltas
• los resultados de herramientas locales
• la salida final cuando termina la ejecución

​

6. Cuándo conviene mantener simple la primera versión

• un agente por flujo de trabajo
• serialización a cargo de la aplicación antes de reanudar entre solicitudes
• una lista reducida de herramientas antes de crear registros genéricos
• una línea de registro por ejecución con su ID y el ID de solicitud de Gateway

​

7. Cuándo ampliar este enfoque

• pausas para aprobación
• persistencia del estado devuelto a cargo de la aplicación
• varias definiciones de agente con herramientas compartidas del entorno de ejecución

​

Guías relacionadas

• Agent SDK de TypeScript
• Presets
• Enrutamiento y alternativas
• Configura agentes de programación con SKILL.md
• Despliega en el enrutador gratuito