Desde el 11 de marzo de 2025, lanzamos los componentes básicos de nuestra nueva plataforma Agents. Para obtener detalles, consulta nuestra documentación de la API para nuestra Responses API, herramientas como Búsqueda web, Búsqueda de archivos y Uso de computadora, y nuestro SDK de Agents con rastreo. Según tus comentarios sobre la versión beta de Assistants API, incorporamos mejoras clave en la Responses API. Después de lograr la paridad completa de funciones, anunciaremos un plan de obsolescencia de Assistants API más adelante este año, con una fecha objetivo de desactivación en la primera mitad de 2026.
Preguntas frecuentes
¿Qué es la API de Asistentes?
La API de Asistentes permite a los desarrolladores crear fácilmente potentes asistentes de IA dentro de sus aplicaciones. Esta API elimina la necesidad de gestionar el historial de conversaciones y brinda acceso a herramientas alojadas por OpenAI, como el intérprete de código y la búsqueda de archivos. La API también admite una llamada a funciones mejorada para herramientas de terceros.
¿Puedo seguir usando la versión beta v1 de la API de Assistants?
No. Desde el 18 de diciembre de 2024, los usuarios ya no tienen acceso a la versión v1 de la API de Assistants en beta. Actualmente, solo admitimos v2. Consulta esta guía de migración para convertir tus llamadas a la API de v1 a v2.
¿Cómo accedo a ella?
La Assistants API está disponible para cualquier persona con una cuenta de la API de OpenAI, pero está obsoleta y se eliminará en agosto de 2026. Para proyectos nuevos, usa la Responses API en su lugar. Si ya usas la Assistants API, planifica tu migración a la Responses API. Aún puedes acceder a asistentes existentes en Assistants Playground mientras la API siga disponible.
¿Qué es un asistente?
Un asistente es una IA diseñada para un fin específico que utiliza los modelos de OpenAI y puede acceder a archivos, mantener hilos persistentes y llamar a herramientas.
¿Qué es un hilo?
Un hilo es una sesión de conversación entre un asistente y un usuario. Los hilos simplifican el desarrollo de aplicaciones al almacenar el historial de mensajes y recortarlo cuando la conversación supera la longitud de contexto del modelo.
¿Qué es la herramienta de búsqueda de archivos?
La herramienta file_search incorpora varias prácticas recomendadas de recuperación de información para ayudarte a extraer los datos adecuados de tus archivos y enriquecer las respuestas del modelo.
De forma predeterminada, la herramienta file_search usa la siguiente configuración:
Tamaño del fragmento: 800 tokens
Superposición entre fragmentos: 400 tokens
Modelo de embeddings: text-embedding-3-large con 256 dimensiones
Número máximo de fragmentos agregados al contexto: 20
¿Cuáles son las restricciones para subir archivos?
Las restricciones para subir un archivo son:
512 MB por archivo
5 millones de tokens por archivo
10 000 archivos por almacén de vectores
1 almacén de vectores por asistente
1 almacén de vectores por hilo
El límite total de almacenamiento para cada proyecto de una organización es de 100 GB.
¿Cuáles son las limitaciones de la herramienta de búsqueda de archivos?
Estas son algunas limitaciones conocidas que estamos trabajando para resolver en los próximos meses:
Actualmente no es posible modificar la configuración de fragmentación, embeddings o recuperación.
No se admite el análisis de imágenes dentro de los documentos.
No se admite la recuperación de información de archivos en formatos estructurados (como .csv o .jsonl). Consulta los tipos de archivo compatibles.
¿Cuáles son los límites de tasa de la API de Asistentes?
Los límites de tasa de la API de Asistentes no dependen del nivel de uso ni del modelo. En su lugar, hay límites predeterminados por tipo de solicitud, con un par de excepciones:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 solicitudes por minuto
¿Cuánto cuesta el intérprete de código en la API?
El intérprete de código cuesta $0,03 por sesión. Si tu asistente llama al intérprete de código simultáneamente en dos hilos diferentes, se crearán dos sesiones del intérprete de código (2 * $0,03). De forma predeterminada, cada sesión permanece activa durante una hora. Esto significa que solo pagarás esta tarifa una vez si tu usuario sigue dando instrucciones al intérprete de código en el mismo hilo durante un máximo de una hora.
¿Cuánto cuesta la búsqueda de archivos en la API?
La búsqueda de archivos cuesta $0,10 por GB de almacenamiento en el almacén de vectores por día (el primer GB de almacenamiento es gratis). El tamaño del almacén de vectores se calcula a partir del espacio que ocupa una vez que se analiza y fragmenta tu archivo y se generan sus embeddings.
Los almacenes de vectores creados antes del 17 de abril de 2024 serán gratuitos hasta finales de 2024. Después de esa fecha:
Se cobrarán a las tarifas vigentes (actualmente $0,10/GB/día) si se usaron al menos una vez en una ejecución creada después del 17 de abril de 2024.
Se eliminarán si no se usaron en ninguna ejecución entre el 17 de abril de 2024 y el 31 de diciembre de 2024. Así evitamos cobrarte por almacenes de vectores que hayas creado antes de que se anunciara este cambio de precios, pero que nunca hayas usado.
¿Hay un límite de cuántos asistentes puedo crear?
No hay límite de cuántos asistentes puede crear una organización.
¿La API admite streaming?
Sí, la API de Asistentes admite streaming.
¿El modo JSON está disponible en la API de Asistentes?
Sí, el modo JSON está disponible en la API de Asistentes mediante el parámetro response_format de los objetos Assistants o Run.
¿La API de Asistentes también gestionará las solicitudes de llamadas a funciones de terceros?
No. Aunque la llamada a funciones permite al modelo seleccionar herramientas y dar formato a las solicitudes que les envía, OpenAI no gestiona la ejecución de llamadas a herramientas de terceros.
¿Cómo se manejan los datos que envío a OpenAI?
Al igual que en el resto de nuestra plataforma, los datos y archivos enviados a la API de OpenAI nunca se utilizan para entrenar nuestros modelos y puedes eliminar tus datos cuando lo necesites. Los datos que se suben a la API de Asistentes se almacenan indefinidamente hasta que un usuario los elimina manualmente.
¿DALL-E está disponible a través de la API de Asistentes?
Por el momento, DALL-E no está disponible.
¿Hay una interfaz de usuario para la Assistants API?
Puedes probar el Playground para la Assistants API. Asegúrate de estar en la vista Assistants en la barra lateral izquierda y de usar un modelo compatible con las herramientas que quieres activar.
¿Cuál es el límite de caracteres para las instrucciones del asistente en la API de Asistentes?
El campo de instrucciones del asistente tiene una longitud máxima de 256 000 caracteres.
Recibo un error como “El servidor tuvo un error al procesar tu solicitud. ¡Lo sentimos! Puedes volver a intentar la solicitud o, si el error persiste, ponerte en contacto con nosotros a través de nuestro centro de ayuda en help.openai.com. ” ¿Qué debo hacer?
Si recibes este error, es posible que tu prompt no esté configurado correctamente. Si vuelves a intentar la solicitud y sigue fallando, prueba lo siguiente:
reestructura tu prompt para que los comandos que actúen como funciones se traten como tales
agrega cada comando de tu prompt como una función en tools
¿Por qué mi herramienta de búsqueda de archivos no funciona bien?
Al usar la herramienta de búsqueda de archivos, te recomendamos establecer max_prompt_tokens en un valor no inferior a 20 000. Para conversaciones más largas o múltiples interacciones con la búsqueda de archivos, considera aumentar este límite a 50 000 o, idealmente, eliminar por completo los límites de max_prompt_tokens para obtener resultados de la mejor calidad.
¿Cómo puedo enviar comentarios?
Nos encantaría recibir tus comentarios en nuestro foro de desarrolladores, a través del Centro de ayuda en help.openai.com o en Twitter: @OpenAIDevs.