OpenBot Tidak Bisa Terhubung ke APIYI? 3 Variabel Lingkungan, Rekan Kerja AI Menyalakan Komputer Sendiri

Catatan penulis: OpenBot tidak punya antarmuka untuk “memilih model”. Model dikonfigurasi di .env dan model.yaml dalam paket tenant. Artikel ini menjelaskan cara menghubungkannya ke APIYI dengan mengubah tiga baris variabel lingkungan dan satu baris YAML. Setelah itu, kita hanya mengizinkan 3 alat komputer terlebih dahulu, lalu melakukan pengujian dengan “membuka halaman web + membaca file + memeriksa audit”.

Kamu sudah mengkloning OpenBot dari CopilotKit, membuka .env.example, dan mencari ke sana kemari di halaman depan, tetapi tetap tidak menemukan menu pilihan “penyedia model”. Kamu tidak punya kartu untuk layanan resmi OpenAI dan hanya ingin memakai APIYI dengan sistem bayar sesuai pemakaian untuk menjalankan claude-opus-5-5, tetapi bahkan belum tahu di mana modelnya dikonfigurasi.

Kesimpulannya: OpenBot tidak punya tombol “pilih model”. Model dikonfigurasi di .env dan model.yaml dalam paket tenant. Untuk menghubungkan APIYI, kamu tidak perlu mengubah kode. Cukup ubah tiga baris variabel lingkungan dan satu baris YAML. Setelah itu, izinkan hanya 3 alat komputer terlebih dahulu. Jika pengujian berhasil, buka akses lainnya sesuai kebutuhan.

Ini bukan tutorial “sekali klik langsung jalan”. OpenBot sendiri adalah template yang membutuhkan Docker, Bun 1.4+, sebuah proyek CopilotKit Intelligence, dan satu kunci model agar bisa berjalan. Semua prasyarat ini akan dijelaskan dalam artikel. Selain itu, ada dua proyek bernama OpenBot di GitHub; yang dibahas di sini adalah milik CopilotKit.

Manfaat utama: Setelah membaca artikel ini, kamu bisa mengatur tiga bagian konfigurasi dengan benar, memulai dengan 3 alat, lalu melakukan pengujian “membuka halaman web + membaca file + memeriksa audit”. Ada juga tabel pemecahan masalah untuk kasus umum seperti error 400, 401, model tidak ditemukan, alat tidak dipanggil, dan proses startup ditolak.

Model OpenBot tidak dikonfigurasi di antarmuka

OpenBot adalah templat, bukan produk

CopilotKit/OpenBot adalah repositori sumber terbuka berlisensi MIT yang dibuat pada 17 Agustus 2026. Hingga 2 November 2026, repositori ini memiliki 9.561 star. Release resmi terbarunya adalah v0.2.0 (12 Oktober 2026), dan bagian atas README masih mencantumkan label Beta. Slogannya adalah memberi setiap rekan kerja AI—disebut Bot di repositori—komputer sendiri, lengkap dengan browser sungguhan, sesi login, file, dan beberapa alat yang diberikan kepadanya.

README menyatakannya dengan jelas: ini adalah “templat, bukan produk”. Tidak ada versi terkelola yang bisa didaftarkan, dan OpenBot juga tidak dirilis sebagai paket dependensi. Cara penggunaannya adalah meng-clone repositori, mengganti paket contoh tenant di bawah examples/ dengan rekan kerja, channel, dan skill milik Anda sendiri, lalu menjalankannya. Jadi, jawaban untuk pertanyaan “di mana memilih model?” ada di file konfigurasi, bukan di antarmuka.

Empat prasyarat untuk menjalankan OpenBot

Tabel berikut mencantumkan hal-hal yang perlu disiapkan sebelum menghubungkan model. Jika salah satunya belum tersedia, konfigurasi selanjutnya tidak bisa diverifikasi.

