Mill-11 ta’ Marzu 2025, ħriġna l-elementi bażiċi tal-pjattaforma l-ġdida tagħna tal-Agents. Għad-dettalji, ara d-dokumentazzjoni tal-API tagħna għall-Responses API, għodod inklużi Web Search, File Search, u Computer Use, u l-Agents SDK tagħna bi Tracing. Abbażi tal-feedback tiegħek għall-Assistants API beta, inkorporajna titjib ewlieni fir-Responses API. Wara li niksbu parità sħiħa tal-karatteristiċi, inħabbru pjan ta’ deprezzament tal-Assistants API aktar tard din is-sena, b’data mmirata ta’ sunset fl-ewwel nofs tal-2026.
Mistoqsijiet frekwenti
X’inhi l-Assistants API?
L-Assistants API tippermetti lill-iżviluppaturi joħolqu faċilment assistenti tal-AI b’kapaċitajiet qawwija fl-apps tagħhom. Din l-API tneħħi l-ħtieġa li timmaniġġja l-istorja tal-konversazzjoni u tagħti aċċess għal għodod ospitati minn OpenAI bħal Code Interpreter u File Search. L-API tappoġġja wkoll sejħa għall-funzjoni mtejba għal għodod ta’ partijiet terzi.
Għadni nista’ nuża l-Assistants API v1 beta?
Le. Mit-18 ta’ Diċembru 2024, l-utenti ma għadx għandhom aċċess għall-verżjoni v1 beta tal-Assistant API. Bħalissa nappoġġjaw biss v2. Ara din il-gwida għall-migrazzjoni biex taqleb is-sejħiet tal-API tiegħek minn v1 għal v2.
Kif naċċessaha?
L-Assistants API hija disponibbli għal kull min għandu kont OpenAI API, iżda hija deprezzata u se titneħħa f’Awwissu 2026. Għal proġetti ġodda, uża r-Responses API minflok. Jekk diġà tuża l-Assistants API, ippjana l-migrazzjoni tiegħek għar-Responses API. Xorta tista’ taċċessa assistenti eżistenti fl-Assistants Playground waqt li l-API tibqa’ disponibbli.
X’inhu Assistent?
Assistent jirrappreżenta AI maħluqa għal skop speċifiku li tuża l-mudelli ta’ OpenAI u tista’ taċċessa fajls, iżżomm ktajjen ta’ konversazzjoni persistenti, u ssejjaħ għodod.
X’inhi katina ta’ konversazzjoni?
Katina ta’ konversazzjoni hija sessjoni ta’ konversazzjoni bejn assistent u utent. Il-ktajjen ta’ konversazzjoni jissimplifikaw l-iżvilupp tal-applikazzjonijiet billi jaħżnu l-istorja tal-messaġġi u jqassruha meta l-konversazzjoni ssir twila wisq għall-kuntest li jiflaħ il-mudell.
X’inhi l-għodda File Search?
L-għodda file_search tapplika diversi prattiki tajbin għall-irkupru mingħajr ma jkollok tikkonfiguraha, biex tgħinek tiġbed id-data t-tajba mill-fajls tiegħek u tarrikkixxi t-tweġibiet tal-mudell.
B’mod awtomatiku, l-għodda file_search tuża dawn is-settings:
Daqs tal-biċċa: 800 token
Koinċidenza bejn il-biċċiet: 400 token
Mudell ta’ rappreżentazzjoni vettorjali: text-embedding-3-large b’256 dimensjoni
Numru massimu ta’ biċċiet miżjuda mal-kuntest: 20
X’inhuma r-restrizzjonijiet għat-tlugħ ta’ fajls?
Ir-restrizzjonijiet għat-tlugħ ta’ fajl huma:
512 MB għal kull fajl
5 miljun token għal kull fajl
10,000 fajl għal kull maħżen tal-vetturi
Maħżen tal-vetturi wieħed għal kull assistent
Maħżen tal-vetturi wieħed għal kull katina ta’ konversazzjoni
Il-limitu totali tal-ħażna għal kull proġett f’organizzazzjoni huwa ta’ 100 GB.
X’inhuma l-limitazzjonijiet tal-għodda File Search?
Hemm xi limitazzjonijiet magħrufa li qed naħdmu biex negħlbuhom billi nżidu l-appoġġ meħtieġ fix-xhur li ġejjin:
Bħalissa ma tistax tibdel is-settings tat-tqassim f’biċċiet, tar-rappreżentazzjoni vettorjali jew tal-irkupru.
Ma nappoġġjawx l-analiżi tal-immaġnijiet fid-dokumenti.
Ma nappoġġjawx l-irkupru minn formati ta’ fajls strutturati (bħal fajls .csv jew .jsonl). Ara t-tipi ta’ fajls appoġġjati.
X’inhuma l-limiti tar-rata tat-talbiet għall-Assistants API?
Il-limiti tar-rata tat-talbiet għall-Assistants API mhumiex marbuta mal-livell tal-użu u l-mudell. Minflok, hemm limiti prestabbiliti skont it-tip ta’ talba, bi ftit eċċezzjonijiet:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 talba kull minuta
Kemm jiswa Code Interpreter fl-API?
Code Interpreter jiswa $0.03 għal kull sessjoni. Jekk l-assistent tiegħek isejjaħ lil Code Interpreter simultanjament f’żewġ ktajjen ta’ konversazzjoni differenti, jinħolqu żewġ sessjonijiet ta’ Code Interpreter (2 * $0.03). B’mod awtomatiku, kull sessjoni tibqa’ attiva għal siegħa. Dan ifisser li tħallas din it-tariffa darba biss jekk l-utent tiegħek jibqa’ jagħti struzzjonijiet lil Code Interpreter fl-istess katina ta’ konversazzjoni għal mhux aktar minn siegħa.
Kemm jiswa File Search fl-API?
File Search jiswa $0.10 kuljum għal kull GB ta’ ħażna f’maħżen tal-vetturi (l-ewwel GB ta’ ħażna huwa bla ħlas). Id-daqs tal-maħżen tal-vetturi huwa bbażat fuq id-daqs li jirriżulta wara li l-fajl tiegħek jiġi analizzat, maqsum f’biċċiet u kkonvertit f’rappreżentazzjonijiet vettorjali.
Kull maħżen tal-vetturi li nħoloq qabel is-17 ta’ April 2024 se jibqa’ bla ħlas sa tmiem l-2024. Wara dan:
Jiġi ċċarġjat bir-rati fis-seħħ (bħalissa $0.10/GB/kuljum) jekk ikun intuża mill-inqas darba f’Run maħluq wara s-17 ta’ April 2024.
Jitħassar jekk ma jkun intuża f’ebda Run bejn is-17 ta’ April 2024 u l-31 ta’ Diċembru 2024 — dan biex ma tiġix iċċarġjat għal imħażen tal-vetturi li seta’ ħloqt qabel ma tħabbret din il-bidla fil-prezzijiet iżda li qatt ma użajt.
Hemm limitu għal kemm nista’ noħloq assistenti?
M’hemm l-ebda limitu għal kemm assistenti tista’ toħloq organizzazzjoni.
L-istreaming huwa disponibbli fl-API?
Iva, l-istreaming huwa disponibbli fl-Assistants API.
Il-modalità JSON hija disponibbli fl-Assistants API?
Iva, il-modalità JSON hija disponibbli fl-Assistants API permezz tal-parametru response_format fl-oġġetti Assistants jew Run.
L-Assistants API se timmaniġġja wkoll talbiet għal sejħiet lil funzjonijiet ta’ partijiet terzi?
Le. Għalkemm is-sejħa għall-funzjoni tippermetti lill-mudell jagħżel għodod u jifformattja t-talbiet għalihom, OpenAI ma timmaniġġjax l-eżekuzzjoni ta’ sejħiet lil għodod ta’ partijiet terzi.
Kif tiġi ttrattata d-data li nibgħat lil OpenAI?
Bħal fil-bqija tal-pjattaforma tagħna, id-data u l-fajls mibgħuta lill-API ta’ OpenAI qatt ma jintużaw biex jitħarrġu l-mudelli tagħna u tista’ tħassar id-data tiegħek kull meta jkollok bżonn. Id-data li tittella’ fl-Assistants API tinħażen għal żmien indefinit sakemm utent iħassarha manwalment.
DALL-E huwa disponibbli permezz tal-Assistants API?
Bħalissa, DALL-E mhuwiex disponibbli.
Hemm UI għall-Assistants API?
Tista’ tiċċekkja l-Playground għall-Assistants API. Kun żgur li qiegħed fil-veduta Assistants fuq il-sidebar tax-xellug u li qed tuża mudell kompatibbli mat-Tools li tixtieq tixgħel jew titfi.
X’inhu l-limitu tal-karattri għall-istruzzjonijiet tal-assistent fl-Assistants API?
Il-kamp tal-istruzzjonijiet tal-assistent għandu tul massimu ta’ 256,000 karattru.
Qed nirċievi żball bħal “Is-server iltaqa’ ma’ żball waqt li kien qed jipproċessa t-talba tiegħek. Jiddispjaċina għal dan! Tista’ terġa’ tipprova tibgħat it-talba tiegħek, jew tikkuntattjana permezz taċ-ċentru tal-għajnuna tagħna fuq help.openai.com jekk l-iżball jippersisti. ” X’għandi nagħmel?
Jekk qed tirċievi dan l-iżball, jista’ jfisser li l-prompt tiegħek mhuwiex issettjat sew. Jekk tibqa’ terġa’ tibgħat it-talba u din tfalli, tista’ tipprova dawn il-passi:
ibdel l-istruttura tal-prompt tiegħek sabiex kwalunkwe kmand li jixbah funzjoni jiġi ttrattat bħala funzjoni
żid kull kmand fil-prompt tiegħek bħala funzjoni ma’ tools
Għaliex l-għodda File Search tiegħi mhix qed taħdem sew?
Meta tuża l-għodda File Search, nirrakkomandaw li tissettja max_prompt_tokens għal mhux inqas minn 20,000. Għal konversazzjonijiet itwal jew diversi interazzjonijiet ma’ File Search, ikkunsidra li żżid dan il-limitu għal 50,000 jew, idealment, tneħħi għalkollox il-limiti ta’ max_prompt_tokens biex tikseb riżultati tal-ogħla kwalità.
Kif nista’ nagħti feedback?
Nieħdu gost nisimgħu l-feedback tiegħek fil-Forum tal-Iżviluppaturi tagħna, permezz taċ-Ċentru tal-Għajnuna fuq help.openai.com, jew fuq Twitter @OpenAIDevs.