OpenAI
Энэ хуудсыг машинаар орчуулсан. Англи хэл дээрх нийтлэлийн эх хувилбарыг үзнэ үү.

Assistants API (v2) Түгээмэл асуулт, хариулт

Assistants API v2-ийн боломжууд, хязгаарлалт, үнэ болон Responses API руу шилжих үйл явцтай танилцана уу.

Шинэчилсэн: 5 days ago

2025 оны 3-р сарын 11-ний байдлаар бид шинэ агентын платформынхаа үндсэн бүрэлдэхүүн хэсгүүдийг гаргасан. Дэлгэрэнгүйг манай Responses API-ийн API баримт бичиг, Web Search, File Search, Computer Use зэрэг Tools, мөн Tracing бүхий манай Agents SDK-аас үзнэ үү. Assistants API beta-н талаарх таны санал хүсэлтэд үндэслэн бид гол сайжруулалтуудыг Responses API-д тусгасан. Бүрэн feature parity-д хүрсний дараа бид энэ оны сүүлээр Assistants API-г deprecated болгох төлөвлөгөөг зарлах бөгөөд зорилтот sunset огноо нь 2026 оны эхний хагас байна.

Assistants API гэж юу вэ?

Assistants API нь хөгжүүлэгчдэд апп дотроо хүчирхэг AI assistant-уудыг хялбар бүтээх боломж олгодог. Энэ API нь харилцан ярианы түүхийг удирдах шаардлагыг арилгаж, Код тайлагч болон File Search зэрэг OpenAI дээр байршуулсан хэрэгслүүдэд хандах боломж нэмдэг. API нь мөн гуравдагч талын хэрэгслүүдэд зориулсан сайжруулсан функц дуудахыг дэмждэг.

Assistants API v1 бета хувилбарыг ашиглаж болох уу?

Үгүй. 2024 оны 12-р сарын 18-наас хэрэглэгчид Assistant API-н бета v1 хувилбарт хандах боломжгүй болсон. Одоогоор бид зөвхөн v2-г дэмждэг. API дуудлагуудаа v1-ээс v2 руу шилжүүлэхийн тулд энэ шилжүүлгийн зааврыг үзнэ үү.

Би түүнд хэрхэн хандах вэ?

Assistants API нь OpenAI API бүртгэлтэй хэн бүхэнд боломжтой боловч deprecated болсон бөгөөд 2026 оны 8-р сард устгагдана. Шинэ төслүүдэд оронд нь Responses API-г ашиглаарай. Хэрэв та Assistants API-г аль хэдийн ашиглаж байгаа бол Responses API руу шилжихээ төлөвлөөрэй. API боломжтой хэвээр байх хугацаанд та одоо байгаа assistant-ууддаа Assistants Playground дээрээс хандаж болно.

Assistant гэж юу вэ?

Assistant нь OpenAI-н загваруудыг ашигладаг, файлд хандах, тогтвортой thread хадгалах, хэрэгсэл дуудах чадвартай, тодорхой зорилгод зориулан бүтээсэн AI-г илэрхийлнэ.

Thread гэж юу вэ?

Thread нь assistant болон хэрэглэгчийн хоорондох харилцан ярианы session юм. Thread нь мессежийн түүхийг хадгалж, харилцан яриа загварын context уртаас хэт урт болох үед тайрснаар апп хөгжүүлэлтийг хялбарчилдаг.

File Search хэрэгсэл гэж юу вэ?

file_search хэрэгсэл нь загварын хариултыг баяжуулахад шаардлагатай өгөгдлийг файлаас тань гаргаж авахад туслах мэдээлэл татах шилдэг хэд хэдэн аргыг анхнаасаа хэрэгжүүлсэн байдаг. Дэлгэрэнгүй мэдээллийг манай хөгжүүлэгчийн баримт бичгээс уншина уу.

file_search хэрэгсэл анхдагчаар дараах тохиргоог ашиглана:

  • Хэсгийн хэмжээ: 800 токен

  • Хэсгийн давхцал: 400 токен

  • Эмбеддинг загвар: 256 хэмжээс бүхий text-embedding-3-large

  • Контекстэд нэмэх хэсгийн дээд тоо: 20

Файл upload хийхэд ямар хязгаарлалтууд байдаг вэ?

Файл upload хийх хязгаарлалтууд:

  • Нэг файлд 512 MB

  • Нэг файлд 5M токен

  • Нэг vector store-д 10k файл

  • Нэг assistant-д 1 vector store

  • Нэг thread-д 1 vector store

Байгууллага доторх төсөл бүрийн нийт хадгалалтын хязгаар 100 GB байна.

File Search хэрэгслийн хязгаарлалтууд юу вэ?

