OpenAI
Kaca iki diterjemahake nganggo mesin. Deleng artikel asli basa Inggris.

FAQ Assistants API (v2)

Tinjau fitur, watesan, rega, lan migrasi Assistants API v2 menyang Responses API.

Pembaruan: 58 minutes ago

Wiwit 11 Maret 2025, kita wis ngrilis blok pambangun platform Agen anyar kita. Kanggo rincian, deleng dokumen API kita kanggo API Responses, Tools kalebu Web Search, File Search, lan Computer Use, lan Agents SDK kita kanthi Tracing. Adhedhasar umpan balik sampeyan kanggo API Assistants beta, kita wis nglebokake panyempurnaan utama menyang API Responses. Sawisé kita nggayuh kesetaraan fitur lengkap, kita bakal ngumumake rencana deprecation API Assistants mengko taun iki, kanthi target tanggal sunset ing separo pisanan 2026.

Pitakonan sing kerep ditakokake

Apa iku Assistants API?

Assistants API nggampangake pangembang nggawe asisten AI sing andal ing aplikasine. Kanthi API iki, pangembang ora perlu ngatur riwayat pacelathon lan bisa ngakses piranti sing di-host dening OpenAI, kayata Code Interpreter lan File Search. API iki uga ndhukung fitur nelpon fungsi sing wis ditingkatake kanggo piranti pihak katelu.

Apa aku isih bisa nganggo Assistants API v1 beta?

Ora. Wiwit 18 Dhésèmber 2024, pangguna wis ora bisa ngakses Assistant API beta versi v1. Saiki, kita mung ndhukung v2. Wacanen pandhuan migrasi iki kanggo ngowahi panggilan API saka v1 dadi v2.

Kepiye carane aku ngakses iki?

API Assistants kasedhiya kanggo sapa wae sing duwe akun API OpenAI, nanging wis deprecated lan bakal dibusak ing Agustus 2026. Kanggo proyek anyar, gunakake API Responses wae. Yen sampeyan wis nggunakake API Assistants, rencanakna migrasi menyang API Responses. Sampeyan isih bisa ngakses asisten sing wis ana ing Assistants Playground nalika API isih kasedhiya.

Apa iku Asisten?

Asisten yaiku AI sing digawe kanggo tujuan tartamtu, nggunakake model OpenAI, lan bisa ngakses file, njaga thread supaya tetep kasimpen, lan ngundang piranti.

Apa iku Thread?

Thread yaiku sesi pacelathon antarane asisten lan pangguna. Thread nggampangake pangembangan aplikasi kanthi nyimpen riwayat pesen lan nugel riwayat kasebut nalika pacelathon wis ngluwihi wates dawa konteks model.

Apa iku piranti File Search?

Piranti file_search wis ngetrapake sawetara praktik paling apik kanggo njupuk informasi tanpa perlu setelan tambahan, supaya sampeyan bisa njupuk data sing trep saka file kanggo nglengkapi tanggapan model.

Piranti file_search nggunakake setelan gawan ing ngisor iki:

  • Ukuran potongan: 800 token

  • Bagean sing tumpang tindih antarane potongan: 400 token

  • Model embedding: text-embedding-3-large kanthi 256 dimensi

  • Cacah maksimal potongan sing ditambahake menyang konteks: 20

Apa wae watesan kanggo ngunggah file?

Watesan kanggo ngunggah file yaiku:

  • 512 MB saben file

  • 5 yuta token saben file

  • 10 ewu file saben panyimpenan vektor

  • 1 panyimpenan vektor saben asisten

  • 1 panyimpenan vektor saben thread

Wates total panyimpenan kanggo saben proyek ing organisasi yaiku 100 GB.

Apa wae watesane piranti File Search?

Ana sawetara watesan sing wis kita mangerteni lan lagi kita garap supaya bisa didhukung ing sasi-sasi ngarep:

  1. Saiki durung ana cara kanggo ngowahi setelan pambagean teks (chunking), embedding, utawa pangjupukan informasi (retrieval).

  2. Kita durung ndhukung panguraian gambar ing dokumen.

  3. Kita durung ndhukung pangjupukan informasi saka format file terstruktur (kayata file .csv utawa .jsonl). Deleng jinis file sing didhukung.

Pira wates panjaluk kanggo Assistants API?

Wates panjaluk kanggo Assistants API ora gumantung marang tingkat panggunaan lan model. Nanging, ana wates gawan adhedhasar jinis panjaluk, kanthi sawetara pangecualian:

  • GET: 1000 RPM

  • POST: 300 RPM

  • DELETE: 300 panjaluk saben menit

Pira regane Code Interpreter ing API?

