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

რა არის Assistants API?

Assistants API დეველოპერებს საშუალებას აძლევს, მარტივად შექმნან ძლიერი AI ასისტენტები თავიანთ აპებში. ეს API ხსნის საუბრის ისტორიის მართვის საჭიროებას და ამატებს წვდომას OpenAI-ის მიერ ჰოსტირებულ ინსტრუმენტებზე, როგორიცაა კოდის ინტერპრეტატორი და File Search. 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-ში.

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

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

რა არის ნაკადი?

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

რა არის File Search ინსტრუმენტი?

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

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

• Chunk-ის ზომა: 800 token

• Chunk-ის გადაფარვა: 400 token

• Embedding მოდელი: `text-embedding-3-large` 256 განზომილებაზე

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

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

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

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

• 5M token თითო ფაილზე

• 10k ფაილი თითო vector store-ზე

• 1 vector store თითო ასისტენტზე

• 1 vector store თითო ნაკადზე

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

რა შეზღუდვები აქვს File Search ინსტრუმენტს?

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

1. ამჟამად არ არსებობს chunking-ის, embedding-ის ან retrieval-ის პარამეტრების შეცვლის გზა.

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

3. სტრუქტურირებულ ფაილის ფორმატებზე (როგორიცაა .csv ან .jsonl ფაილები) retrieval-ებს არ ვუჭერთ მხარს. იხილეთ მხარდაჭერილი ფაილის ტიპები.

როგორია მოთხოვნების ლიმიტები 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/გბ vector store-ის საცავზე დღეში (საცავის პირველი გბ უფასოა). vector store-ის ზომა ეფუძნება vector store-ის საბოლოო ზომას მას შემდეგ, რაც თქვენი ფაილი დაიპარსება, დაიყოფა chunk-ებად და embedding-ად გარდაიქმნება.

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

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

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

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

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

ხელმისაწვდომია streaming API-ზე?

დიახ, streaming ხელმისაწვდომია Assistants API-ზე.

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

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

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

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

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

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

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

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

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

შეგიძლიათ ნახოთ Playground Assistants API-სთვის. დარწმუნდით, რომ მარცხენა გვერდითა ზოლში 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-ის ლიმიტების სრულად მოხსნა, რათა მიიღოთ უმაღლესი ხარისხის შედეგები. წაიკითხეთ მეტი აქ.

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

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