OpenAI
Šo lapu tulkoja mašīntulks. Skatīt oriģinālo rakstu angļu valodā.

Assistants API (v2) BUJ

Pārskatiet Assistants API v2 funkcijas, ierobežojumus, cenas un migrāciju uz Responses API.

Atjaunināts: 14 days ago

No 2025. gada 11. marta esam izlaiduši mūsu jaunās aģentu platformas pamatelementus. Plašāku informāciju skatiet mūsu API dokumentācijā par Responses API, rīkiem, tostarp Web Search, File Search un Computer Use, kā arī mūsu Agents SDK ar Tracing. Balstoties uz jūsu atsauksmēm par Assistants API beta versiju, esam iekļāvuši būtiskus uzlabojumus Responses API. Kad būsim panākuši pilnīgu funkciju paritāti, vēlāk šogad paziņosim Assistants API izmantošanas pārtraukšanas plānu, paredzot galīgo izslēgšanu 2026. gada pirmajā pusē.

Bieži uzdotie jautājumi

Kas ir Assistants API?

Assistants API ļauj izstrādātājiem viegli veidot jaudīgus MI asistentus savās lietotnēs. Šī API novērš nepieciešamību pārvaldīt sarunu vēsturi un nodrošina piekļuvi OpenAI mitinātiem rīkiem, piemēram, Koda interpretētājam un failu meklēšanai. API atbalsta arī uzlabotu funkcijas izsaukšanu trešo pušu rīkiem.

Vai joprojām varu izmantot Assistants API v1 beta versiju?

Nē. Kopš 2024. gada 18. decembra lietotājiem vairs nav pieejama Assistants API beta versija v1. Pašlaik atbalstām tikai v2. Lai API izsaukumus pārveidotu no v1 uz v2, skatiet šo migrācijas ceļvedi.

Kā tam piekļūt?

Assistants API ir pieejams ikvienam ar OpenAI API kontu, taču tas ir novecojis un tiks noņemts 2026. gada augustā. Jauniem projektiem tā vietā izmantojiet Responses API. Ja jau izmantojat Assistants API, plānojiet migrāciju uz Responses API. Kamēr API vēl ir pieejams, esošajiem asistentiem joprojām varat piekļūt Assistants Playground.

Kas ir asistents?

Asistents ir konkrētam mērķim veidots mākslīgais intelekts, kas izmanto OpenAI modeļus un var piekļūt failiem, uzturēt pastāvīgus sarunu pavedienus un izsaukt rīkus.

Kas ir sarunas pavediens?

Sarunas pavediens ir sarunas sesija starp asistentu un lietotāju. Sarunu pavedieni vienkāršo lietotņu izstrādi, saglabājot ziņojumu vēsturi un to saīsinot, kad saruna pārsniedz modeļa konteksta garuma ierobežojumu.

Kas ir failu meklēšanas rīks?

Rīkā file_search jau ir iestrādātas vairākas informācijas izgūšanas labās prakses, kas palīdz no failiem iegūt vajadzīgos datus, lai papildinātu modeļa atbildes.

Pēc noklusējuma rīks file_search izmanto šādus iestatījumus:

  • Fragmenta lielums: 800 tokenu

  • Fragmentu pārklāšanās: 400 tokenu

  • Iegulšanas modelis: text-embedding-3-large ar 256 dimensijām

  • Maksimālais kontekstam pievienoto fragmentu skaits: 20

Kādi ir failu augšupielādes ierobežojumi?

Failu augšupielādei ir šādi ierobežojumi:

  • 512 MB vienam failam

  • 5 miljoni tokenu vienam failam

  • 10 000 failu vienā vektoru krātuvē

  • 1 vektoru krātuve vienam asistentam

  • 1 vektoru krātuve vienam sarunas pavedienam

Kopējais krātuves ierobežojums katram organizācijas projektam ir 100 GB.

Kādi ir failu meklēšanas rīka ierobežojumi?

Ir daži zināmi ierobežojumi, kurus plānojam novērst tuvākajos mēnešos:

  1. Pašlaik nav iespējams mainīt sadalīšanas fragmentos, iegulšanas vai informācijas izgūšanas iestatījumus.

  2. Dokumentos esošo attēlu parsēšana netiek atbalstīta.

  3. Informācijas izgūšana no strukturētu formātu failiem (piemēram, .csv vai .jsonl failiem) netiek atbalstīta. Skatiet atbalstītos failu tipus.

Kādi ir Assistants API pieprasījumu biežuma ierobežojumi?

Assistants API pieprasījumu biežuma ierobežojumi nav atkarīgi no lietošanas līmeņa un modeļa. Tā vietā katram pieprasījumu veidam ir noklusējuma ierobežojumi ar dažiem izņēmumiem:

  • GET: 1000 pieprasījumu minūtē

  • POST: 300 pieprasījumu minūtē

  • DELETE: 300 pieprasījumu minūtē

Kāda ir maksa par Koda interpretētāja izmantošanu API?