Prasyarat	Kebutuhan	Keterangan
Docker	Menjalankan PostgreSQL (termasuk pgvector) dan Bot bawaan	`scripts/start.sh` akan menjalankan layanan Docker dan migrasi
Bun	Versi 1.4 atau lebih baru	Instal dependensi dengan `bun install`
CopilotKit Intelligence	Satu proyek dan lisensi; tersedia paket gratis	Lingkungan evaluasi lokal menggunakan macOS + Docker Desktop. Lisensi lokal berlaku selama 30 hari dan dapat diperpanjang dengan `npx copilotkit@latest local renew`
Kunci model	Kunci untuk endpoint yang kompatibel dengan OpenAI	Artikel ini menggunakan token APIYI, dengan base_url `https://api.apiyi.com/v1`

Intelligence adalah prasyarat yang paling mudah terlewat. Komentar di .env.example menjelaskan bahwa server akan langsung menolak untuk berjalan jika URL Intelligence, URL gateway, atau kuncinya tidak tersedia. Teks aslinya berbunyi “There is no degraded mode.” Artinya, tidak ada mode dengan fungsi terbatas. Alasannya, Intelligence menyimpan thread persisten dan memori; tanpanya, konteks akan hilang pada setiap percakapan. Jadi, OpenBot tidak bisa disebut sebagai solusi yang “sepenuhnya offline”.

OPENAI_BASE_URL mengubah seluruh deployment

README menyebutkan “no model ships in the box”: model tidak disertakan dalam paket. Kredensial disediakan oleh administrator, dienkripsi sebelum disimpan ke database, dan tidak masuk ke log. Model ditentukan oleh variabel lingkungan pada tingkat deployment. Yang paling penting adalah OPENAI_BASE_URL. Menurut definisi resminya, variabel ini dapat menunjuk ke endpoint apa pun yang menggunakan API yang sama, termasuk gateway multipenyedia, proksi, atau model yang berjalan di perangkat keras Anda sendiri. Komentar di .env.example lebih spesifik: endpoint apa pun yang mendukung /v1/chat/completions dapat digunakan.

Variabel ini berlaku untuk seluruh deployment, bukan hanya satu Bot. Ada tiga komponen yang membacanya: klien API server untuk agent bawaan, agent-bot yang membuat kliennya sendiri, dan agent-langgraph dengan BOT_PROVIDER=openai. Menurut dokumentasi resmi, keuntungannya adalah dalam satu deployment tidak akan terjadi sebagian permintaan menuju alamat baru sementara sisanya masih menuju alamat lama.

Tiga perubahan untuk menghubungkan APIYI: konfigurasi variabel lingkungan OpenBot

Titik integrasi OpenBot dan APIYI

APIYI menyediakan antarmuka yang kompatibel dengan OpenAI. Isi base_url dengan https://api.apiyi.com/v1 agar permintaan dikirim melalui /v1/chat/completions, sesuai dengan kebutuhan OPENAI_BASE_URL di OpenBot. Perlu diperhatikan juga: OpenBot meneruskan nama model persis seperti yang dimasukkan (verbatim), sedangkan /v1/models APIYI mengembalikan nama tanpa prefiks, yaitu claude-opus-5-5. Jadi, jangan tambahkan prefiks openai/ seperti pada contoh gateway resmi. Contoh resmi openai/gpt-5.6-terra hanya berlaku untuk endpoint yang menambahkan namespace pada nama model.

Lihat tabel ringkas berikut, lalu ikuti langkah-langkahnya.

Yang diubah	Nilai baru	Alasannya
`OPENAI_API_KEY` di `.env`	Token `sk-...` yang dibuat di konsol APIYI	Agent bawaan dan kedua Bot bawaan menggunakan kunci ini secara default
`OPENAI_BASE_URL` di `.env`	`https://api.apiyi.com/v1`	Mengarahkan permintaan model dari seluruh deployment ke endpoint kompatibel APIYI
`BOT_MODEL` di `.env`	`claude-opus-5-5`	Menentukan model untuk Bot yang dijalankan; jika tidak diisi, nilainya diambil dari file spesifikasi provider
`default_model` di `examples/<paket-Anda>/model.yaml`	`claude-opus-5-5`	Paket contoh saat ini menggunakan `gpt-5.6-terra`; jika tidak diubah, akan muncul kesalahan model tidak ditemukan
`BOT_RESPONSES_API` di `.env`	Tetap `false`	Claude akan mengembalikan respons 400 pada endpoint Responses APIYI

