Soalan Lazim Assistants API (v2)

Apakah itu Assistants API?

Assistants API membolehkan pembangun membina assistant AI yang berkuasa dengan mudah dalam aplikasi mereka. API ini menghapuskan keperluan untuk mengurus sejarah perbualan dan menambahkan akses kepada alat yang dihoskan oleh OpenAI seperti Code Interpreter dan File Search. API ini juga menyokong panggilan fungsi yang dipertingkat untuk alat pihak ketiga.

Bolehkah saya masih menggunakan Assistants API v1 beta?

Tidak. Mulai 18 Disember 2024, pengguna tidak lagi mempunyai akses kepada versi v1 bagi Assistants API beta. Pada masa ini, kami hanya menyokong v2. Sila rujuk panduan migrasi ini untuk menukar panggilan API anda daripada v1 kepada v2

Bagaimanakah saya boleh mengaksesnya?

Assistants API tersedia kepada sesiapa sahaja yang mempunyai akaun OpenAI API, tetapi ia telah dinyahgalakkan dan akan dikeluarkan pada Ogos 2026. Untuk projek baharu, gunakan Responses API sebagai ganti. Jika anda sudah menggunakan Assistants API, rancang migrasi anda ke Responses API. Anda masih boleh mengakses assistant sedia ada dalam Assistants Playground selagi API ini masih tersedia.

Apakah itu Assistant?

Assistant mewakili AI yang dibina untuk tujuan khusus, menggunakan model OpenAI dan boleh mengakses fail, mengekalkan thread berterusan serta memanggil tools.

Apakah itu Thread?

Thread ialah sesi perbualan antara assistant dengan pengguna. Thread memudahkan pembangunan aplikasi dengan menyimpan sejarah mesej dan memendekkannya apabila perbualan menjadi terlalu panjang untuk panjang konteks model.

Apakah itu alat File Search?

Alat `file_search` melaksanakan beberapa amalan terbaik pemerolehan semula secara sedia guna untuk membantu anda mengekstrak data yang betul daripada fail anda bagi memperkayakan respons model. Untuk maklumat lanjut, sila baca dokumentasi pembangun kami.

Secara lalai, alat file_search menggunakan tetapan berikut:

• Saiz chunk: 800 token

• Pertindihan chunk: 400 token

• Model pembenaman: `text-embedding-3-large` pada 256 dimensi

• Bilangan maksimum chunk yang ditambahkan pada konteks: 20

Apakah sekatan untuk muat naik Fail?

Sekatan untuk memuat naik Fail adalah:

• 512 MB bagi setiap fail

• 5 juta token bagi setiap fail

• 10 ribu fail bagi setiap stor vektor

• 1 stor vektor bagi setiap assistant

• 1 stor vektor bagi setiap thread

Had storan keseluruhan bagi setiap projek dalam organisasi ialah 100 GB.

Apakah batasan alat File Search?

Kami mempunyai beberapa batasan yang diketahui dan sedang kami usahakan sokongannya dalam beberapa bulan akan datang:

1. Pada masa ini, tiada cara untuk mengubah suai tetapan pemecahan, pembenaman atau pemerolehan semula.

2. Kami tidak menyokong penghuraian imej dalam dokumen.

3. Kami tidak menyokong pemerolehan semula daripada format fail berstruktur (seperti fail .csv atau .jsonl). Lihat jenis fail yang disokong.

Apakah had kadar untuk Assistants API?

Had kadar untuk Assistants API tidak terikat pada peringkat penggunaan dan model. Sebaliknya, terdapat had lalai mengikut jenis permintaan, dengan beberapa pengecualian:

• GET: 1000 RPM

• POST: 300 RPM

• DELETE: 300 permintaan seminit

Berapakah harga Code Interpreter dalam API?

Code Interpreter berharga $0.03 / sesi. Jika pembantu anda memanggil Code Interpreter secara serentak dalam dua thread yang berbeza, ini akan mewujudkan dua sesi Code Interpreter (2 * $0.03). Setiap sesi aktif secara lalai selama satu jam, yang bermaksud anda hanya akan membayar fi ini sekali jika pengguna anda terus memberikan arahan kepada Code Interpreter dalam thread yang sama sehingga satu jam.