Maksa par Koda interpretētāju ir 0,03 USD par sesiju. Ja jūsu asistents vienlaikus izsauc Koda interpretētāju divos dažādos sarunas pavedienos, tiek izveidotas divas Koda interpretētāja sesijas (2 × 0,03 USD). Katra sesija pēc noklusējuma ir aktīva vienu stundu. Tas nozīmē, ka šo maksu maksājat tikai vienreiz, ja lietotājs vienas stundas laikā turpina dot norādījumus Koda interpretētājam tajā pašā sarunas pavedienā.

Kāda ir maksa par failu meklēšanas izmantošanu API?

Maksa par failu meklēšanu ir 0,10 USD dienā par katru vektoru krātuves GB (pirmais krātuves GB ir bez maksas). Vektoru krātuves lielumu nosaka pēc faila parsēšanas, sadalīšanas fragmentos un iegulšanas.

Visas vektoru krātuves, kas izveidotas pirms 2024. gada 17. aprīļa, būs bez maksas līdz 2024. gada beigām. Pēc tam:

  • Par tām tiks iekasēta maksa pēc spēkā esošajiem tarifiem (pašlaik 0,10 USD/GB dienā), ja tās ir izmantotas vismaz vienā izpildē (Run), kas izveidota pēc 2024. gada 17. aprīļa.

  • Tās tiks dzēstas, ja laikā no 2024. gada 17. aprīļa līdz 2024. gada 31. decembrim nav izmantotas nevienā izpildē (Run). Tas ļaus izvairīties no maksas par vektoru krātuvēm, kuras, iespējams, izveidojāt pirms šo cenu izmaiņu paziņošanas, bet nekad neizmantojāt.

Vai ir ierobežojums, cik asistentu varu izveidot?

Nav ierobežojuma, cik asistentu organizācija var izveidot.

Vai API ir pieejama straumēšana?

Jā, Assistants API ir pieejama straumēšana.

Vai Assistants API ir pieejams JSON režīms?

Jā, Assistants API ir pieejams JSON režīms, izmantojot objektu Assistants vai Run parametru response_format.

Vai Assistants API pārvaldīs arī trešo pušu funkciju izsaukšanas pieprasījumus?

Nē. Lai gan funkcijas izsaukšana ļauj modelim atlasīt rīkus un formatēt tiem paredzētos pieprasījumus, OpenAI nepārvalda trešo pušu rīku izsaukumu izpildi.

Kā tiek apstrādāti dati, kurus nosūtu OpenAI?

Tāpat kā citviet mūsu platformā, OpenAI API nosūtītie dati un faili nekad netiek izmantoti mūsu modeļu apmācībai, un jūs varat dzēst savus datus, kad vien nepieciešams. Assistants API augšupielādētie dati tiek glabāti bez termiņa ierobežojuma, līdz lietotājs tos manuāli izdzēš.

Vai DALL-E ir pieejams, izmantojot Assistants API?

Pašlaik DALL-E nav pieejams.

Vai Assistants API ir lietotāja saskarne?

Assistants API varat izmēģināt Playground. Pārliecinieties, ka kreisajā sānjoslā atrodaties skatā Assistants un izmantojat modeli, kas ir saderīgs ar rīkiem, kurus vēlaties ieslēgt.

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

Kāds ir asistenta norādījumu rakstzīmju skaita ierobežojums Assistants API?

Asistenta norādījumu lauka maksimālais garums ir 256 000 rakstzīmju.

Saņemu kļūdas ziņojumu, piemēram, „Apstrādājot jūsu pieprasījumu, serverī radās kļūda. Atvainojamies! Varat mēģināt nosūtīt pieprasījumu vēlreiz vai, ja kļūda atkārtojas, sazināties ar mums palīdzības centrā help.openai.com. “ Kā rīkoties?

Ja saņemat šo kļūdas ziņojumu, iespējams, jūsu uzvedne nav pareizi izveidota. Ja pieprasījums neizdodas arī pēc atkārtotiem mēģinājumiem, izmēģiniet šādas darbības:

  1. pārstrukturējiet uzvedni tā, lai funkcijām līdzīgas komandas tiktu apstrādātas kā funkcijas

  2. pievienojiet visas uzvednē esošās komandas kā funkcijas parametram tools

Kāpēc mans failu meklēšanas rīks nedarbojas labi?

Izmantojot failu meklēšanas rīku, iesakām iestatīt max_prompt_tokens vērtību vismaz uz 20 000. Garākām sarunām vai atkārtotai failu meklēšanas izmantošanai apsveriet iespēju palielināt šo ierobežojumu līdz 50 000. Lai iegūtu vislabākos rezultātus, vēlams vispār noņemt max_prompt_tokens ierobežojumus.

Kā varu sniegt atsauksmes?

Priecāsimies saņemt jūsu atsauksmes mūsu izstrādātāju forumā, Palīdzības centrā help.openai.com vai Twitter kontā @OpenAIDevs.

Vai šis raksts bija noderīgs?