Langkah pertama: Siapkan token khusus

Di halaman token APIYI api.apiyi.com/token, buat key baru. Atur batas saldo dan masa berlakunya, lalu tuliskan tujuan penggunaan sebagai “Evaluasi OpenBot di mesin lokal”.
Di mesin lokal, gunakan curl untuk mengirim GET https://api.apiyi.com/v1/models dengan header Authorization: Bearer sk-....

Kriteria keberhasilan: Respons mengembalikan HTTP 200 dan daftar model mencakup claude-opus-5-5. Saat kami menguji langkah ini pada 2026-11-02, ada 259 model dalam daftar, termasuk claude-opus-5-5 dan claude-opus-5-5-thinking.

Token terpisah membantu membedakan penggunaan khusus mesin ini dari penggunaan produksi. Pada tahap templat, Bot akan berulang kali mencoba dan memperbaiki kesalahan. Adanya batas saldo membuat penggunaan lebih terkendali.

Langkah kedua: Ubah tiga baris di .env

Ikuti panduan mulai cepat resmi: jalankan cp .env.example .env dan bun install. Selanjutnya, jalankan npx --yes copilotkit@latest login, npx --yes copilotkit@latest project select, dan bun scripts/setup-learning.ts secara berurutan untuk memasukkan runtime key dan Learning container ke .env. Lalu ubah tiga baris berikut:

OPENAI_API_KEY=sk-token-APIYI-Anda
OPENAI_BASE_URL=https://api.apiyi.com/v1
BOT_MODEL=claude-opus-5-5

Periksa juga empat hal: biarkan BOT_PROVIDER pada nilai default openai; biarkan BOT_RESPONSES_API pada false; buat KEY_ENCRYPTION_KEY dengan openssl rand -base64 32; dan perhatikan bahwa AGENT_BOT_MODEL hanya digunakan oleh agent-bot untuk pembuktian konsep. Nilai default-nya adalah gpt-5.5 dan tidak saling memengaruhi dengan BOT_MODEL. Jika Anda juga ingin menjalankan agent-bot, pastikan nama model tersebut ada di /v1/models, atau ubah ke model yang ingin digunakan.

Kriteria keberhasilan: Output grep OPENAI_ .env menunjukkan key dan alamat yang benar. Alamat harus diakhiri /v1, tanpa garis miring atau spasi tambahan. Jika akses ke endpoint yang sama dari dalam container memerlukan rute berbeda, gunakan OPENAI_CONTAINER_BASE_URL untuk menggantinya. Namun, alamat APIYI dapat diakses secara publik, jadi variabel ini biasanya tidak diperlukan.

Langkah ketiga: Ubah satu baris model.yaml di paket tenant

Buka examples/fintech/model.yaml atau paket tenant yang sudah kamu salin. Saat ini isinya adalah model.provider: openai, model.credential_secret_ref: openai-api-key, dan model.default_model: gpt-5.6-terra.

Ubah default_model menjadi claude-opus-5-5.
Biarkan provider tetap openai. Secara resmi, bagian ini hanya menerima openai atau anthropic. Karena kita menggunakan endpoint kompatibel OpenAI dari APIYI, pilih openai.
Jangan ganti credential_secret_ref dengan kunci dalam teks biasa. Nilai ini merujuk ke kredensial yang sudah tersimpan.

Kriteria keberhasilan: Setelah menjalankan bash scripts/start.sh, semua pemeriksaan kesehatan lolos dan kamu bisa melihat dua asisten bawaan, General Assistant dan Knowledge, saat membuka http://localhost:3010.

Ada satu hal yang perlu diperhatikan. Biasanya, saat server dimulai, server akan memeriksa ke OpenAI atau Anthropic apakah kunci tersebut bisa memanggil default_model. Jika tidak bisa, server akan menampilkan model-unavailable atau model-credential-rejected. Namun, pemeriksaan ini dilewati jika OPENAI_BASE_URL disetel. Jadi, saat menggunakan APIYI, kesalahan penulisan nama model tidak akan terdeteksi saat startup, melainkan baru terlihat setelah pesan pertama dikirim. Startup yang berhasil hanya menunjukkan bahwa layanan sudah berjalan, bukan berarti konfigurasi model sudah benar.

