A fecha del 11 de marzo de 2025, hemos publicado los componentes básicos de nuestra nueva plataforma de agentes. Para obtener más información, consulta nuestra documentación de la API para nuestra API de Responses, herramientas como Búsqueda web, Búsqueda de archivos y Uso del ordenador, y nuestro SDK de Agents con seguimiento. Basándonos en tus comentarios sobre la beta de la API de Assistants, hemos incorporado mejoras clave en la API de Responses. Después de lograr la paridad completa de funciones, anunciaremos un plan de obsolescencia de la API de Assistants más adelante este año, con una fecha objetivo de retirada 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 en sus aplicaciones. Esta API elimina la necesidad de gestionar el historial de conversaciones y añade acceso a herramientas alojadas en OpenAI, como el Intérprete de código y la búsqueda de archivos. La API también ofrece una función mejorada de llamada a funciones 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 fase beta. Actualmente, solo admitimos la versión 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 API de Assistants 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 en su lugar la API de Responses. Si ya usas la API de Assistants, planifica tu migración a la API de Responses. Puedes seguir accediendo 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 concreto 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 truncarlo cuando la conversación supera la longitud de contexto del modelo.
¿Qué es la herramienta de búsqueda de archivos?
La herramienta file_search aplica de serie varias prácticas recomendadas de recuperación para ayudarte a extraer los datos adecuados de tus archivos y enriquecer las respuestas del modelo.
De forma predeterminada, la herramienta file_search utiliza los siguientes ajustes:
Tamaño de los fragmentos: 800 tokens
Solapamiento entre fragmentos: 400 tokens
Modelo de embeddings: text-embedding-3-large con 256 dimensiones
Número máximo de fragmentos añadidos al contexto: 20
¿Qué restricciones hay 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.
¿Qué limitaciones tiene la herramienta de búsqueda de archivos?
Hay algunas limitaciones conocidas que estamos trabajando para resolver en los próximos meses:
Actualmente no se pueden modificar los ajustes de fragmentación, embeddings o recuperación.
No se admite el análisis de imágenes dentro de documentos.
No se admite la recuperación de datos en formatos de archivo estructurados (como archivos .csv o .jsonl). Consulta los tipos de archivo compatibles.
¿Cuáles son los límites de solicitudes de la API de Asistentes?
Los límites de solicitudes de la API de Asistentes no dependen del nivel de uso ni del modelo. En su lugar, hay límites predeterminados según el tipo de solicitud, con un par de excepciones:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 solicitudes por minuto
¿Qué precio tiene el Intérprete de código en la API?
El Intérprete de código cuesta 0,03 USD por sesión. Si tu asistente llama al Intérprete de código simultáneamente en dos hilos distintos, se crearán dos sesiones del Intérprete de código (2 × 0,03 USD). Cada sesión permanece activa durante una hora de forma predeterminada, por lo 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.
¿Qué precio tiene la búsqueda de archivos en la API?
La búsqueda de archivos cuesta 0,10 USD al día por GB de almacenamiento en el almacén de vectores (el primer GB de almacenamiento es gratuito). El tamaño del almacén de vectores se calcula una vez que se ha analizado y fragmentado tu archivo y se han generado sus embeddings.
Los almacenes de vectores creados antes del 17 de abril de 2024 serán gratuitos hasta finales de 2024. A partir de entonces:
Se facturarán según las tarifas vigentes (actualmente, 0,10 USD/GB/día) si se han utilizado al menos una vez en una ejecución creada después del 17 de abril de 2024.
Se eliminarán si no se han utilizado en ninguna ejecución entre el 17 de abril 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 utilizado.
¿Hay algún límite en la cantidad de asistentes que puedo crear?
No hay ningún límite en la cantidad de asistentes que puede crear una organización.
¿Está disponible el streaming en la API?
Sí, el streaming está disponible en la API de Asistentes.
¿Está disponible el modo JSON 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 llamada 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 tratan los datos que envío a OpenAI?
Como ocurre 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 subidos a la API de Asistentes se almacenan indefinidamente hasta que un usuario los elimina manualmente.
¿Está DALL-E disponible a través de la API de Asistentes?
Por el momento, DALL-E no está disponible.
¿Hay una interfaz de usuario para la API de Assistants?
Puedes consultar el Playground de la API de Assistants. Asegúrate de estar en la vista Assistants de la barra lateral izquierda y de usar un modelo compatible con las herramientas que quieras 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 ha encontrado un error al procesar tu solicitud. ¡Lo sentimos! Puedes volver a enviar tu 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, puede que tu prompt no esté configurado correctamente. Si sigues intentando enviar la solicitud y falla, puedes probar lo siguiente:
reestructura tu prompt para que los comandos que se asemejen a funciones se traten como tales
añade cada comando de tu prompt como una función a tools
¿Por qué no funciona bien mi herramienta de búsqueda de archivos?
Al utilizar la herramienta de búsqueda de archivos, te recomendamos establecer max_prompt_tokens en al menos 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 máxima calidad.
¿Cómo puedo enviar comentarios?
Nos encantaría conocer tu opinión en nuestro foro de desarrolladores, a través del Centro de ayuda en help.openai.com o en Twitter @OpenAIDevs.