OpenAI
ეს გვერდი მანქანური თარგმანის მეშვეობით ითარგმნა. სტატიის ინგლისური დედნის ნახვა.

Assistants API (v2) ხშირად დასმული კითხვები

გაეცანით Assistants API v2-ის ფუნქციებს, შეზღუდვებს, ფასებსა და Responses API-ზე მიგრაციას.

განახლებულია: 8 days ago

2025 წლის 11 მარტის მდგომარეობით, გამოვუშვით ჩვენი ახალი Agents პლატფორმის ძირითადი კომპონენტები. დეტალებისთვის იხილეთ ჩვენი API დოკუმენტაცია Responses API-სთვის, ინსტრუმენტები, მათ შორის Web Search, File Search და Computer Use, ასევე ჩვენი Agents SDK Tracing-თან ერთად. Assistants API beta-ზე თქვენი გამოხმაურების საფუძველზე, ძირითადი გაუმჯობესებები Responses API-ში ჩავრთეთ. მას შემდეგ, რაც ფუნქციურ სრულ თანხვედრას მივაღწევთ, ამ წლის ბოლოს გამოვაცხადებთ Assistants API-ის deprecated-ად გამოცხადების გეგმას, სამიზნე გაუქმების თარიღით 2026 წლის პირველ ნახევარში.

ხშირად დასმული კითხვები

რა არის Assistants API?

Assistants API დეველოპერებს საშუალებას აძლევს, მარტივად შექმნან მძლავრი AI ასისტენტები თავიანთ აპებში. ეს API გამორიცხავს საუბრის ისტორიის მართვის საჭიროებას და უზრუნველყოფს წვდომას OpenAI-ის სერვერებზე განთავსებულ ხელსაწყოებზე, როგორიცაა კოდის ინტერპრეტატორი და ფაილების ძიება. API ასევე მხარს უჭერს ფუნქციის გამოძახების გაუმჯობესებულ შესაძლებლობას მესამე მხარის ხელსაწყოებისთვის.

კვლავ შემიძლია Assistants API v1 beta-ს გამოყენება?

არა. 2024 წლის 18 დეკემბრიდან მომხმარებლებს Assistant API beta-ს v1 ვერსიაზე წვდომა აღარ აქვთ. ამჟამად მხოლოდ v2-ს ვუჭერთ მხარს. API გამოძახებების v1-დან v2-ზე გადასაყვანად გაეცანით მიგრაციის სახელმძღვანელოს.

როგორ მივიღო მასზე წვდომა?

Assistants API ხელმისაწვდომია ყველასთვის, ვისაც OpenAI API ანგარიში აქვს, მაგრამ ის deprecated-ია და 2026 წლის აგვისტოში გაუქმდება. ახალი პროექტებისთვის მის ნაცვლად გამოიყენეთ Responses API. თუ უკვე იყენებთ Assistants API-ს, დაგეგმეთ მიგრაცია Responses API-ზე. API-ის ხელმისაწვდომობის პერიოდში არსებული ასისტენტებზე წვდომას კვლავ შეძლებთ Assistants Playground-ში.

რა არის ასისტენტი?

ასისტენტი კონკრეტული მიზნისთვის შექმნილი ხელოვნური ინტელექტია, რომელიც იყენებს OpenAI-ის მოდელებს და შეუძლია ფაილებზე წვდომა, მუდმივი თრედების შენარჩუნება და ხელსაწყოების გამოძახება.

რა არის თრედი?

თრედი ასისტენტსა და მომხმარებელს შორის საუბრის სესიაა. თრედები აპლიკაციების შემუშავებას ამარტივებს: ისინი ინახავს შეტყობინებების ისტორიას და ამოკლებს მას, როცა საუბარი მოდელის კონტექსტის სიგრძეს აჭარბებს.

რა არის ფაილების ძიების ხელსაწყო?

file_search ხელსაწყო დამატებითი გამართვის გარეშე იყენებს ინფორმაციის მოძიების რამდენიმე საუკეთესო პრაქტიკას, რათა დაგეხმაროთ თქვენი ფაილებიდან საჭირო მონაცემების ამოღებაში და ამ მონაცემებით მოდელის პასუხების გამდიდრებაში.

ნაგულისხმევად, file_search ხელსაწყო იყენებს შემდეგ პარამეტრებს:

  • ფრაგმენტის ზომა: 800 ტოკენი

  • ფრაგმენტების გადაფარვა: 400 ტოკენი

  • ვექტორიზაციის მოდელი: text-embedding-3-large, 256 განზომილებით

  • კონტექსტში დამატებული ფრაგმენტების მაქსიმალური რაოდენობა: 20

