Integrasi OpenCode
Halaman ini menerangkan cara OpenCode (alat pengekodan ejen) berintegrasi dengan gerbang Yabanin — iaitu, kontrak sisi gerbang: ke model mana OpenCode dihalakan, cara pelaksana langganan diwakilkan, dan cara sesi yang didorong OpenCode ditadbir (bajet, penandaan tugas, cangkuk pengawal).
Pembangunan tempatan, pemasangan pelantar, dan pengendalian kelayakan diliputi dalam Panduan Pembangunan. Halaman ini tidak mengulang persediaan itu; ia mendokumentasikan permukaan integrasi itu sendiri.
Penghalaan model untuk ejen yabanin
Ejen OpenCode yabanin bercakap dengan endpoint serasi OpenAI milik gerbang
(POST /v1/chat/completions). Gerbang menghalakan setiap permintaan mengikut bentuk tugas, jadi
"model berfikir" ejen dan "pengekod pantas"nya boleh menjadi penyedia yang berbeza
di bawah satu kunci. Keputusan penghalaan didedahkan pada
pengepala respons X-Yabanin-Decision (lihat
Tadbir Urus Ejen — Pengepala keputusan) supaya
sesi boleh mencatat dalam log mengapa respons tertentu menggunakan model tertentu.
Pendawaian ejen (make opencode-remote-wire, pelantar awam di
https://yabanin.ai/gw) menghalakan ejen OpenCode melalui model gerbang Yabanin
dan laluan mengikut bentuk tugas:
| Laluan | Model | Digunakan untuk |
|---|---|---|
Ejen utama yabanin | model perancangan yang dikonfigurasi | Memimpin sesi, perancangan, penaakulan kompleks. |
Subejen reason | model analisis yang dikonfigurasi | Analisis mendalam, seni bina, tolak ansur, sintesis penyelidikan. |
Subejen code | pengekod tempatan yang dikonfigurasi | Suntingan kod yang jelas dan ditentukan dengan baik — templat, ujian, dokumen, pemfaktoran semula yang dipacu arahan. |
Subejen complex-code | model flash yang dikonfigurasi (dengan sandaran) | Penjanaan kod algoritma yang berat. |
Nama model yang konkrit ialah konfigurasi pelaksanaan (tetapan registri / penghalaan organisasi), bukan sebahagian daripada kontrak gerbang. Apa yang kontrak jamin: permintaan dihalakan secara deterministik mengikut kelas, keputusan dilog, dan perakaunan cache / kos / peringkat semuanya terpakai tepat seperti bagi mana-mana klien kunci API.
Pewakilan langganan (tr_delegate)
Untuk tugas pengekodan yang sukar, OpenCode boleh mewakilkan kepada pelaksana langganan Codex atau Cursor
melalui alat MCP tempatan tr_delegate:
tr_delegate { mode: "analyze" | "implement", task: "…", provider?: "auto" | "codex" | "cursor" }analyzeialah semakan baca sahaja;implementmenulis ke ruang kerja.provider: automemilih pelaksana yang tersedia;codex/cursormemaksa satu.tr_delegation_statusmelaporkan sama ada setiap pelaksana dikonfigurasi (ia tidak memulangkan kelayakan).
Pewakilan dimatikan secara lalai dan didayakan dengan
YABANIN_DELEGATION_ENABLED=true. Kelayakan kekal pada mesin (Codex daripada
~/.codex/auth.json, Cursor daripada agent login rasmi); gerbang tidak sekali-kali
melihatnya. Pewakilan ialah hal sidecar (services/subscription-bridge/);
gerbang hanya mengendalikan trafik sembang/alat yang serasi dengan OpenAI.
Wakilkan hanya apabila laluan dalam ejen di atas tidak mencukupi — model utama sepatutnya menggunakan alat natifnya untuk kerja biasa.
Mentadbir sesi OpenCode
Oleh kerana sesi yang didorong OpenCode hanyalah klien gerbang, permukaan tadbir urus ejen yang penuh terpakai. Cadangan praktikal:
- Tag tugas pada setiap unit kerja logik. Hantar
X-Yabanin-Taskbagi setiap tugas (contohnyastand-opencode/feature-42). Ini menjadikan perbelanjaan sesi boleh diatribusi dalam CTOR / analitik tugas dan membolehkan anda mengehadkannya denganYABANIN_TASK_TOKEN_BUDGET. - Hadkan sesi yang lari. Tetapkan
YABANIN_TASK_TOKEN_BUDGET(disyorkan 500000) dan/atauYABANIN_SESSION_TOKEN_BUDGET(disyorkan 200000). Pada ≥80% gerbang menetapkanX-Yabanin-Budget-Warning; pada 100% ia memulangkan 429 supaya klien boleh undur. - Halakan kerja murah ke waktu murah. Dayakan
YABANIN_TIME_ROUTINGdenganYABANIN_TIME_CHEAP_WINDOW(lalai22:00-07:00); kerja kelompok (X-Yabanin-Batch: true) sentiasa diturunkan, kerja interaktif boleh menarik diri denganX-Yabanin-Priority: high. - Saring keluar. Untuk sesi yang mungkin mengeluarkan data sensitif, jalankan
YABANIN_GUARD_MODE=log(perhati) dan ketatkan kepadaredact/denyselepas profil positif palsu diketahui. Lihat kaveat FP cangkuk pengawal. - Sahkan garis keturunan. Selepas larian,
yb lineage verify --org <org>mengesahkan rantai pengesahan per permintaan adalah utuh, danyb lineage export … --s3 … --lock-compliancemenghasilkan salinan bukti WORM. Lihat Garis keturunan — rantai hash + eksport.
Penilaian sebelum menghantar perubahan penghalaan
Oleh kerana trafik OpenCode ialah beban sebenar pada penghala, uji regresi penghalaan dan perubahan pengawal dengan suit luar talian sebelum ia sampai ke pelantar:
make evaluate-routing
make evaluate-guards
Lihat Suit Penilaian.