Tentang versi: perbedaan v0.2.0 dan branch main

Hal ini perlu diperjelas. Di bagian Unreleased pada CHANGELOG branch main, ada satu perubahan: jika model openai/... pada Bot bawaan menggunakan OPENAI_BASE_URL yang “bukan OpenAI maupun Azure”, model akan memanggil /chat/completions pada endpoint tersebut, bukan lagi Responses API. Menurut penjelasan resmi, sebagian besar endpoint yang kompatibel dengan OpenAI hanya menyediakan Chat Completions. Perubahan yang sama juga menambahkan COPILOTKIT_OPENAI_API=responses|chat untuk memaksa pilihan salah satu API.

Perubahan ini belum masuk ke tag resmi v0.2.0. Jika Anda menggunakan v0.2.0, Bot bawaan mungkin masih memanggil Responses saat menggunakan base URL pihak ketiga. Berdasarkan pengujian kami di bawah, ini kemungkinan besar menjadi sumber error 400. Ada dua pilihan: lakukan evaluasi menggunakan branch main dengan memahami bahwa branch ini masih terus berubah, atau tunggu sampai perubahan ini resmi dirilis sebelum melakukan integrasi.

🚀 Mulai cepat: Sebelum mengutak-atik OpenBot, sebaiknya uji dulu /v1/chat/completions secara terpisah menggunakan token APIYI apiyi.com. Sertakan satu definisi fungsi dan pastikan finish_reason mengembalikan tool_calls. Setelah sisi API dipastikan berfungsi, Anda hanya perlu memeriksa konfigurasi OpenBot saat melakukan troubleshooting.

Mulai dengan mengizinkan 3 tool saja: batasi izin OpenBot

Mengapa OpenBot tidak sebaiknya membuka semua tool sejak awal

Dokumentasi resmi menyatakan: “A model picks the right tool reliably out of about ten, and unreliably out of thirty.” Artinya, model bisa memilih tool yang tepat secara konsisten dari sekitar sepuluh tool, tetapi pilihannya mulai tidak andal ketika jumlahnya mencapai tiga puluh. Kode sumber OpenBot mendaftarkan tiga belas tool komputer. Jika ditambah tool di direktori MCP, jumlahnya bisa dengan mudah melampaui batas tersebut sejak hari pertama.

Bot dengan lebih dari dua belas tool hanya akan menerima tool yang dibutuhkan oleh skill yang cocok dengan pesan saat ini pada setiap eksekusi. Namun, dokumentasi resmi menegaskan bahwa ini hanya mempersempit cakupan tool yang terlihat: “It is not a boundary, and it never substitutes for one”—ini bukan batas keamanan dan tidak bisa menggantikannya. Batas yang sebenarnya terdiri dari tiga hal: izin (grant) yang diberikan per Bot di Admin, kebijakan tindakan AGENT_COMPUTER_POLICY, dan catatan audit. Perlu diingat juga bahwa konfigurasi bawaan saat mulai adalah deny: [] ditambah allow: ["true"], yang berarti semuanya diizinkan.

Daftar 3 tool untuk tahap awal

Nama tool	Fungsi	Tahap awal
`computer_navigate`	Membuka URL di browser	✅ Izinkan
`computer_snapshot`	Mengambil snapshot halaman	✅ Izinkan
`computer_read_file`	Membaca file di ruang kerja	✅ Izinkan
`computer_click` / `computer_type` / `computer_key`	Klik, mengetik, dan menekan tombol	⏸ Izinkan sesuai kebutuhan setelah pengujian
`computer_write_file`	Menulis file	⏸ Izinkan sesuai kebutuhan setelah pengujian
`computer_run_command`	Menjalankan perintah shell	⛔ Tolak secara eksplisit

computer_run_command harus diblokir secara khusus. Saat COMPUTER_SEPARATE_WORKSPACES diaktifkan di Compose, setiap Bot akan menjalankan shell di foldernya sendiri. Namun, dokumentasi resmi mengakui bahwa “Commands can still read other folders”—perintah masih bisa membaca folder lain. Untuk isolasi yang sebenarnya, diperlukan computers.mode: sandbox. Pada tahap awal, tidak perlu mengambil risiko ini.