Berapakah harga File Search dalam API?

File Search berharga $0.10/GB storan stor vektor setiap hari (GB storan pertama adalah percuma). Saiz stor vektor adalah berdasarkan saiz terhasil stor vektor selepas fail anda dihuraikan, dipecahkan kepada chunk dan dibenamkan.

Mana-mana stor vektor yang dicipta sebelum 17 April 2024 akan percuma hingga akhir 2024, selepas itu ia akan sama ada:

• Dibilkan pada kadar semasa (pada masa ini $0.10/GB/hari) jika ia telah digunakan sekurang-kurangnya sekali dalam Run yang dicipta selepas 17 April 2024.

• Dipadamkan jika ia tidak pernah digunakan dalam mana-mana Run antara 17 April 2024 dan 31 Disember 2024 — ini bagi mengelakkan anda dibilkan untuk stor vektor yang mungkin anda cipta sebelum perubahan harga ini diumumkan tetapi tidak pernah digunakan.

Adakah terdapat had bilangan assistant yang boleh saya cipta?

Tiada had bilangan assistant yang boleh dicipta oleh sesebuah organisasi.

Adakah penstriman tersedia pada API?

Ya, penstriman tersedia pada Assistants API.

Adakah mod JSON tersedia dalam Assistants API?

Ya, mod JSON tersedia pada Assistants API melalui parameter response_format pada objek Assistants atau Run.

Adakah Assistants API juga akan mengurus permintaan untuk panggilan fungsi pihak ketiga?

Tidak. Walaupun panggilan fungsi membolehkan model memilih alat dan memformat permintaan untuk alat tersebut, pelaksanaan panggilan kepada alat pihak ketiga tidak diurus oleh OpenAI.

Bagaimanakah data yang saya hantar kepada OpenAI dikendalikan?

Seperti platform kami yang lain, data dan fail yang dihantar kepada OpenAI API tidak pernah digunakan untuk melatih model kami dan anda boleh memadamkan data anda apabila diperlukan. Data yang dimuat naik ke Assistants API disimpan tanpa had masa sehingga pengguna memadamkannya secara manual.

Adakah DALL-E tersedia melalui Assistants API?

Pada masa ini, DALL-E tidak tersedia.

Adakah terdapat UI untuk Assistants API?

Anda boleh melihat Playground untuk Assistants API. Pastikan anda berada dalam paparan Assistants pada bar sisi kiri dan menggunakan model yang serasi dengan Tools yang ingin anda hidupkan.

Apakah had aksara untuk arahan assistant dalam Assistants API?

Medan arahan assistant mempunyai panjang maksimum 256,000 aksara.

Saya mendapat ralat seperti “Pelayan mengalami ralat semasa memproses permintaan anda. Maaf tentang perkara itu! Anda boleh mencuba semula permintaan anda, atau hubungi kami melalui pusat bantuan kami di help.openai.com jika ralat berterusan. ” Apakah yang patut saya lakukan?

Jika anda mendapat ralat ini, ini mungkin bermakna prompt anda tidak disediakan dengan betul. Jika anda terus mencuba semula permintaan itu dan ia gagal, berikut beberapa perkara yang boleh dicuba:

1. pastikan anda menstruktur semula prompt anda supaya sebarang perintah seakan fungsi dianggap sebagai fungsi

2. tambahkan sebarang perintah dalam prompt anda sebagai fungsi pada tools

Mengapakah alat File Search saya tidak berfungsi dengan baik?

Apabila menggunakan alat File Search, kami mengesyorkan anda menetapkan max_prompt_tokens kepada sekurang-kurangnya 20,000. Untuk perbualan yang lebih panjang atau berbilang interaksi dengan File Search, pertimbangkan untuk meningkatkan had ini kepada 50,000, atau sebaik-baiknya, menghapuskan terus had max_prompt_tokens untuk mendapatkan hasil berkualiti tertinggi. Baca lagi di sini.

Bagaimanakah saya boleh memberikan maklum balas?

Kami sangat mengalu-alukan maklum balas anda di Forum Pembangun kami, melalui Pusat Bantuan di help.openai.com, atau di Twitter @OpenAIDevs.