# OpenAI Agents SDK TypeScript SDK para desarrolladores que crean agentes con modelos de lenguaje, herramientas y flujos en TypeScript. Permite crear experiencias de texto, trabajar en espacios aislados y ofrecer interacciones de voz en tiempo real. - Findings24: - Sitio web: - Precios: Free - Categorías: Creador de agentes de IA, Infraestructura para agentes de IA, SDK de IA ## ¿Qué es OpenAI Agents SDK TypeScript? OpenAI Agents SDK TypeScript es un conjunto de herramientas para desarrolladores que permite crear aplicaciones de IA agéntica con un pequeño conjunto de primitivas. Los agentes combinan modelos de lenguaje con instrucciones y herramientas, mientras que TypeScript nativo permite orquestar los flujos sin necesidad de un lenguaje de flujos independiente. El SDK admite tareas de texto, agentes que trabajan en espacios aislados del sistema de archivos e interacciones habladas en tiempo real. Reúne la ejecución, la delegación, la validación y el seguimiento en un solo conjunto de herramientas, incluye compatibilidad con modelos de OpenAI de forma predeterminada y ofrece un adaptador para modelos compatibles del Vercel AI SDK. ## ¿Qué puede hacer OpenAI Agents SDK TypeScript? ### Bucle de agente integrado Gestiona la invocación de herramientas, devuelve sus resultados al modelo de lenguaje y continúa la ejecución hasta completar la tarea. Las funciones de TypeScript pueden convertirse en herramientas con generación automática de esquemas y validación basada en esquemas. ### Espacios de trabajo aislados Ofrece sistemas de archivos aislados, comandos de shell, edición de archivos, instantáneas y estado de sesión del entorno aislado para tareas que requieren un entorno de trabajo persistente. ### Agentes de voz en tiempo real Admite interacciones habladas de baja latencia con detección automática de interrupciones y gestión del contexto. En navegadores, RealtimeSession puede conectar la entrada del micrófono y la salida de audio mediante WebRTC. ### Delegación y conexiones de herramientas Coordina agentes especializados mediante agentes como herramientas y transferencias de control. La integración MCP integrada expone herramientas del servidor junto con herramientas de funciones locales. ### Validación e intervención humana Ejecuta las barreras de seguridad de entrada en paralelo con la ejecución del agente y se detiene rápidamente si no se superan las comprobaciones. Los mecanismos con intervención humana permiten que las personas participen durante las ejecuciones de agentes. ### Seguimiento y memoria de sesión El seguimiento integrado permite visualizar, depurar y supervisar los flujos de trabajo de agentes. Las sesiones mantienen el contexto de trabajo dentro de un bucle de agente, mientras que el seguimiento es compatible con las herramientas de evaluación, ajuste fino y destilación de OpenAI. ## Casos de uso ### Inspección y edición de repositorios Proporciona a un asistente de espacio de trabajo un repositorio Git para inspeccionarlo, resumirlo o modificarlo mediante archivos del entorno aislado y comandos de shell. Las instantáneas y el estado de sesión permiten realizar tareas de mayor duración. ### Asistentes de voz en aplicaciones de navegador Crea un asistente que recibe la entrada del micrófono y responde con audio mientras utiliza herramientas y conserva el historial de conversación. La gestión de interrupciones facilita los intercambios hablados. ### Flujos de trabajo con agentes especializados Dirige partes de una tarea más amplia a agentes con distintas instrucciones y herramientas, y coordina sus contribuciones mediante transferencias de control o llamadas a agentes como herramientas. ## Preguntas frecuentes ### ¿Cómo instalo el SDK? Ejecuta \`npm install @openai/agents zod\`. El SDK requiere Zod v4. Para los ejemplos documentados de texto y entornos aislados de OpenAI, configura la variable de entorno OPENAI\_API\_KEY. ### ¿Con qué paquete debería empezar? Usa @openai/agents para la mayoría de las aplicaciones de texto, entornos aislados y tiempo real. Elige @openai/agents-realtime si solo necesitas el paquete independiente de tiempo real. Los paquetes de nivel inferior admiten configuraciones personalizadas de proveedores e integraciones específicas. ### ¿Puedo usar modelos de otros proveedores? Sí, mediante el adaptador de Vercel AI SDK en @openai/agents-extensions. Admite las versiones v2, v3 y v4 de la especificación de proveedores de AI SDK. El adaptador está en fase beta; la documentación recomienda probar el proveedor elegido y usar el proveedor predeterminado para los modelos de OpenAI. ### ¿Qué limitaciones tiene el adaptador de AI SDK? No admite la carga diferida de herramientas de Responses, la búsqueda de herramientas ni Programmatic Tool Calling. Las entradas PDF pueden usar datos base64 o URL públicas, sujeto a la compatibilidad del proveedor; el adaptador no admite los ID de archivo de OpenAI. ## Datos rápidos - **Tipo de producto**: SDK para aplicaciones de agentes - **Lenguaje principal**: TypeScript - **API de OpenAI predeterminadas**: Responses API y Chat Completions API - **Paquete npm principal**: @openai/agents - **Documentación**: https://openai.github.io/openai-agents-js