Menulis AGENT_COMPUTER_POLICY

Kebijakan ini berupa JSON, dengan aturan yang menggunakan ekspresi CEL dan dapat membaca kolom seperti tool.name, page.host, dan file.path. Untuk memulai, tulis seperti ini:

Tambahkan satu baris di .env: AGENT_COMPUTER_POLICY={"mode":"enforce","deny":["tool.name == 'computer_run_command'"],"allow":["tool.name in ['computer_navigate','computer_snapshot','computer_read_file']"]}
Di Admin, berikan General Assistant akses ke tiga tool tersebut saja.
Mulai ulang layanan. Jika format JSON salah, server akan langsung gagal memulai, sehingga masalahnya mudah ditemukan.

Ada dua aturan evaluasi yang perlu dipahami. Pertama, deny diproses sebelum allow, jadi shell tetap diblokir meskipun nantinya aturan allow dibuat lebih luas. Kedua, mesin kebijakan menerapkan prinsip fail closed: jika kebijakan tidak ada atau kosong, tidak ada yang diizinkan; aturan deny yang salah diperlakukan sebagai penolakan; dan aturan allow yang salah tidak dianggap sebagai izin. Prinsipnya sederhana: batasi dulu, lalu buka sesuai kebutuhan. Setelah pengujian berhasil, tambahkan akses untuk klik, mengetik, atau menulis file satu per satu, dan periksa catatan audit setiap kali ada penambahan.

Pengujian dan pemecahan masalah koneksi OpenBot ke APIYI

Skenario pengujian: buka halaman web, baca file, dan periksa audit

Menurut arsitektur resmi, urutan pemanggilan alat adalah: mengurai target, mengevaluasinya berdasarkan kebijakan yang berlaku, menulis satu baris audit, lalu menjalankan tindakan di komputer. Jika tindakan yang diteruskan gagal, sistem akan menulis baris audit kedua. Komputer sendiri tidak mengambil keputusan kebijakan; batas kontrolnya ada di gateway server. Karena itu, pengujian perlu mencakup dua hal: tindakan bisa dijalankan dan tindakan tercatat.

Buat file notes.md di /workspace, lalu isi dengan dua baris teks apa saja.
Minta General Assistant membuka halaman web publik, memberi tahu judulnya, lalu membaca isi /workspace/notes.md.
Selanjutnya, minta ia menjalankan ls /. Permintaan ini seharusnya ditolak, dan jawabannya harus menyebutkan aturan yang memblokirnya.
Buka halaman Audit. Pastikan ada catatan persetujuan untuk navigate, snapshot, dan read_file, serta catatan penolakan untuk run_command. Jika perlu mengekspornya, panggil GET /api/admin/audit-events?format=csv; setiap permintaan dibatasi hingga 5.000 baris.

Untuk ketersediaan di sisi model, kami hanya melakukan pengujian langsung melalui APIYI. Pada 2026-11-02, kami memanggil /v1/chat/completions menggunakan claude-opus-5-5 dengan definisi fungsi read_file. Hasilnya adalah HTTP 200 dalam 4,06 detik, dengan finish_reason bernilai tool_calls dan parameter {"path":"/workspace/notes.md"}. Penggunaan tokennya adalah 393 token prompt dan 55 token completion. Setelah menambahkan stream: true, responsnya juga 200. Nama dan parameter fungsi muncul secara bertahap dalam potongan SSE, lalu diakhiri dengan data: [DONE]. Ini menunjukkan bahwa endpoint chat APIYI dapat mengembalikan pemanggilan alat Claude dalam format OpenAI—tepat seperti yang dibutuhkan Agent, di mana model hanya menentukan fungsi yang akan dipanggil, bukan menjalankannya.

Tabel pemecahan masalah: lima kegagalan umum

