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

Assistants API (v2) BUJ

Atjaunināts: 2 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ē.

Kas ir Assistants API?

Assistants API ļauj izstrādātājiem viegli izveidot jaudīgus AI asistentus savās lietotnēs. Šis API novērš vajadzību pārvaldīt sarunu vēsturi un pievieno piekļuvi OpenAI mitinātiem rīkiem, piemēram, Koda interpretētājam un File Search. 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 izveidots AI, kas izmanto OpenAI modeļus un var piekļūt failiem, uzturēt pastāvīgus pavedienus un izsaukt rīkus.

Kas ir pavediens?

Pavediens ir sarunas sesija starp asistentu un lietotāju. Pavedieni vienkāršo lietotņu izstrādi, saglabājot ziņojumu vēsturi un saīsinot to, kad saruna kļūst pārāk gara modeļa konteksta garumam.

Kas ir rīks File Search?

Rīks file_search jau sākotnēji izmanto vairākas informācijas izgūšanas paraugprakses, lai palīdzētu no failiem iegūt pareizos datus un papildinātu modeļa atbildes. Plašāku informāciju skatiet mūsu izstrādātāju dokumentācijā.

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?

Faila augšupielādes ierobežojumi ir šādi:

  • 512 MB vienam failam

  • 5 milj. tekstvienību vienam failam

  • 10 tūkst. failu vienā vektoru krātuvē

  • 1 vektoru krātuve vienam asistentam

  • 1 vektoru krātuve vienam pavedienam

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

Kādi ir File Search rīka ierobežojumi?

Ir daži zināmi ierobežojumi, kuru atbalstu plānojam pievienot turpmākajos mēnešos:

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

  2. Mēs neatbalstām attēlu parsēšanu dokumentos.

  3. Mēs neatbalstām izgūšanu no strukturētiem failu formātiem (piemēram, .csv vai .jsonl failiem). Skatiet atbalstītos failu tipus.

Kādi ir Assistants API darbības ierobežojumi?

Assistants API darbības ierobežojumi nav piesaistīti lietojuma līmenim un modelim. Tā vietā ir noklusējuma ierobežojumi pēc pieprasījuma veida, ar dažiem izņēmumiem:

  • GET: 1000 RPM

  • POST: 300 RPM

  • DELETE: 300 pieprasījumi minūtē

Kā API tiek noteikta Koda interpretētāja cena?

Koda interpretētāja cena ir 0,03 USD par sesiju. Ja jūsu asistents vienlaikus izsauc Koda interpretētāju divos dažādos pavedienos, tiks izveidotas divas Koda interpretētāja sesijas (2 * 0,03 USD). Katra sesija pēc noklusējuma ir aktīva vienu stundu, kas nozīmē, ka šo maksu maksāsiet tikai vienreiz, ja lietotājs turpinās sniegt norādījumus Koda interpretētājam tajā pašā pavedienā līdz vienai stundai.

Kā API tiek noteikta File Search cena?

File Search cena ir 0,10 USD par vektoru krātuves GB dienā (pirmais krātuves GB ir bez maksas). Vektoru krātuves lielums ir balstīts uz vektoru krātuves galīgo lielumu pēc tam, kad fails ir parsēts, sadalīts fragmentos un iegults.

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 tās tiks vai nu:

  • Aplikts ar maksu pēc pašreizējām likmēm (pašlaik 0,10 USD/GB/dienā), ja tās vismaz vienu reizi izmantotas Run, kas izveidots pēc 2024. gada 17. aprīļa.

  • Dzēstas, ja tās nav izmantotas nevienā Run laikā no 2024. gada 17. aprīļa līdz 2024. gada 31. decembrim — tas ir paredzēts, lai jums nebūtu jāmaksā par vektoru krātuvēm, ko, iespējams, izveidojāt pirms šīs cenu izmaiņas 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ā, straumēšana ir pieejama Assistants API.

Vai Assistants API ir pieejams JSON režīms?

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

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

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

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

Tāpat kā pārējā mūsu platformā, dati un faili, kas nodoti OpenAI API, 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 neierobežotu laiku, līdz lietotājs tos manuāli dzēš.

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 ierobežojums Assistants API?

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

Es saņemu kļūdas ziņojumu, piemēram: „Apstrādājot jūsu pieprasījumu, serverī radās kļūda. Atvainojiet! Varat mēģināt nosūtīt pieprasījumu vēlreiz. Ja kļūda atkārtojas, sazinieties ar mums, izmantojot palīdzības centru vietnē help.openai.com. “ Ko man darīt?

Šī kļūda var liecināt, ka uzvedne nav pareizi iestatīta. Ja arī pēc atkārtotiem mēģinājumiem pieprasījums neizdodas, izmēģiniet tālāk norādīto.

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

  2. pievienojiet visas uzvednē norādītās komandas sadaļai tools kā funkcijas

Kāpēc mans File Search rīks nedarbojas labi?

Izmantojot File Search rīku, iesakām iestatīt max_prompt_tokens ne mazāku par 20 000. Garākām sarunām vai vairākām mijiedarbībām ar File Search apsveriet iespēju palielināt šo ierobežojumu līdz 50 000 vai, ideālā gadījumā, pilnībā noņemt max_prompt_tokens ierobežojumus, lai iegūtu visaugstākās kvalitātes rezultātus. Lasiet vairāk šeit.

Kā varu sniegt atsauksmes?

Mēs labprāt uzklausīsim jūsu atsauksmes mūsu Izstrādātāju forumā, Palīdzības centrā vietnē help.openai.com vai Twitter kontā @OpenAIDevs.

Vai šis raksts bija noderīgs?