Pertanyaan umum

Apa itu API Assistants?

API Assistants memudahkan pengembang membuat asisten AI yang andal di dalam aplikasi mereka. Dengan API ini, pengembang tidak perlu mengelola riwayat percakapan sendiri dan mendapat akses ke alat yang dihosting oleh OpenAI, seperti Penerjemah Kode dan Pencarian File. API ini juga mendukung pemanggilan fungsi yang lebih baik untuk alat pihak ketiga.

Apakah saya masih dapat menggunakan Assistants API v1 beta?

Tidak. Sejak 18 Desember 2024, pengguna tidak lagi memiliki akses ke versi v1 dari Assistant API beta. Saat ini kami hanya mendukung v2. Baca panduan migrasi ini untuk mengubah panggilan API Anda dari v1 ke v2.

Bagaimana cara mengaksesnya?

Assistants API tersedia bagi siapa pun yang memiliki akun OpenAI API, tetapi sudah dihentikan bertahap dan akan dihapus pada Agustus 2026. Untuk proyek baru, gunakan Responses API sebagai gantinya. Jika Anda sudah menggunakan Assistants API, rencanakan migrasi Anda ke Responses API. Anda masih dapat mengakses asisten yang ada di Assistants Playground selama API tetap tersedia.

Apa itu asisten?

Asisten adalah AI yang dirancang untuk tujuan tertentu, menggunakan model OpenAI, dan dapat mengakses file, menyimpan thread secara persisten, serta memanggil alat.

Apa itu thread?

Thread adalah sesi percakapan antara asisten dan pengguna. Thread mempermudah pengembangan aplikasi dengan menyimpan riwayat pesan dan memangkasnya saat percakapan melampaui panjang konteks model.

Apa itu alat Pencarian File?

Alat file_search secara otomatis menerapkan beberapa praktik terbaik pengambilan data untuk membantu Anda mengekstrak data yang tepat dari file guna memperkaya respons model.

Secara default, alat file_search menggunakan pengaturan berikut:

• Ukuran potongan: 800 token

• Tumpang tindih antarpotongan: 400 token

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

• Jumlah maksimum potongan yang ditambahkan ke konteks: 20

Apa saja batasan untuk unggahan file?

Batasan untuk mengunggah file adalah:

• 512 MB per file

• 5 juta token per file

• 10 ribu file per penyimpanan vektor

• 1 penyimpanan vektor per asisten

• 1 penyimpanan vektor per thread

Batas total penyimpanan untuk setiap proyek dalam organisasi adalah 100 GB.

Apa saja keterbatasan alat Pencarian File?

Ada beberapa keterbatasan yang telah kami ketahui dan sedang kami upayakan untuk diatasi dalam beberapa bulan mendatang:

1. Saat ini, pengaturan pemotongan teks, embedding, atau pengambilan data belum dapat diubah.

2. Kami belum mendukung penguraian gambar dalam dokumen.

3. Kami belum mendukung pengambilan data dari format file terstruktur (seperti file .csv atau .jsonl). Lihat jenis file yang didukung.

Berapa batas laju permintaan untuk API Assistants?

Batas laju permintaan untuk API Assistants tidak bergantung pada tingkat penggunaan dan model. Sebagai gantinya, berlaku batas default berdasarkan jenis permintaan, dengan beberapa pengecualian:

• GET: 1000 RPM

• POST: 300 RPM

• DELETE: 300 permintaan per menit

Berapa biaya Penerjemah Kode di API?

Penerjemah Kode dikenakan biaya $0,03 per sesi. Jika asisten Anda memanggil Penerjemah Kode secara bersamaan dalam dua thread yang berbeda, dua sesi Penerjemah Kode akan dibuat (2 × $0,03). Secara default, setiap sesi aktif selama satu jam. Artinya, Anda hanya membayar biaya ini sekali jika pengguna Anda terus memberikan instruksi kepada Penerjemah Kode dalam thread yang sama selama maksimal satu jam.

Berapa biaya Pencarian File di API?