Gejala	Penyebab paling mungkin	Solusi
400 `field messages is required`	Permintaan masuk ke endpoint Responses. Dalam pengujian kami, permintaan `claude-opus-5-5` ke `/v1/responses` milik APIYI menghasilkan kesalahan ini	Pastikan `BOT_RESPONSES_API=false`; jika menggunakan v0.2.0, Bot bawaan mungkin masih memanggil Responses. Coba gunakan cabang main dan atur `COPILOTKIT_OPENAI_API=chat` (masih berstatus Unreleased)
401	Kunci API salah, kedaluwarsa, atau batas saldo token sudah habis	Periksa masa berlaku dan saldo di halaman token APIYI, lalu uji ulang `/v1/models` menggunakan curl
Model tidak ada	`default_model` masih menggunakan `gpt-5.6-terra`, atau nama model diberi awalan `openai/`	Tulis nama model tanpa awalan, `claude-opus-5-5`, di kedua tempat; karena pemeriksaan saat memulai dilewati, Anda perlu mengirim pesan untuk memverifikasinya
Tool tidak dipanggil	Model tidak mendukung pemanggilan tool, grant belum diberikan, atau kebijakan memblokir tool	Menurut dokumentasi resmi, Bot tanpa kemampuan pemanggilan tool tidak dapat mengoperasikan komputer; periksa dulu apakah ada catatan penolakan dalam audit
Gagal memulai	Konfigurasi Intelligence belum lengkap, JSON kebijakan salah, atau penyedia baru ditambahkan ke provider spec tanpa memperbarui `PROVIDER_IDS`	Lengkapi tiga komponen Intelligence; validasi JSON; untuk menghubungkan APIYI, tidak perlu menambahkan penyedia baru, cukup gunakan `openai`

💡 Saran pemecahan masalah: Saat terjadi kesalahan, coba kirim permintaan yang sama langsung ke /v1/chat/completions di APIYI apiyi.com. Jika berhasil secara langsung tetapi gagal di OpenBot, masalahnya ada pada konfigurasi atau versi OpenBot. Jika gagal juga secara langsung, periksa token dan model. Dengan begitu, Anda bisa langsung mempersempit cakupan masalah.

Referensi biaya menjalankan Claude di OpenBot

APIYI menerapkan sistem bayar sesuai pemakaian tanpa biaya bulanan tetap. Berikut harga claude-opus-5-5 yang ditemukan pada 2026-11-02. Harga claude-opus-5-5-thinking sama:

Item biaya	Harga (per juta token)
Input	$4
Output	$20
Pembacaan cache	$0.2

Lihat daftar model di platform untuk informasi model dan harga terbaru. Jika dihitung dari permintaan dengan tool yang kami uji, 393 token input dan 55 token output menghasilkan biaya yang sangat kecil per permintaan. Namun, begitu Bot mulai menjelajah dan membaca file dalam beberapa putaran, konteks akan cepat membesar. Sebaiknya tetapkan juga batas saldo token.

Pertanyaan umum

Q1: Apakah perlu mengubah kode sumber untuk menghubungkan OpenBot ke APIYI?

Tidak perlu. Cukup ubah tiga baris di `.env`: `OPENAI_API_KEY`, `OPENAI_BASE_URL`, dan `BOT_MODEL`, lalu ubah `default_model` di `model.yaml` paket tenant. Perubahan provider spec dan `PROVIDER_IDS` hanya diperlukan saat menambahkan jenis penyedia yang benar-benar baru. APIYI menggunakan antarmuka yang kompatibel dengan OpenAI, jadi tidak termasuk dalam kasus tersebut.

Q2: Mengapa tidak menggunakan nama dengan prefiks seperti openai/claude-opus-5-5?

OpenBot meneruskan nama model apa adanya, jadi gunakan nama yang dipublikasikan oleh endpoint. `/v1/models` di APIYI apiyi.com mencantumkan nama tanpa prefiks, yaitu `claude-opus-5-5`. Jika prefiks ditambahkan, model justru tidak akan ditemukan.

Q3: Bisakah BOT_RESPONSES_API diaktifkan untuk menggunakan Responses API?

Jangan aktifkan saat menggunakan Claude. Dalam pengujian kami, permintaan `claude-opus-5-5` ke `/v1/responses` APIYI mengembalikan status 400 `field messages is required`, sedangkan `gpt-5.4-mini` mengembalikan status 200. Dokumentasi resmi juga menyatakan bahwa opsi ini hanya boleh diaktifkan jika endpoint benar-benar mendukung Responses API.

