OpenAI
Ang page na ito ay isinalin ng AI. Tingnan ang orihinal na artikulo sa English.

FAQ ng Assistants API (v2)

Suriin ang mga feature, limitasyon, presyo, at paglipat mula Assistants API v2 patungong Responses API.

Na-update: 18 days ago

Noong Marso 11, 2025, inilabas namin ang mga building block ng aming bagong Agents platform. Para sa mga detalye, tingnan ang aming API docs para sa aming Responses API, Tools kabilang ang Web Search, File Search, at Computer Use, at ang aming Agents SDK na may Tracing. Batay sa iyong feedback para sa Assistants API beta, isinama namin ang mahahalagang pagpapahusay sa Responses API. Pagkatapos naming makamit ang buong feature parity, mag-aanunsyo kami ng plano ng deprecation ng Assistants API sa huling bahagi ng taong ito, na may target na sunset date sa unang kalahati ng 2026.

Mga Madalas Itanong

Ano ang Assistants API?

Gamit ang Assistants API, madaling makakagawa ang mga developer ng mga AI assistant na may malawak na kakayahan sa loob ng kanilang mga app. Sa API na ito, hindi na kailangang pamahalaan ang history ng pag-uusap, at may access na rin sa mga tool na hino-host ng OpenAI tulad ng Code Interpreter at File Search. Sinusuportahan din ng API ang pinahusay na pagtawag ng function para sa mga third-party na tool.

Magagamit ko pa ba ang Assistants API v1 beta?

Hindi. Mula noong Disyembre 18, 2024, wala nang access ang mga user sa bersyong v1 ng Assistant API beta. Sa kasalukuyan, v2 lang ang sinusuportahan namin. Pakitingnan ang gabay sa migration na ito para i-convert ang iyong mga API call mula v1 patungong v2.

Paano ko ito maa-access?

Available ang Assistants API sa sinumang may OpenAI API account, ngunit deprecated na ito at aalisin sa Agosto 2026. Para sa mga bagong proyekto, gamitin na lang ang Responses API. Kung ginagamit mo na ang Assistants API, planuhin ang iyong migration sa Responses API. Maa-access mo pa rin ang mga kasalukuyang assistant sa Assistants Playground habang available pa ang API.

Ano ang Assistant?

Ang assistant ay isang AI na ginawa para sa isang partikular na layunin. Gumagamit ito ng mga modelo ng OpenAI at kayang mag-access ng mga file, magpanatili ng mga thread, at tumawag ng mga tool.

Ano ang Thread?

Ang thread ay isang session ng pag-uusap sa pagitan ng assistant at user. Pinapadali ng mga thread ang pag-develop ng application sa pamamagitan ng pag-iimbak ng history ng mga mensahe at pagpapaikli nito kapag lumampas ang haba ng pag-uusap sa haba ng kontekstong kayang tanggapin ng modelo.

Ano ang File Search tool?

May nakahanda nang ilang pinakamahuhusay na pamamaraan sa pagkuha ng data ang file_search tool para matulungan kang kunin ang tamang data mula sa iyong mga file at mapahusay ang mga sagot ng modelo.

Bilang default, ginagamit ng file_search tool ang mga sumusunod na setting:

  • Laki ng chunk: 800 token

  • Magkakaparehong bahagi ng mga magkasunod na chunk: 400 token

  • Modelo ng embedding: text-embedding-3-large na may 256 na dimensyon

  • Pinakamaraming chunk na idinaragdag sa konteksto: 20

Ano ang mga limitasyon sa pag-upload ng file?

Ang mga limitasyon sa pag-upload ng File ay:

  • 512 MB bawat file

  • 5 milyong token bawat file

  • 10,000 file bawat vector store

  • 1 vector store bawat assistant

  • 1 vector store bawat thread

Ang kabuuang limitasyon sa storage ng bawat proyekto sa isang organisasyon ay 100 GB.

Ano ang mga limitasyon ng File Search tool?

May ilang kilalang limitasyon na sinisikap naming tugunan sa mga susunod na buwan:

  1. Sa kasalukuyan, walang paraan para baguhin ang mga setting ng chunking, embedding, o retrieval.

  2. Hindi namin sinusuportahan ang pag-parse ng mga larawan sa loob ng mga dokumento.

  3. Hindi namin sinusuportahan ang pagkuha ng data mula sa mga structured na file format (tulad ng mga .csv o .jsonl file). Tingnan ang mga sinusuportahang uri ng file.

Ano ang mga rate limit ng Assistants API?

Hindi nakadepende sa antas ng paggamit at modelo ang mga rate limit ng Assistants API. Sa halip, may mga default na limitasyon ayon sa uri ng request, na may ilang pagbubukod:

  • GET: 1000 RPM

  • POST: 300 RPM

  • DELETE: 300 request bawat minuto

Magkano ang singil sa Code Interpreter sa API?

