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.
Què és l’API d’Assistants?
L’API d’Assistants permet als desenvolupadors crear fàcilment assistents d’AI potents dins de les seves aplicacions. Aquesta API elimina la necessitat de gestionar l’historial de converses i afegeix accés a eines allotjades per OpenAI, com ara l’Intèrpret de codi i File Search. L’API també admet una crida a funcions millorada per a eines de tercers.
Encara puc fer servir Assistants API v1 beta?
No. Des del 18 de desembre de 2024, els usuaris ja no tenen accés a la versió v1 de l’API d’Assistant beta. Actualment només admetem v2. Consulta aquesta guia de migració per convertir les teves crides a l’API de v1 a 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 representa una AI creada per a un propòsit concret 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 emmagatzemant l’historial de missatges i truncant-lo quan la conversa es fa massa llarga per a la longitud de context del model.
Què és l’eina File Search?
L’eina `file_search` implementa diverses pràctiques recomanades de recuperació de sèrie per ajudar-te a extreure les dades adequades dels teus fitxers i ampliar les respostes del model. Per obtenir més informació, llegeix la nostra documentació per a desenvolupadors.
Per defecte, l’eina file_search utilitza la configuració següent:
Mida del fragment: 800 segments
Solapament de fragments: 400 segments
Model d’incrustació: `text-embedding-3-large` a 256 dimensions
Nombre màxim de fragments afegits al context: 20
Quines són les restriccions per a la càrrega de fitxers?
Les restriccions per carregar un fitxer són:
512 MB per fitxer
5 M de segments per fitxer
10.000 fitxers per magatzem vectorial
1 magatzem vectorial per assistent
1 magatzem vectorial per fil
El límit d’emmagatzematge total per a cada projecte d’una organització és de 100 GB.
Quines són les limitacions de l’eina File Search?
Tenim algunes limitacions conegudes per a les quals estem treballant per afegir compatibilitat en els propers mesos:
Actualment no hi ha cap manera de modificar la configuració de fragmentació, incrustació o recuperació.
No admetem l’anàlisi d’imatges dins dels documents.
No admetem recuperacions sobre formats de fitxer estructurats (com ara fitxers .csv o .jsonl). Consulta els tipus de fitxer admesos.
Quins són els límits de peticions de l’API d’Assistants?
Els límits de peticions de l’API d’Assistants no estan vinculats al nivell d’ús ni al model. En canvi, hi ha límits predeterminats per tipus de sol·licitud, amb un parell d’excepcions:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 sol·licituds per minut
Quin és el preu de 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, això crearia dues sessions de l’Intèrpret de codi (2 * 0,03 $). Cada sessió està activa per defecte durant una hora, cosa que significa que només pagaríeu aquesta tarifa una vegada si l’usuari continua donant instruccions a l’Intèrpret de codi en el mateix fil durant fins a una hora.
Quin és el preu de File Search a l’API?
File Search té un preu de 0,10 $/GB d’emmagatzematge de magatzem vectorial per dia (el primer GB d’emmagatzematge és gratuït). La mida del magatzem vectorial es basa en la mida resultant del magatzem vectorial un cop el fitxer s’ha analitzat, fragmentat i incrustat.
Qualsevol magatzem vectorial creat abans del 17 d’abril de 2024 serà gratuït fins a finals de 2024; després, podrà ser:
Facturat a les tarifes actuals (actualment 0,10 $/GB/dia) si s’ha utilitzat almenys una vegada en un Run creat després del 17 d’abril de 2024.
Suprimit si no s’ha utilitzat en cap Run entre el 17 d’abril de 2024 i el 31 de desembre de 2024; això és per evitar que se’t facturin magatzems vectorials que potser vas crear abans que s’anunciés aquest canvi de preus però que no vas utilitzar mai.
Hi ha un límit de quants assistents puc crear?
No hi ha cap límit de quants assistents pot crear una organització.
La transmissió en temps real està disponible a l’API?
Sí, la transmissió en temps real està disponible a l’API d’Assistants.
El mode JSON està disponible a l’API d’Assistants?
Sí, el mode JSON està disponible a l’API d’Assistants mitjançant el paràmetre response_format als objectes Assistants o Run.
L’API d’Assistants també gestionarà sol·licituds per a crides a funcions de tercers?
No. Tot i que la crida a funcions permet al model seleccionar eines i formatar-hi sol·licituds, l’execució de crides a eines de tercers no la gestiona OpenAI.
Com es gestionen les dades que envio a OpenAI?
Com amb la resta de la nostra plataforma, les dades i els fitxers que es passen a l’API d’OpenAI no s’utilitzen mai per entrenar els nostres models i pots suprimir les teves dades sempre que ho necessitis. Les dades pujades a l’API d’Assistants s’emmagatzemen indefinidament fins que un usuari les suprimeix manualment.
DALL-E està disponible mitjançant l’API d’Assistants?
En aquest moment, 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 per a les instruccions de l’assistent a l’API d’Assistants?
El camp d’instruccions de l’assistent té una longitud màxima de 256.000 caràcters.
Rebo un error com ara «El servidor ha tingut un error en processar la teva sol·licitud. Ho sentim! Pots tornar a provar 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 voler dir que la teva indicació no està configurada correctament. Si continues reintentant la sol·licitud i falla, aquí tens algunes coses que pots provar:
assegura’t de reestructurar la indicació per tractar qualsevol ordre semblant a una funció com a funció
afegeix qualsevol ordre de la indicació com a funció a
tools
Per què la meva eina File Search no funciona bé?
Quan utilitzis l’eina File Search, recomanem establir max_prompt_tokens en com a mínim 20.000. Per a converses més llargues o diverses interaccions amb File Search, considera augmentar aquest límit a 50.000 o, idealment, eliminar completament els límits de max_prompt_tokens per obtenir resultats de la màxima qualitat. Llegeix-ne més aquí.
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 @OpenAIDevs.