OpenAI
Din il-paġna ġiet tradotta awtomatikament bl-IA. Ara l-artiklu oriġinali bl-Ingliż.

FAQ tal-Assistants API (v2)

Ara l-karatteristiċi, il-limiti u l-prezzijiet tal-Assistants API v2, kif ukoll il-migrazzjoni lejn ir-Responses API.

Aġġornat: 17 days ago

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.

X’inhi l-Assistants API?

L-Assistants API tippermetti lill-iżviluppaturi jibnu faċilment assistenti AI b’saħħithom fl-apps tagħhom. Din l-API tneħħi l-ħtieġa li timmaniġġja l-istorja tal-konverżazzjonijiet u żżid 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 Assistant?

Assistent jirrappreżenta AI mibnija għal skop speċifiku li tuża l-mudelli ta’ OpenAI u tista’ taċċessa fajls, iżżomm threads persistenti, u ssejjaħ għodod.

X’inhu Thread?

Thread huwa sessjoni ta’ konverżazzjoni bejn assistent u utent. It-threads jissimplifikaw l-iżvilupp tal-applikazzjonijiet billi jaħżnu l-istorja tal-messaġġi u jqassruha meta l-konverżazzjoni ssir twila wisq għat-tul tal-kuntest tal-mudell.

X’inhi l-għodda File Search?

L-għodda file_search tinkludi diversi prattiki rakkomandati għall-irkupru tad-data biex tgħinek tislet id-data t-tajba mill-fajls tiegħek u ttejjeb it-tweġibiet tal-mudell. Għal aktar informazzjoni, aqra d-dokumentazzjoni għall-iżviluppaturi tagħna.

B’mod awtomatiku, l-għodda file_search tuża dawn is-settings:

  • Daqs tal-parti: 800 token

  • Sovrapponiment tal-partijiet: 400 token

  • Mudell tal-embedding: text-embedding-3-large b’256 dimensjoni

  • Għadd massimu ta’ partijiet 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

  • 5M tokens għal kull fajl

  • 10k fajls għal kull vector store

  • vector store wieħed għal kull assistent

  • vector store wieħed għal kull thread

Il-limitu ġenerali tal-ħażna għal kull proġett f’organizzazzjoni huwa 100 GB.

X’inhuma l-limitazzjonijiet tal-għodda File Search?

Għandna ftit limitazzjonijiet magħrufa li qed naħdmu biex inżidu appoġġ għalihom fix-xhur li ġejjin:

  1. Bħalissa m’hemm l-ebda mod kif timmodifika s-settings taċ-chunking, tal-embedding, jew tar-retrieval.

  2. Ma nappoġġjawx il-parsing ta’ stampi fi ħdan dokumenti.

  3. Ma nappoġġjawx retrievals fuq formati ta’ fajls strutturati (bħal fajls .csv jew .jsonl). Ara t-tipi ta’ fajls appoġġjati.

X’inhuma l-limiti tal-veloċità għall-Assistants API?

Il-limiti tal-veloċità għall-Assistants API mhumiex marbuta ma’ livell ta’ użu u mudell. Minflok, hemm limiti awtomatiċi skont it-tip ta’ talba, b’żewġ eċċezzjonijiet:

  • GET: 1000 RPM

  • POST: 300 RPM

  • DELETE: 300 talba kull minuta

Kif jiġi pprezzat Code Interpreter fl-API?

Code Interpreter huwa pprezzat għal $0.03 / sessjoni. Jekk l-assistent tiegħek isejjaħ lil Code Interpreter fl-istess ħin f’żewġ threads differenti, dan joħloq żewġ sessjonijiet ta’ Code Interpreter (2 * $0.03). Kull sessjoni tkun attiva b’mod awtomatiku għal siegħa, li jfisser li tħallas din it-tariffa darba biss jekk l-utent tiegħek jibqa’ jagħti struzzjonijiet lil Code Interpreter fl-istess thread sa siegħa.

Kif jiġi pprezzat File Search fl-API?

File Search huwa pprezzat għal $0.10/GB ta’ ħażna tal-vector store kuljum (l-ewwel GB ta’ ħażna huwa b’xejn). Id-daqs tal-vector store huwa bbażat fuq id-daqs li jirriżulta tal-vector store ladarba l-fajl tiegħek jiġi parsed, chunked, u embedded.

Kwalunkwe vector stores li nħolqu qabel is-17 ta’ April 2024 se jkunu b’xejn sal-aħħar tal-2024, u wara jew:

  • Jiġu ċċarġjati bir-rati attwali (bħalissa $0.10/GB/jum) jekk intużaw mill-inqas darba f’Run maħluq wara s-17 ta’ April 2024.

  • Jitħassru jekk ma jkunux intużaw f’Run wieħed bejn is-17 ta’ April 2024 u l-31 ta’ Diċembru 2024 — dan biex jiġi evitat li tiġi ċċarġjat għal vector stores li jista’ jkun ħloqt qabel ma tħabbret din il-bidla fil-prezzijiet iżda qatt ma użajthom.

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 fuq l-API?

Iva, l-istreaming huwa disponibbli fuq l-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 ta’ funzjonijiet ta’ partijiet terzi?

Le. Filwaqt li s-sejħa għall-funzjoni tippermetti lill-mudell jagħżel għodod u jifformattja talbiet għalihom, l-eżekuzzjoni ta’ sejħiet għal għodod ta’ partijiet terzi mhijiex immaniġġjata minn OpenAI.

Kif tiġi ttrattata d-data li nibgħat lil OpenAI?

Bħall-bqija tal-pjattaforma tagħna, id-data u l-fajls mgħoddija lill-OpenAI API 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 mtellgħa fl-Assistants API tinħażen indefinittivament 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.

Playground Assistants view editing MyQuickstartAssistant with gpt-3.5-turbo and Code interpreter enabled

X’inhu l-limitu ta’ karattri għall-istruzzjonijiet tal-assistent fl-Assistants API?

Il-qasam tal-istruzzjonijiet tal-assistent għandu tul massimu ta’ 256,000 karattru.

Qed nirċievi żball bħal “Is-server sab żball waqt li kien qed jipproċessa t-talba tiegħek. Jiddispjaċina! Tista’ terġa’ tipprova t-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 ikkonfigurat sew. Jekk tibqa’ terġa’ tipprova t-talba u din tfalli, ipprova dawn:

  1. irristruttura l-prompt tiegħek biex kwalunkwe kmand li jixbah funzjoni jiġi ttrattat bħala funzjoni

  2. żid kwalunkwe kmand fil-prompt tiegħek bħala funzjoni ma’ tools

Għaliex l-għodda File Search tiegħi mhix 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 konverżazzjonijiet itwal jew interazzjonijiet multipli ma’ File Search, ikkunsidra li żżid dan il-limitu għal 50,000, jew idealment, tneħħi l-limiti ta’ max_prompt_tokens għal kollox biex tikseb riżultati tal-ogħla kwalità. Aqra aktar hawn.

Kif nista’ nagħti feedback?

Nieħdu gost nisimgħu l-feedback tiegħek fuq il-Forum tal-Iżviluppaturi tagħna, permezz taċ-Ċentru tal-Għajnuna fuq help.openai.com, jew fuq Twitter @OpenAIDevs.

Dan l-artiklu kien ta’ għajnuna?