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

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

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

Шинэчилсэн: 6 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 нь хөгжүүлэгчдэд апп дотроо хүчирхэг хиймэл оюунт туслахыг хялбархан бүтээх боломж олгодог. Энэ API-г ашигласнаар харилцан ярианы түүхийг өөрөө удирдах шаардлагагүй болж, 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 дээрээс хандаж болно.

Туслах гэж юу вэ?

Туслах нь OpenAI-ийн загваруудыг ашигладаг, файлд хандах, ярианы хэлхээг хадгалах, хэрэгсэл дуудах чадвартай, тодорхой зориулалтаар бүтээсэн хиймэл оюун ухаан юм.

Ярианы хэлхээ гэж юу вэ?

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

Файл хайх хэрэгсэл гэж юу вэ?

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

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

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

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

  • Векторжуулах загвар: 256 хэмжээс бүхий text-embedding-3-large

  • Контекстэд нэмэх хэсгийн дээд тоо: 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 дахь Файл хайх хэрэгсэл ямар үнэтэй вэ?

Файл хайх хэрэгслийн үнэ вектор сангийн хадгалалтын 1 ГБ тутамд өдөрт $0.10 байна (эхний 1 ГБ хадгалалт үнэгүй). Вектор сангийн хэмжээг таны файлыг задлан боловсруулж, хэсэгчилж, векторжуулсны дараах бодит хэмжээгээр тооцно.

2024 оны 4 дүгээр сарын 17-ноос өмнө үүсгэсэн бүх вектор сан 2024 оныг дуустал үнэгүй байна. Үүний дараа дараах хоёр нөхцөлийн аль нэг нь үйлчилнэ:

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

  • 2024 оны 4 дүгээр сарын 17-ноос 2024 оны 12 дугаар сарын 31-ний хооронд нэг ч Run-д ашиглаагүй бол устгана. Ингэснээр үнийн өөрчлөлтийг зарлахаас өмнө үүсгэсэн ч огт ашиглаагүй вектор сангийн төлбөрийг танаас авахгүй.

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

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

API нь хариуг урсгалаар дамжуулах боломжтой юу?

Тийм, Assistants API нь хариуг урсгалаар дамжуулах боломжтой.

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

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

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

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

Миний OpenAI руу илгээсэн өгөгдлийг хэрхэн ашиглаж, хадгалдаг вэ?

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

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 дахь туслахын зааврын тэмдэгтийн хязгаар хэд вэ?

Туслахын зааврын талбарын урт хамгийн ихдээ 256,000 тэмдэгт байна.

Надад “Таны хүсэлтийг боловсруулах явцад серверт алдаа гарлаа. Үүнд хүлцэл өчье! Та хүсэлтээ дахин илгээж болно. Алдаа гарсаар байвал help.openai.com дахь тусламжийн төвөөр дамжуулан бидэнтэй холбогдоорой. ” гэх мэт алдаа гарч байна. Би яах ёстой вэ?

Энэ алдаа гарч байвал таны өгөгдөл зөв тохируулагдаагүй байж болзошгүй. Хүсэлтээ дахин дахин илгээсэн ч бүтэлгүйтсээр байвал дараахыг туршаарай:

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

  2. өгөгдөл дэх бүх командаа tools-д функц болгон нэмээрэй

Миний Файл хайх хэрэгсэл яагаад сайн ажиллахгүй байна вэ?

Файл хайх хэрэгслийг ашиглахдаа max_prompt_tokens-ийн утгыг 20,000-аас багагүй байхаар тохируулахыг зөвлөж байна. Урт харилцан яриа эсвэл Файл хайх хэрэгслийг олон удаа ашиглах үед энэ хязгаарыг 50,000 болгож нэмэгдүүлэхийг бодолцоорой. Хамгийн чанартай үр дүн авахын тулд max_prompt_tokens хязгаарыг бүрмөсөн арилгавал бүр сайн.

Санал хүсэлтээ хэрхэн өгөх вэ?

Бид таны санал хүсэлтийг Хөгжүүлэгчдийн форум, help.openai.com дахь Тусламжийн төв эсвэл Twitter-ийн @OpenAIDevs хаягаар хүлээн авахдаа баяртай байх болно.

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