Pencarian File dikenakan biaya $0,10/GB kapasitas penyimpanan vektor per hari (1 GB pertama gratis). Ukuran penyimpanan vektor dihitung berdasarkan ukuran akhirnya setelah file Anda diuraikan, dibagi menjadi potongan, dan diubah menjadi embedding.

Semua penyimpanan vektor yang dibuat sebelum 17 April 2024 akan gratis hingga akhir 2024. Setelah itu, penyimpanan tersebut akan:

• Dikenakan biaya sesuai tarif yang berlaku (saat ini $0,10/GB/hari) jika pernah digunakan setidaknya sekali dalam Run yang dibuat setelah 17 April 2024.

• Dihapus jika tidak pernah digunakan dalam satu pun Run antara 17 April 2024 dan 31 Desember 2024. Hal ini dilakukan agar Anda tidak dikenakan biaya untuk penyimpanan vektor yang mungkin telah Anda buat sebelum perubahan harga ini diumumkan, tetapi tidak pernah digunakan.

Apakah ada batas jumlah asisten yang dapat saya buat?

Tidak ada batas jumlah asisten yang dapat dibuat oleh sebuah organisasi.

Apakah streaming tersedia di API?

Ya, streaming tersedia di API Assistants.

Apakah mode JSON tersedia di API Assistants?

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

Apakah API Assistants juga akan mengelola permintaan pemanggilan fungsi pihak ketiga?

Tidak. Meskipun pemanggilan fungsi memungkinkan model memilih alat dan memformat permintaan untuk alat tersebut, eksekusi pemanggilan alat pihak ketiga tidak dikelola oleh OpenAI.

Bagaimana data yang saya kirim ke OpenAI ditangani?

Seperti pada bagian lain platform kami, data dan file yang dikirim ke API OpenAI tidak pernah digunakan untuk melatih model kami, dan Anda dapat menghapus data Anda kapan saja. Data yang diunggah ke API Assistants disimpan tanpa batas waktu hingga pengguna menghapusnya secara manual.

Apakah DALL-E tersedia melalui API Assistants?

Saat ini, DALL-E belum tersedia.

Apakah ada UI untuk Assistants API?

Anda dapat mencoba Playground untuk Assistants API. Pastikan Anda berada di tampilan Assistants pada bilah sisi kiri dan menggunakan model yang kompatibel dengan Tools yang ingin Anda aktifkan.

Berapa batas karakter untuk instruksi asisten di API Assistants?

Kolom instruksi asisten memiliki panjang maksimum 256.000 karakter.

Saya mendapat pesan kesalahan seperti “Server mengalami kesalahan saat memproses permintaan Anda. Mohon maaf atas kendala ini! Anda dapat mencoba mengirim ulang permintaan, atau menghubungi kami melalui pusat bantuan di help.openai.com jika kesalahan terus terjadi. ” Apa yang harus saya lakukan?

Jika Anda mendapat pesan kesalahan ini, mungkin prompt Anda belum disusun dengan benar. Jika permintaan terus gagal meski sudah Anda coba ulang, berikut beberapa hal yang bisa dicoba:

1. susun ulang prompt Anda agar setiap perintah yang menyerupai fungsi diperlakukan sebagai fungsi

2. tambahkan setiap perintah dalam prompt Anda sebagai fungsi ke tools

Mengapa alat Pencarian File saya tidak berfungsi dengan baik?

Saat menggunakan alat Pencarian File, kami menyarankan agar max_prompt_tokens diatur ke setidaknya 20.000. Untuk percakapan yang lebih panjang atau interaksi berulang dengan Pencarian File, pertimbangkan untuk menaikkan batas ini menjadi 50.000. Idealnya, hapus batas max_prompt_tokens sepenuhnya untuk mendapatkan hasil dengan kualitas terbaik.

Bagaimana cara memberikan masukan?

Kami senang menerima masukan Anda di Forum Pengembang kami, melalui Pusat Bantuan di help.openai.com, atau di Twitter @OpenAIDevs.