რა შეზღუდვები მოქმედებს ფაილების ატვირთვაზე?

ფაილის ატვირთვაზე მოქმედებს შემდეგი შეზღუდვები:

  • 512 მბაიტი თითო ფაილზე

  • 5 მილიონი ტოკენი თითო ფაილზე

  • 10 ათასი ფაილი თითო ვექტორულ საცავზე

  • 1 ვექტორული საცავი თითო ასისტენტზე

  • 1 ვექტორული საცავი თითო თრედზე

ორგანიზაციაში თითოეული პროექტისთვის საცავის საერთო ლიმიტი 100 გბაიტია.

რა შეზღუდვები აქვს ფაილების ძიების ხელსაწყოს?

არსებობს რამდენიმე ცნობილი შეზღუდვა, რომელთა აღმოფხვრაზეც ვმუშაობთ და შესაბამისი შესაძლებლობების დამატებას მომდევნო თვეებში ვგეგმავთ:

  1. ამჟამად შეუძლებელია ფრაგმენტებად დაყოფის, ვექტორიზაციის ან ინფორმაციის მოძიების პარამეტრების შეცვლა.

  2. დოკუმენტებში არსებული გამოსახულებების დამუშავება მხარდაჭერილი არ არის.

  3. სტრუქტურირებული ფორმატის ფაილებში (მაგალითად, .csv ან .jsonl ფაილებში) ინფორმაციის მოძიება მხარდაჭერილი არ არის. იხილეთ ფაილების მხარდაჭერილი ტიპები.

რა ლიმიტები მოქმედებს მოთხოვნების სიხშირეზე Assistants API-ში?

Assistants API-ში მოთხოვნების სიხშირის ლიმიტები არ არის დამოკიდებული გამოყენების დონესა და მოდელზე. სანაცვლოდ, მოთხოვნის ტიპის მიხედვით მოქმედებს ნაგულისხმევი ლიმიტები, რამდენიმე გამონაკლისით:

  • GET: 1000 მოთხოვნა წუთში

  • POST: 300 მოთხოვნა წუთში

  • DELETE: 300 მოთხოვნა წუთში

რა ღირს კოდის ინტერპრეტატორის გამოყენება API-ში?

კოდის ინტერპრეტატორის ფასი თითო სესიაზე 0,03 აშშ დოლარია. თუ თქვენი ასისტენტი კოდის ინტერპრეტატორს ერთდროულად ორ სხვადასხვა თრედში გამოიძახებს, შეიქმნება კოდის ინტერპრეტატორის ორი სესია (2 * 0,03 აშშ დოლარი). თითოეული სესია ნაგულისხმევად ერთი საათის განმავლობაშია აქტიური. ეს ნიშნავს, რომ თუ თქვენი მომხმარებელი ერთი საათის განმავლობაში იმავე თრედში განაგრძობს კოდის ინტერპრეტატორისთვის ინსტრუქციების მიცემას, ამ საფასურს მხოლოდ ერთხელ გადაიხდით.

რა ღირს ფაილების ძიების გამოყენება API-ში?

ფაილების ძიების ფასი ვექტორული საცავის თითო გბაიტზე დღეში 0,10 აშშ დოლარია (საცავის პირველი გბაიტი უფასოა). ვექტორული საცავის ზომა განისაზღვრება თქვენი ფაილის დამუშავების, ფრაგმენტებად დაყოფისა და ვექტორიზაციის შემდეგ მიღებული საბოლოო მოცულობით.

2024 წლის 17 აპრილამდე შექმნილი ყველა ვექტორული საცავი უფასო იქნება 2024 წლის ბოლომდე, რის შემდეგაც:

  • მათზე გავრცელდება მოქმედი ტარიფები (ამჟამად 0,10 აშშ დოლარი თითო გბაიტზე დღეში), თუ ისინი ერთხელ მაინც გამოიყენეთ 2024 წლის 17 აპრილის შემდეგ შექმნილ Run-ში.

  • ისინი წაიშლება, თუ 2024 წლის 17 აპრილიდან 2024 წლის 31 დეკემბრამდე არცერთ Run-ში არ გამოგიყენებიათ — ასე არ მოგიწევთ საფასურის გადახდა ვექტორული საცავებისთვის, რომლებიც შესაძლოა ფასის ცვლილების გამოცხადებამდე შექმენით, მაგრამ არასოდეს გამოგიყენებიათ.