Q4: Apakah kalian sudah berhasil menjalankan seluruh rangkaian OpenBot?

Belum. Kami hanya memverifikasi sisi APIYI: daftar model, pemanggilan chat dengan tool, output streaming, dan error pada endpoint Responses. Seluruh rangkaian OpenBot (Docker dan proyek Intelligence) belum dijalankan di mesin yang digunakan untuk menulis artikel ini. Bagian yang membahas perilaku internal OpenBot mengacu pada repositori dan dokumentasi resminya.

Q5: Bagaimana mencegah Bot menghabiskan saldo kunci dengan sistem bayar sesuai pemakaian?

Di halaman token APIYI apiyi.com, tetapkan batas saldo dan masa berlaku untuk kunci tersebut, lalu kelola secara terpisah dari kunci produksi. Kombinasikan dengan strategi tiga tool dalam artikel ini agar kemampuan Bot dan biaya yang dapat dikeluarkannya sama-sama memiliki batas.

Kesimpulan

Poin Utama Menghubungkan OpenBot ke APIYI

Model tidak dikonfigurasi di antarmuka: konfigurasinya ada di tiga baris .env dan satu baris model.yaml dalam paket tenant.
base_url berlaku untuk seluruh deployment: begitu OPENAI_BASE_URL diubah, ketiga jenis Bot ikut beralih.
Berhasil memulai bukan berarti model sudah benar: setelah terhubung ke gateway, pemeriksaan dilewati. Kirim pesan pertama untuk memastikannya.
Perhatikan versinya: perubahan ke /chat/completions masih berstatus Unreleased di branch main dan belum masuk ke v0.2.0.
Mulai dengan hanya 3 alat: deny diproses sebelum allow, shell ditolak secara terpisah. Batasi dulu, lalu longgarkan secara bertahap.
Mulai dengan APIYI sesuai pemakaian: gunakan token khusus dengan batas saldo, dan tulis claude-opus-5-5 tanpa prefiks.

Konfigurasi model OpenBot sulit ditemukan karena memang tidak ada di antarmuka. Atur tiga bagian ini dengan benar: tiga baris di .env, satu baris di model.yaml, dan biarkan Responses tetap nonaktif. Lalu mulai dengan kebijakan yang hanya mengizinkan 3 alat agar seluruh alurnya lebih mudah dipahami. Saat memeriksa hasilnya, cukup pastikan tiga hal: halaman web bisa dibuka, file bisa dibaca, dan tindakan yang ditolak tercatat dalam log audit.

Sebaiknya uji chat dan pemanggilan alat terlebih dahulu menggunakan token khusus APIYI di apiyi.com, baru hubungkan ke OpenBot. Dengan begitu, jika terjadi masalah, Anda bisa lebih cepat mengetahui sumbernya.

📚 Referensi

Repositori CopilotKit/OpenBot: README, persyaratan, dan panduan mulai cepat
Tautan: github.com/CopilotKit/OpenBot
Keterangan: kegunaan template, prasyarat, dan informasi rilis v0.2.0
Dokumentasi konfigurasi OpenBot: variabel lingkungan model, model.yaml, dan validasi saat memulai
Tautan: github.com/CopilotKit/OpenBot/blob/main/docs/configuration.md
Keterangan: definisi asli OPENAI_BASE_URL, BOT_MODEL, dan BOT_RESPONSES_API
Dokumentasi arsitektur OpenBot: gateway, kebijakan, dan audit
Tautan: github.com/CopilotKit/OpenBot/blob/main/docs/architecture.md
Keterangan: urutan pemanggilan alat dan antarmuka ekspor audit
Pusat dokumentasi APIYI: mode kompatibel OpenAI, pemanggilan fungsi, dan daftar model
Tautan: docs.apiyi.com
Keterangan: format base_url, format tools, dan harga claude-opus-5-5

Penulis: Tim Teknis APIYI
Diskusi teknis: Hubungi kami melalui situs resmi APIYI di apiyi.com. Informasi integrasi lainnya tersedia di pusat dokumentasi docs.apiyi.com

OpenBot Tidak Bisa Terhubung ke APIYI? 3 Variabel Lingkungan, Rekan Kerja AI Menyalakan Komputer Sendiri