Assistants API (v2) ՀՏՀ

Ի՞նչ է Assistants API-ն։

Assistants API-ն մշակողներին հնարավորություն է տալիս իրենց հավելվածներում հեշտությամբ ստեղծել հզոր AI օգնականներ։ Այս API-ն վերացնում է զրույցի պատմությունը կառավարելու անհրաժեշտությունը և ավելացնում է մուտք OpenAI-ում հոսթավորված գործիքներին, ինչպիսիք են Կոդերի թարգմանիչը և File Search-ը։ API-ն նաև աջակցում է բարելավված գործառույթի կանչ 3-րդ կողմի գործիքների համար։

Կարո՞ղ եմ դեռ օգտագործել Assistants API v1 բետան։

Ոչ։ 2024 թ. դեկտեմբերի 18-ից օգտատերերն այլևս մուտք չունեն Assistant API բետայի v1 տարբերակին։ Ներկայումս մենք աջակցում ենք միայն v2-ը։ Խնդրում ենք դիտել այս միգրացիայի ուղեցույցը՝ ձեր API կանչերը v1-ից v2 փոխարկելու համար

Ինչպե՞ս կարող եմ մուտք գործել դրան։

Assistants API-ն հասանելի է OpenAI API հաշիվ ունեցող յուրաքանչյուրին, սակայն այն հնացած է հայտարարված և կհեռացվի 2026 թվականի օգոստոսին։ Նոր նախագծերի համար փոխարենը օգտագործեք Responses API-ն։ Եթե արդեն օգտագործում եք Assistants API-ն, պլանավորեք ձեր միգրացիան դեպի Responses API։ Դուք դեռ կարող եք մուտք գործել առկա օգնականներին Assistants Playground-ում, քանի դեռ API-ն հասանելի է։

Ի՞նչ է օգնականը։

Օգնականը նպատակային ստեղծված AI է, որն օգտագործում է OpenAI-ի մոդելները և կարող է մուտք ունենալ ֆայլերին, պահպանել մշտական շղթաներ և կանչել գործիքներ։

Ի՞նչ է շղթան։

Շղթան օգնականի և օգտատիրոջ միջև զրույցի սեսիա է։ Շղթաները պարզեցնում են հավելվածների մշակումը՝ պահելով հաղորդագրությունների պատմությունը և կրճատելով այն, երբ զրույցը չափազանց երկար է դառնում մոդելի համատեքստի երկարության համար։

Ի՞նչ է File Search գործիքը։

`file_search` գործիքը լռելյայն կիրառում է որոնման մի քանի լավագույն գործելակերպեր, որպեսզի օգնի ձեզ ձեր ֆայլերից հանել ճիշտ տվյալները՝ մոդելի պատասխանները հարստացնելու համար։ Լրացուցիչ տեղեկությունների համար կարդացեք մեր մշակողների փաստաթղթերը։

Լռելյայն, file_search գործիքն օգտագործում է հետևյալ կարգավորումները.

• Մասնատի չափը՝ 800 թոքեն

• Մասնատների համընկնումը՝ 400 թոքեն

• Embedding մոդել՝ `text-embedding-3-large`՝ 256 չափողականությամբ

• Համատեքստին ավելացվող մասնատների առավելագույն քանակը՝ 20

Որո՞նք են ֆայլի վերբեռնման սահմանափակումները։

Ֆայլ վերբեռնելու սահմանափակումներն են՝

• 512 ՄԲ մեկ ֆայլի համար

• 5 մլն թոքեն մեկ ֆայլի համար

• 10 հազ. ֆայլ մեկ վեկտորային պահոցում

• 1 վեկտորային պահոց մեկ օգնականի համար

• 1 վեկտորային պահոց մեկ շղթայի համար

Կազմակերպության յուրաքանչյուր նախագծի ընդհանուր պահեստավորման սահմանաչափը 100 ԳԲ է։

Որո՞նք են File Search գործիքի սահմանափակումները։

Մենք ունենք մի քանի հայտնի սահմանափակումներ, որոնց աջակցությունը նախատեսում ենք ավելացնել առաջիկա ամիսներին.

1. Ներկայումս չկա մասնատման, embedding-ի կամ որոնման կարգավորումները փոփոխելու եղանակ։

2. Մենք չենք աջակցում փաստաթղթերի ներսում պատկերների վերլուծությանը։

3. Մենք չենք աջակցում կառուցվածքային ֆայլերի ձևաչափերում որոնումներին (օրինակ՝ .csv կամ .jsonl ֆայլերում)։ Տեսեք աջակցվող ֆայլերի տեսակները։

Որո՞նք են Assistants API-ի սահմանաչափերը։

Assistants API-ի սահմանաչափերը կապված չեն օգտագործման մակարդակի և մոդելի հետ։ Փոխարենը կան լռելյայն սահմանաչափեր ըստ հարցման տեսակի՝ մի քանի բացառություններով.

• GET՝ 1000 RPM

• POST՝ 300 RPM

• DELETE՝ 300 հարցում մեկ րոպեում

Ինչպե՞ս է գնագոյացվում Կոդերի թարգմանիչը API-ում։

Կոդերի թարգմանիչի արժեքը $0.03 է մեկ սեսիայի համար։ Եթե ձեր օգնականը Կոդերի թարգմանիչը միաժամանակ կանչում է երկու տարբեր շղթաներում, դա կստեղծի Կոդերի թարգմանիչի երկու սեսիա (2 * $0.03)։ Յուրաքանչյուր սեսիա լռելյայն ակտիվ է մեկ ժամ, ինչը նշանակում է, որ այս վճարը կվճարեք միայն մեկ անգամ, եթե ձեր օգտատերը նույն շղթայում մինչև մեկ ժամ շարունակի հրահանգներ տալ Կոդերի թարգմանիչին։