არსებობს ლიმიტი, რამდენი ასისტენტის შექმნა შემიძლია?

ორგანიზაციის მიერ შექმნილი ასისტენტების რაოდენობაზე ლიმიტი არ არსებობს.

ხელმისაწვდომია თუ არა სტრიმინგი API-ში?

დიახ, სტრიმინგი ხელმისაწვდომია Assistants API-ში.

ხელმისაწვდომია თუ არა JSON რეჟიმი Assistants API-ში?

დიახ, JSON რეჟიმი ხელმისაწვდომია Assistants API-ში, Assistants ან Run ობიექტების response_format პარამეტრის მეშვეობით.

მართავს თუ არა Assistants API მესამე მხარის ფუნქციების გამოძახების მოთხოვნებსაც?

არა. ფუნქციის გამოძახება მოდელს საშუალებას აძლევს, შეარჩიოს ხელსაწყოები და მათთვის მოთხოვნები შესაბამის ფორმატში მოამზადოს, თუმცა მესამე მხარის ხელსაწყოების გამოძახების შესრულებას OpenAI არ მართავს.

როგორ მუშავდება მონაცემები, რომლებსაც OpenAI-ს ვუგზავნი?

როგორც ჩვენი პლატფორმის სხვა ნაწილებში, OpenAI API-სთვის მიწოდებული მონაცემები და ფაილები არასოდეს გამოიყენება ჩვენი მოდელების გასაწვრთნელად და თქვენი მონაცემების წაშლა ნებისმიერ დროს შეგიძლიათ. Assistants API-ში ატვირთული მონაცემები ინახება უვადოდ, სანამ მომხმარებელი მათ თავად არ წაშლის.

ხელმისაწვდომია თუ არა DALL-E Assistants API-ის მეშვეობით?

ამჟამად DALL-E ხელმისაწვდომი არ არის.

არსებობს UI Assistants API-სთვის?

შეგიძლიათ ნახოთ Playground Assistants API-სთვის. დარწმუნდით, რომ მარცხენა გვერდითა ზოლში Assistants ხედში ხართ და იყენებთ მოდელს, რომელიც თავსებადია იმ ინსტრუმენტებთან, რომელთა ჩართვაც გსურთ.

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

რა არის ასისტენტის ინსტრუქციების სიმბოლოების ლიმიტი Assistants API-ში?

ასისტენტის ინსტრუქციების ველის მაქსიმალური სიგრძეა 256 000 სიმბოლო.

ვიღებ შეცდომის შეტყობინებას, მაგალითად: „სერვერზე თქვენი მოთხოვნის დამუშავებისას შეცდომა მოხდა. ბოდიშს გიხდით! შეგიძლიათ ხელახლა გაგზავნოთ მოთხოვნა, ან, თუ შეცდომა კვლავ ჩნდება, დაგვიკავშირდეთ ჩვენი დახმარების ცენტრის მეშვეობით მისამართზე help.openai.com. “ როგორ მოვიქცე?

თუ ამ შეცდომას იღებთ, შესაძლოა თქვენი მოთხოვნა სწორად არ იყოს შედგენილი. თუ მოთხოვნას ხელახლა აგზავნით და ის მაინც ვერ სრულდება, სცადეთ შემდეგი:

  1. შეცვალეთ მოთხოვნის სტრუქტურა ისე, რომ ფუნქციის მსგავსი ყველა ბრძანება ფუნქციად აღიქმებოდეს

  2. თქვენს მოთხოვნაში არსებული ყველა ბრძანება ფუნქციის სახით დაამატეთ tools-ში

რატომ არ მუშაობს კარგად ფაილების ძიების ხელსაწყო?

ფაილების ძიების ხელსაწყოს გამოყენებისას გირჩევთ, max_prompt_tokens პარამეტრს მიანიჭოთ არანაკლებ 20 000-ის მნიშვნელობა. ხანგრძლივი საუბრებისთვის ან ფაილების ძიებასთან მრავალჯერადი ინტერაქციისთვის განიხილეთ ამ ლიმიტის 50 000-მდე გაზრდა. საუკეთესო შედეგებისთვის კი უმჯობესია max_prompt_tokens ლიმიტები საერთოდ მოხსნათ.

როგორ შემიძლია გამოხმაურების გაგზავნა?

სიამოვნებით მოვისმენთ თქვენს აზრს ჩვენს დეველოპერების ფორუმზე, დახმარების ცენტრის მეშვეობით — help.openai.com, ან Twitter-ზე — @OpenAIDevs.

სასარგებლო იყო ეს სტატია?