A partir de l’11 de març de 2025, hem publicat els blocs de construcció de la nostra nova plataforma d’agents. Per obtenir-ne detalls, consulta la nostra documentació de l’API per a la nostra API de Responses, les eines com ara Web Search, File Search i Computer Use, i el nostre SDK d’agents amb Tracing. A partir dels vostres comentaris sobre l’API d’Assistants beta, hem incorporat millores clau a l’API de Responses. Un cop aconseguim la paritat completa de funcionalitats, anunciarem un pla d’obsolescència de l’API d’Assistants més endavant aquest any, amb una data objectiu de retirada durant la primera meitat de 2026.
Preguntes freqüents
Què és l'API Assistants?
L'API Assistants permet als desenvolupadors crear fàcilment assistents d'IA potents dins de les seves aplicacions. Aquesta API elimina la necessitat de gestionar l'historial de converses i dona accés a eines allotjades per OpenAI, com ara l'Intèrpret de codi i la Cerca de fitxers. L'API també ofereix una crida a funcions millorada per a eines de tercers.
Encara puc utilitzar la versió beta v1 de l'API d'Assistants?
No. Des del 18 de desembre de 2024, els usuaris ja no tenen accés a la versió v1 de la versió beta de l'API d'Assistants. Actualment, només admetem la v2. Consulteu aquesta guia de migració per convertir les crides a l'API de la v1 a la v2.
Com hi accedeixo?
L’API d’Assistants està disponible per a qualsevol persona amb un compte de l’API d’OpenAI, però està obsoleta i s’eliminarà l’agost de 2026. Per a projectes nous, fes servir l’API de Responses en el seu lloc. Si ja utilitzes l’API d’Assistants, planifica la migració a l’API de Responses. Encara pots accedir als assistents existents al Playground d’Assistants mentre l’API continuï disponible.
Què és un assistent?
Un assistent és una IA creada per a una finalitat concreta que utilitza els models d'OpenAI i pot accedir a fitxers, mantenir fils persistents i cridar eines.
Què és un fil?
Un fil és una sessió de conversa entre un assistent i un usuari. Els fils simplifiquen el desenvolupament d'aplicacions: desen l'historial de missatges i el trunquen quan la conversa supera la longitud de context del model.
Què és l'eina Cerca de fitxers?
L'eina file_search aplica de sèrie diverses bones pràctiques de recuperació d'informació per ajudar-te a extreure les dades adequades dels teus fitxers i enriquir les respostes del model.
Per defecte, l'eina file_search utilitza la configuració següent:
Mida dels fragments: 800 tokens
Solapament entre fragments: 400 tokens
Model de representació vectorial: text-embedding-3-large amb 256 dimensions
Nombre màxim de fragments afegits al context: 20
Quines restriccions hi ha per pujar fitxers?
Les restriccions per pujar un fitxer són:
512 MB per fitxer
5 milions de tokens per fitxer
10.000 fitxers per magatzem de vectors
1 magatzem de vectors per assistent
1 magatzem de vectors per fil
El límit total d'emmagatzematge per a cada projecte d'una organització és de 100 GB.
Quines limitacions té l'eina Cerca de fitxers?
Hi ha algunes limitacions conegudes que treballem per resoldre en els pròxims mesos:
Actualment no es pot modificar la configuració de fragmentació, de representació vectorial ni de recuperació.
No s'admet l'anàlisi d'imatges dins dels documents.
No s'admet la recuperació de dades en formats de fitxer estructurats (com ara fitxers .csv o .jsonl). Consulta els tipus de fitxer admesos.
Quins són els límits de freqüència de l'API Assistants?
Els límits de freqüència de l'API Assistants no depenen del nivell d'ús ni del model. En canvi, hi ha límits predeterminats segons el tipus de sol·licitud, amb un parell d'excepcions:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 sol·licituds per minut
Quin preu té l'Intèrpret de codi a l'API?
L'Intèrpret de codi té un preu de 0,03 $ per sessió. Si el teu assistent crida l'Intèrpret de codi simultàniament en dos fils diferents, es crearan dues sessions de l'Intèrpret de codi (2 * 0,03 $). Cada sessió es manté activa durant una hora per defecte. Per tant, només pagaràs aquesta tarifa una vegada si el teu usuari continua donant instruccions a l'Intèrpret de codi en el mateix fil durant un màxim d'una hora.
Quin preu té la Cerca de fitxers a l'API?
La Cerca de fitxers té un preu de 0,10 $ per GB d'emmagatzematge de vectors al dia (el primer GB és gratuït). La mida del magatzem de vectors es calcula un cop el fitxer s'ha analitzat, fragmentat i convertit en representacions vectorials.
Els magatzems de vectors creats abans del 17 d'abril de 2024 seran gratuïts fins a finals de 2024. A partir d'aleshores:
Es facturaran segons les tarifes vigents (actualment 0,10 $/GB/dia) si s'han utilitzat almenys una vegada en un Run creat després del 17 d'abril de 2024.
S'eliminaran si no s'han utilitzat en cap Run entre el 17 d'abril de 2024 i el 31 de desembre de 2024. Així s'evita que se't cobri per magatzems de vectors que hagis creat abans de l'anunci d'aquest canvi de preus però que no hagis utilitzat mai.
Hi ha un límit de quants assistents puc crear?
No hi ha cap límit de quants assistents pot crear una organització.
L'API permet la transmissió en continu?
Sí, l'API Assistants permet la transmissió en continu.
El mode JSON està disponible a l'API Assistants?
Sí, el mode JSON està disponible a l'API Assistants mitjançant el paràmetre response_format dels objectes Assistants o Run.
L'API Assistants també gestionarà les sol·licituds de crida a funcions de tercers?
No. Tot i que la crida a funcions permet al model seleccionar eines i donar format a les sol·licituds que s'hi envien, OpenAI no gestiona l'execució de les crides a eines de tercers.
Com es tracten les dades que envio a OpenAI?
Com a la resta de la nostra plataforma, les dades i els fitxers enviats a l'API d'OpenAI no s'utilitzen mai per entrenar els nostres models, i pots eliminar les teves dades sempre que ho necessitis. Les dades pujades a l'API Assistants es desen indefinidament fins que un usuari les elimina manualment.
DALL-E està disponible a través de l'API Assistants?
Actualment, DALL-E no està disponible.
Hi ha una interfície d’usuari per a l’API d’Assistants?
Pots consultar el Playground per a l’API d’Assistants. Assegura’t que ets a la vista Assistants a la barra lateral esquerra i que fas servir un model compatible amb les eines que vols activar.
Quin és el límit de caràcters de les instruccions de l'assistent a l'API Assistants?
El camp d'instruccions de l'assistent té una longitud màxima de 256.000 caràcters.
Rebo un error com ara "S'ha produït un error al servidor en processar la teva sol·licitud. Ens sap greu! Pots tornar a enviar la sol·licitud o contactar amb nosaltres a través del nostre centre d'ajuda a help.openai.com si l'error persisteix. " Què he de fer?
Si reps aquest error, pot ser que la teva indicació no estigui ben configurada. Si continues enviant la sol·licitud i falla, pots provar el següent:
reestructura la indicació perquè les ordres que actuïn com a funcions es tractin com a tals
afegeix cada ordre de la indicació com a funció a tools
Per què l'eina Cerca de fitxers no em funciona bé?
Quan utilitzis l'eina Cerca de fitxers, et recomanem establir max_prompt_tokens en un valor de com a mínim 20.000. Per a converses més llargues o múltiples interaccions amb la Cerca de fitxers, considera augmentar aquest límit a 50.000 o, preferiblement, eliminar del tot els límits de max_prompt_tokens per obtenir resultats de la màxima qualitat.
Com puc enviar comentaris?
Ens encantaria rebre els teus comentaris al nostre fòrum de desenvolupadors, a través del Centre d'ajuda a help.openai.com o a Twitter, a @OpenAIDevs.