Ինչպե՞ս է գնագոյացվում File Search-ը API-ում։

File Search-ի արժեքը օրական $0.10/ԳԲ է վեկտորային պահոցի համար (պահեստավորման առաջին ԳԲ-ն անվճար է)։ Վեկտորային պահոցի չափը հիմնված է այն վերջնական չափի վրա, որը ստացվում է ձեր ֆայլը վերլուծելուց, մասնատելուց և embedding անելուց հետո։

Մինչև 2024 թ. ապրիլի 17-ը ստեղծված բոլոր վեկտորային պահոցներն անվճար կլինեն մինչև 2024 թ. ավարտը, որից հետո դրանք կա՛մ՝

• Կգանձվեն գործող սակագներով (ներկայումս՝ $0.10/ԳԲ/օր), եթե դրանք գոնե մեկ անգամ օգտագործվել են 2024 թ. ապրիլի 17-ից հետո ստեղծված Run-ում։

• Կջնջվեն, եթե 2024 թ. ապրիլի 17-ից մինչև 2024 թ. դեկտեմբերի 31-ը ոչ մի Run-ում չեն օգտագործվել. սա արվում է, որպեսզի ձեզնից վճար չգանձվի այն վեկտորային պահոցների համար, որոնք հնարավոր է ստեղծել եք մինչև այս գնային փոփոխության հայտարարումը, բայց երբեք չեք օգտագործել։

Կա՞ սահմանափակում, թե քանի օգնական կարող եմ ստեղծել։

Կազմակերպության կողմից ստեղծվող օգնականների քանակի սահմանափակում չկա։

Streaming-ը հասանելի՞ է API-ում։

Այո, streaming-ը հասանելի է Assistants API-ում։

JSON ռեժիմը հասանելի՞ է Assistants API-ում։

Այո, JSON ռեժիմը հասանելի է Assistants API-ում՝ Assistants կամ Run օբյեկտների response_format պարամետրի միջոցով։

Assistants API-ն նաև կկառավարի՞ 3-րդ կողմի գործառույթների կանչերի հարցումները։

Ոչ։ Թեև գործառույթի կանչը մոդելին հնարավորություն է տալիս ընտրել գործիքներ և ձևաչափել դրանց համար հարցումներ, 3-րդ կողմի գործիքներին ուղղված կանչերի կատարումը չի կառավարվում OpenAI-ի կողմից։

Ինչպե՞ս են մշակվում այն տվյալները, որոնք ուղարկում եմ OpenAI-ին։

Ինչպես մեր հարթակի մնացած մասում, OpenAI API-ին փոխանցված տվյալներն ու ֆայլերը երբեք չեն օգտագործվում մեր մոդելները մարզելու համար, և դուք կարող եք ջնջել ձեր տվյալները, երբ անհրաժեշտ համարեք։ Assistants API վերբեռնված տվյալները պահվում են անժամկետ, մինչև օգտատերը ձեռքով ջնջի դրանք։

DALL-E-ը հասանելի՞ է Assistants API-ի միջոցով։

Այս պահին DALL-E-ը հասանելի չէ։

Assistants API-ի համար կա՞ UI։

Assistants API-ի համար կարող եք փորձել Playground-ը։ Համոզվեք, որ ձախ կողային վահանակում գտնվում եք Assistants դիտման մեջ և օգտագործում եք այն գործիքների հետ համատեղելի մոդել, որոնք ցանկանում եք միացնել։

Ո՞րն է օգնականի հրահանգների նիշերի սահմանաչափը Assistants API-ում։

Օգնականի հրահանգների դաշտի առավելագույն երկարությունը 256,000 նիշ է։

Ես ստանում եմ սխալ, օրինակ՝ «Սերվերի մոտ սխալ առաջացավ ձեր հարցումը մշակելիս։ Ներողություն դրա համար։ Կարող եք կրկնել ձեր հարցումը կամ կապվել մեզ հետ մեր Օգնության կենտրոնի միջոցով՝ help.openai.com հասցեով, եթե սխալը շարունակվի։ » Ի՞նչ պետք է անեմ։

Եթե ստանում եք այս սխալը, դա կարող է նշանակել, որ ձեր հարցումը ճիշտ կարգավորված չէ։ Եթե շարունակում եք կրկնել հարցումը, և այն ձախողվում է, փորձեք հետևյալը.

1. համոզվեք, որ վերակազմակերպել եք ձեր հարցումը այնպես, որ գործառույթի նման հրամանները դիտարկվեն որպես գործառույթներ

2. ձեր հարցման մեջ եղած ցանկացած հրաման ավելացրեք որպես գործառույթ tools-ում

Ինչո՞ւ իմ File Search գործիքը լավ չի աշխատում։

File Search գործիքն օգտագործելիս խորհուրդ ենք տալիս max_prompt_tokens-ը սահմանել առնվազն 20,000։ Ավելի երկար զրույցների կամ File Search-ի հետ բազմակի փոխազդեցությունների համար դիտարկեք այս սահմանաչափը մինչև 50,000 բարձրացնելու կամ, իդեալական դեպքում, max_prompt_tokens սահմանափակումներն ամբողջությամբ հեռացնելու տարբերակը՝ առավել որակյալ արդյունքներ ստանալու համար։ Ավելին կարդացեք այստեղ։

Ինչպե՞ս կարող եմ կարծիք հայտնել։

Մենք սիրով կլսենք ձեր կարծիքը մեր Մշակողների ֆորումում, Օգնության կենտրոնի միջոցով՝ help.openai.com հասցեով, կամ Twitter-ում՝ @OpenAIDevs։