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

FAQ Assistants API (v2)

Pembaruan: 10 days 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.

Apa iku API Assistants?

API Assistants ngidini developer gampang mbangun asisten AI sing kuat ing aplikasi. API iki ngilangake kabutuhan kanggo ngatur riwayat pacelathon lan nambah akses menyang alat sing di-host OpenAI kaya Code Interpreter lan File Search. API iki uga ndhukung nelpon fungsi sing luwih apik kanggo alat 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 Assistant?

Asisten makili AI sing dirancang kanggo tujuan tartamtu sing nggunakake model OpenAI lan bisa ngakses file, njaga thread sing terus ana, lan nelpon alat.

Apa iku Thread?

Thread yaiku sesi pacelathon antarane asisten lan pangguna. Thread nyederhanakake pangembangan aplikasi kanthi nyimpen riwayat pesen lan motong nalika pacelathon dadi dawa banget kanggo dawa konteks model.

Apa kuwi piranti File Search?

Piranti file_search langsung ngetrapake sawetara praktik paling apik kanggo njupuk data, supaya kowé bisa njupuk data sing trep saka berkasmu kanggo nglengkapi respons model. Kanggo informasi luwih lengkap, wacanen dokumentasi pangembang kita.

Kanthi gawan, piranti file_search nganggo setelan iki:

  • Ukuran potongan: 800 token

  • Tumpang tindih potongan: 400 token

  • Model embedding: text-embedding-3-large kanthi 256 dimènsi

  • Cacah maksimal potongan sing ditambahake menyang kontèks: 20

Apa wae watesan kanggo unggahan File?

Watesan kanggo ngunggah File yaiku:

  • 512 MB saben file

  • 5M token saben file

  • 10k file saben vector store

  • 1 vector store saben asisten

  • 1 vector store saben thread

Watesan panyimpenan sakabèhé kanggo saben proyek ing organisasi yaiku 100 GB.

Apa watesan alat File Search?

Kita duwe sawetara watesan sing wis dingerteni lan lagi digarap supaya didhukung ing sasi-sasi ngarep:

  1. Saiki durung ana cara kanggo ngowahi setelan chunking, embedding, utawa retrieval.

  2. Kita durung ndhukung parsing gambar ing dokumen.

  3. Kita durung ndhukung retrieval liwat format file terstruktur (kaya file .csv utawa .jsonl). Delengen jinis file sing didhukung.

Apa watesan rate kanggo API Assistants?

Watesan rate kanggo API Assistants ora digandhengake karo tingkat panggunaan lan model. Nanging, ana watesan gawan miturut jinis panjaluk, kanthi sawetara pangecualian:

  • GET: 1000 RPM

  • POST: 300 RPM

  • DELETE: 300 panjaluk saben menit

Kepiye rega Code Interpreter ing API?

Code Interpreter diregani $0.03 / sesi. Yen asisten sampeyan nelpon Code Interpreter bebarengan ing rong thread sing beda, iki bakal nggawe rong sesi Code Interpreter (2 * $0.03). Saben sesi aktif kanthi gawan sajrone sak jam, tegese sampeyan mung mbayar ragad iki sapisan yen pangguna sampeyan terus menehi instruksi menyang Code Interpreter ing thread sing padha nganti sak jam.

Kepiye rega File Search ing API?

File Search diregani $0.10/GB panyimpenan vector store saben dina (GB panyimpenan pisanan gratis). Ukuran vector store adhedhasar ukuran asil vector store sawisé file sampeyan diparse, dipérang dadi chunk, lan di-embed.

Vector store apa wae sing digawe sadurunge 17 April 2024 bakal gratis nganti pungkasan 2024, sawisé iku bakal salah siji:

  • Ditagih miturut tarif saiki (saiki $0.10/GB/dina) yen wis digunakake paling ora sapisan ing Run sing digawe sawisé 17 April 2024.

  • Dibusak yen durung tau digunakake ing Run siji wae antarane 17 April 2024 lan 31 Desember 2024 — iki kanggo nyegah sampeyan ketagih kanggo vector store sing bisa uga wis sampeyan gawe 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 API Assistants.

Apa mode JSON kasedhiya ing Assistants API?

Ya, mode JSON kasedhiya ing Assistants API liwat paramèter response_format ing objèk Assistants utawa Run.

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

Ora. Sanajan nelpon fungsi ngidini model milih alat lan ngformat panjaluk kanggo alat kasebut, eksekusi panggilan menyang alat pihak katelu ora dikelola dening OpenAI.

Kepiye data sing dakirim menyang OpenAI ditangani?

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

Apa DALL-E kasedhiya liwat API Assistants?

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

Apa watesan karakter kanggo instruksi asisten ing API Assistants?

Kolom instruksi asisten nduweni dawa maksimal 256.000 karakter.

Aku nemoni pesen error kayata “Server ngalami error nalika ngolah panjalukmu. Nyuwun pangapura! Kowé bisa nyoba ngirim panjalukmu maneh, utawa ngubungi kita liwat pusat bantuan ing help.openai.com yen error kasebut terus kedadeyan. ” Aku kudu kepriyé?

Yen kowé nemoni error iki, bisa uga prompt-mu durung disiyapake kanthi bener. Yen panjaluk wis bola-bali dicoba nanging tetep gagal, coba tindakake iki:

  1. susun maneh prompt-mu supaya prentah sing kaya fungsi dianggep minangka fungsi

  2. tambahna saben prentah ing prompt-mu minangka fungsi menyang tools

Napa alat File Search-ku ora bisa mlaku kanthi apik?

Nalika nggunakake alat File Search, disaranake nyetel max_prompt_tokens ora kurang saka 20.000. Kanggo pacelathon sing luwih dawa utawa pirang-pirang interaksi karo File Search, coba tambah watesan iki dadi 50.000, utawa sing paling becik, copot watesan max_prompt_tokens kabeh supaya entuk asil kualitas paling dhuwur. Waca luwih lengkap ing kéné.

Kepiye carane aku bisa menehi umpan balik?

Kita seneng banget ngrungokake umpan balik sampeyan ing Forum Developer kita, liwat Pusat Bantuan ing help.openai.com, utawa ing Twitter @OpenAIDevs.

Apa artikel iki migunani kanggo sampeyan?