Ang singil sa Code Interpreter ay $0.03 / session. Kung sabay na tatawag ang iyong assistant sa Code Interpreter sa dalawang magkaibang thread, gagawa ito ng dalawang session ng Code Interpreter (2 * $0.03). Bilang default, aktibo ang bawat session nang isang oras. Ibig sabihin, isang beses ka lang magbabayad ng singil na ito kung patuloy na magbibigay ng mga tagubilin ang iyong user sa Code Interpreter sa iisang thread sa loob ng hanggang isang oras.

Magkano ang singil sa File Search sa API?

Ang singil sa File Search ay $0.10/GB ng storage ng vector store bawat araw (libre ang unang GB ng storage). Ang laki ng vector store ay batay sa laki nito matapos ma-parse, mahati sa mga chunk, at ma-embed ang iyong file.

Libre hanggang sa katapusan ng 2024 ang anumang vector store na ginawa bago ang Abril 17, 2024. Pagkatapos nito, ang mga ito ay:

  • Sisingilin ayon sa kasalukuyang mga rate (sa ngayon ay $0.10/GB/araw) kung nagamit ang mga ito kahit isang beses sa isang Run na ginawa pagkalipas ng Abril 17, 2024.

  • Ide-delete kung hindi nagamit ang mga ito sa kahit isang Run mula Abril 17, 2024 hanggang Disyembre 31, 2024 — para hindi ka masingil para sa mga vector store na maaaring ginawa mo bago inanunsyo ang pagbabagong ito sa presyo pero hindi mo kailanman nagamit.

May limitasyon ba sa dami ng assistants na maaari kong gawin?

Walang limitasyon sa dami ng assistants na maaaring gawin ng isang org.

Available ba ang streaming sa API?

Oo, available ang streaming sa Assistants API.

Available ba ang JSON mode sa Assistants API?

Oo, available ang JSON mode sa Assistants API sa pamamagitan ng parameter na response_format sa mga object na Assistants o Run.

Pamamahalaan din ba ng Assistants API ang mga request para sa pagtawag ng mga third-party na function?

Hindi. Bagama't nagbibigay-daan ang pagtawag ng function para makapili ang modelo ng mga tool at ma-format ang mga request para sa mga ito, hindi pinamamahalaan ng OpenAI ang pagsasagawa ng mga tawag sa mga third-party na tool.

Paano pinangangasiwaan ang data na ipinapadala ko sa OpenAI?

Tulad sa iba pang bahagi ng aming platform, ang data at mga file na ipinapadala sa OpenAI API ay hindi kailanman ginagamit para sanayin ang aming mga modelo, at maaari mong i-delete ang iyong data anumang oras na kailangan mo. Ang data na ina-upload sa Assistants API ay iniimbak nang walang takdang panahon hanggang sa manu-mano itong i-delete ng user.

Available ba ang DALL-E sa Assistants API?

Sa ngayon, hindi available ang DALL-E.

May UI ba para sa Assistants API?

Maaari mong tingnan ang Playground para sa Assistants API. Tiyaking nasa view na Assistants ka sa kaliwang sidebar at gumagamit ng modelong compatible sa Tools na gusto mong i-toggle on.

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

Ilang character ang puwede sa mga tagubilin ng assistant sa Assistants API?

Hanggang 256,000 character ang puwede sa field ng mga tagubilin ng assistant.

Nakakatanggap ako ng error na tulad ng “Nagkaroon ng error sa server habang pinoproseso ang iyong request. Paumanhin! Maaari mong subukang muli ang iyong request, o makipag-ugnayan sa amin sa pamamagitan ng aming help center sa help.openai.com kung patuloy ang error. ” Ano ang dapat kong gawin?

Kung nakakatanggap ka ng error na ito, maaaring hindi tama ang pagkakaayos ng iyong prompt. Kung paulit-ulit mong sinusubukan ang request pero nabibigo pa rin ito, narito ang ilang puwede mong subukan:

  1. tiyaking ayusin muli ang iyong prompt para ituring na mga function ang anumang command na gumaganang parang function

  2. idagdag sa tools bilang function ang bawat command sa iyong prompt

Bakit hindi gumagana nang maayos ang aking File Search tool?

Kapag ginagamit ang File Search tool, inirerekomenda naming itakda ang max_prompt_tokens sa hindi bababa sa 20,000. Para sa mas mahahabang pag-uusap o maraming pakikipag-ugnayan sa File Search, pag-isipang taasan ang limitasyong ito sa 50,000. Mas mainam kung tuluyan mong aalisin ang mga limitasyon ng max_prompt_tokens para makuha ang mga resultang may pinakamataas na kalidad.

Paano ako makakapagbigay ng feedback?

Ikagagalak naming marinig ang iyong feedback sa aming Forum ng mga Developer, sa pamamagitan ng Help Center sa help.openai.com, o sa Twitter @OpenAIDevs.

Nakatulong ba ang artikulong ito?