Regane Code Interpreter yaiku $0,03 saben sesi. Yen asisten sampeyan ngundang Code Interpreter bebarengan ing rong thread sing beda, iki bakal nggawe rong sesi Code Interpreter (2 * $0,03). Kanthi setelan gawan, saben sesi aktif suwene sakjam. Tegese, sampeyan mung mbayar biaya iki sepisan yen pangguna sampeyan terus menehi instruksi marang Code Interpreter ing thread sing padha nganti sakjam.

Pira regane File Search ing API?

Regane File Search yaiku $0,10/GB panyimpenan vektor saben dina (GB kapisan gratis). Ukuran panyimpenan vektor diitung saka asil sawise file sampeyan diurai, dipérang dadi potongan, lan diowahi dadi embedding.

Kabeh panyimpenan vektor sing digawe sadurunge 17 April 2024 bakal gratis nganti pungkasan taun 2024. Sawise iku, panyimpenan kasebut bakal:

  • Dikenani biaya manut tarif sing lumaku (saiki $0,10/GB/dina) yen wis digunakake paling ora sepisan ing Run sing digawe sawise 17 April 2024.

  • Dibusak yen ora tau digunakake ing Run wiwit 17 April 2024 nganti 31 Desember 2024 — iki supaya sampeyan ora dikenani biaya kanggo panyimpenan vektor sing bisa uga wis digawe sadurunge owah-owahan rega iki diumumake nanging ora tau digunakake.

Apa ana watesan jumlah asisten sing bisa dakgawe?

Ora ana watesan jumlah asisten sing bisa digawe dening sawijining org.

Apa streaming kasedhiya ing API?

Ya, streaming kasedhiya ing Assistants API.

Apa mode JSON kasedhiya ing Assistants API?

Ya, mode JSON kasedhiya ing Assistants API liwat parameter response_format ing obyek Assistants utawa Run.

Apa Assistants API uga bakal ngatur panjaluk kanggo ngundang fungsi pihak katelu?

Ora. Sanajan fitur nelpon fungsi ngidini model milih piranti lan ngatur format panjaluk kanggo piranti kasebut, OpenAI ora ngatur eksekusi panggilan menyang piranti pihak katelu.

Kepiye data sing dakkirim menyang OpenAI ditangani?

Kaya ing bagean liyane saka platform kita, data lan file sing dikirim menyang API OpenAI ora tau digunakake kanggo nglatih model kita, lan sampeyan bisa mbusak data kapan wae yen perlu. Data sing diunggah menyang Assistants API disimpen tanpa wates wektu nganti pangguna mbusak kanthi manual.

Apa DALL-E kasedhiya liwat Assistants API?

Saiki, DALL-E durung kasedhiya.

Apa ana UI kanggo API Assistants?

Sampeyan bisa mriksa Playground kanggo API Assistants. Pesthekake sampeyan ana ing tampilan Assistants ing sidebar kiwa lan nggunakake model sing kompatibel karo Tools sing arep sampeyan aktifake.

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

Pira wates karakter kanggo instruksi asisten ing Assistants API?

Kolom instruksi asisten duwe wates dawa maksimal 256.000 karakter.

Aku nampa pesen kesalahan kayata “Server ngalami kesalahan nalika ngolah panjaluk sampeyan. Nyuwun pangapura! Sampeyan bisa nyoba ngirim panjaluk maneh, utawa ngubungi kita liwat Pusat Bantuan ing help.openai.com yen kesalahan isih kedadeyan. ” Apa sing kudu daklakoni?

Yen sampeyan nampa pesen kesalahan iki, bisa uga prompt sampeyan durung disusun kanthi bener. Yen sampeyan wis bola-bali ngirim panjaluk nanging tetep gagal, iki sawetara cara sing bisa dicoba:

  1. susun maneh prompt sampeyan supaya kabeh prentah sing kaya fungsi dianggep minangka fungsi

  2. tambahake kabeh prentah ing prompt sampeyan minangka fungsi menyang tools

Yagene piranti File Search-ku ora bisa digunakake kanthi becik?

Nalika nggunakake piranti File Search, kita nyaranake nyetel max_prompt_tokens paling ora 20.000. Kanggo pacelathon sing luwih dawa utawa interaksi bola-bali karo File Search, coba tambah wates iki dadi 50.000, utawa luwih becik busak kabeh wates max_prompt_tokens supaya oleh asil sing paling apik.

Kepiye carane menehi saran?

Kita seneng nampa saran sampeyan ing Forum Pangembang, liwat Pusat Bantuan ing help.openai.com, utawa ing Twitter @OpenAIDevs.

Apa artikel iki migunani kanggo sampeyan?