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

FAQ Assistants API (v2)

Pembaruan: 14 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 nggunakake Assistants API v1 beta?

Ora. Wiwit 18 Desember 2024, pangguna ora maneh duwe akses menyang versi v1 saka Assistant API beta. Saiki kita mung ndhukung v2. Mangga deleng pandhuan migrasi iki kanggo ngowahi panggilan API sampeyan saka v1 menyang 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 iku alat File Search?

Alat `file_search` ngetrapake sawetara praktik paling apik retrieval kanthi langsung kanggo mbantu sampeyan ngekstrak data sing pas saka file sampeyan supaya nambah tanggapan model. Kanggo informasi luwih lengkap, waca dokumentasi developer kita.

Kanthi gawan, alat file_search nggunakake setelan ing ngisor iki:

  • Ukuran chunk: 800 token

  • Tumpang tindih chunk: 400 token

  • Model embedding: `text-embedding-3-large` ing 256 dimensi

  • Jumlah maksimum chunk sing ditambahake menyang konteks: 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 API Assistants?

Ya, mode JSON kasedhiya ing API Assistants liwat parameter response_format ing obyek 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 entuk kasalahan kayata “Server ngalami kasalahan nalika ngolah panjaluk sampeyan. Nyuwun pangapunten! Sampeyan bisa nyoba maneh panjaluk sampeyan, utawa hubungi kita liwat Pusat Bantuan ing help.openai.com yen kasalahan terus ana. “ Aku kudu piye?

Yen sampeyan entuk kasalahan iki, bisa uga tegese prompt sampeyan durung disetel kanthi bener. Yen sampeyan terus nyoba maneh panjaluk lan tetep gagal, iki sawetara perkara sing bisa dicoba:

  1. pesthekake nyusun ulang prompt sampeyan supaya nganggep prentah sing mirip fungsi minangka fungsi

  2. tambahake prentah apa wae ing prompt sampeyan 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?