Бид ирэх саруудад дэмжлэг нэмэхээр ажиллаж буй хэдэн мэдэгдэж байгаа хязгаарлалттай:

  1. Одоогоор chunking, embedding эсвэл retrieval тохиргоог өөрчлөх арга байхгүй.

  2. Бид баримт бичиг доторх зургийг задлан шинжлэхийг дэмждэггүй.

  3. Бид бүтэцтэй файлын форматууд (.csv эсвэл .jsonl файл гэх мэт) дээр retrieval хийхийг дэмждэггүй. Дэмжигдсэн файлын төрлүүдийг үзнэ үү.

Assistants API-ийн хурдны хязгаарууд юу вэ?

Assistants API-ийн хурдны хязгаарууд нь ашиглалтын түвшин болон загвартай холбоогүй. Үүний оронд хүсэлтийн төрлөөр анхдагч хязгаарууд байдаг бөгөөд хэдэн үл хамаарах тохиолдол бий:

  • GET: 1000 RPM

  • POST: 300 RPM

  • DELETE: минут тутамд 300 хүсэлт

API дахь Код тайлагчийн үнэ хэрхэн тооцогддог вэ?

Код тайлагчийн үнэ нэг session тутамд $0.03 байна. Хэрэв таны assistant Код тайлагчийг хоёр өөр thread-д зэрэг дуудвал энэ нь Код тайлагчийн хоёр session (2 * $0.03) үүсгэнэ. Session бүр анхдагчаар нэг цагийн турш идэвхтэй байдаг тул таны хэрэглэгч нэг thread дотор Код тайлагчид нэг цаг хүртэл заавар өгсөөр байвал та энэ төлбөрийг зөвхөн нэг удаа төлнө гэсэн үг.

API дахь File Search-ийн үнэ хэрхэн тооцогддог вэ?

File Search-ийн үнэ vector store хадгалалтын GB тутамд өдөрт $0.10 (хадгалалтын эхний GB үнэгүй) байна. Vector store-ийн хэмжээ нь таны файлыг задлан шинжилж, chunk болгож, embedding хийсний дараа үүссэн vector store-ийн хэмжээнд үндэслэнэ.

2024 оны 4-р сарын 17-ноос өмнө үүсгэсэн аливаа vector store 2024 оныг дуустал үнэгүй байх бөгөөд дараа нь дараахын аль нэг болно:

  • Хэрэв 2024 оны 4-р сарын 17-ноос хойш үүсгэсэн Run-д дор хаяж нэг удаа ашигласан бол одоогийн тарифаар (одоогоор $0.10/GB/өдөр) төлбөр тооцогдоно.

  • Хэрэв 2024 оны 4-р сарын 17-ноос 2024 оны 12-р сарын 31-ний хооронд нэг ч Run-д ашиглаагүй бол устгагдана — энэ нь үнийн өөрчлөлт зарлагдахаас өмнө үүсгэсэн байж болох ч огт ашиглаагүй vector store-уудын төлбөр танд тооцогдохоос сэргийлэх зорилготой.

Би хэдэн assistant үүсгэж болох талаар хязгаар бий юу?

Байгууллага хэдэн assistant үүсгэж болох талаар хязгаар байхгүй.

API дээр streaming боломжтой юу?

Тийм, streaming нь Assistants API дээр боломжтой.

Assistants API-д JSON горим бий юу?

Тийм. Assistants эсвэл Run объектын response_format параметрээр дамжуулан Assistants API-д JSON горим ашиглах боломжтой.

Assistants API нь гуравдагч талын функц дуудлагын хүсэлтүүдийг мөн удирдах уу?

Үгүй. Функц дуудах нь загварт хэрэгсэл сонгох болон тэдгээрт зориулсан хүсэлтийг форматлах боломж олгодог ч гуравдагч талын хэрэгсэл рүү дуудлага гүйцэтгэхийг OpenAI удирддаггүй.

Миний OpenAI руу илгээсэн өгөгдлийг хэрхэн боловсруулдаг вэ?

Манай платформын бусад хэсгийн нэгэн адил OpenAI API руу дамжуулсан өгөгдөл болон файлуудыг манай загваруудыг сургахад хэзээ ч ашигладаггүй бөгөөд та шаардлагатай үедээ өгөгдлөө устгаж болно. Assistants API-д upload хийсэн өгөгдөл нь хэрэглэгч гараар устгах хүртэл хугацаагүй хадгалагдана.

DALL-E нь Assistants API-аар дамжин боломжтой юу?

Одоогоор DALL-E боломжгүй байна.

Assistants API-д зориулсан UI бий юу?

Assistants API-д зориулсан Playground-ийг үзэж болно. Зүүн талын sidebar дээрх Assistants харагдацад байгаа эсэхээ, мөн асаахыг хүссэн Tools-тэй нийцэх загвар ашиглаж байгаа эсэхээ шалгаарай.

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

Assistants API дахь assistant instructions-ийн тэмдэгтийн хязгаар хэд вэ?

assistant instructions талбарын дээд урт 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-д санал хүсэлтээ үлдээвэл бид баяртай байх болно.

Энэ нийтлэл танд тус болсон уу?