Kitar hayat pembangunan berasaskan ejen
Pasukan perisian semakin menghantar keluaran dengan ejen AI dalam gelung: ejen merancang, mengumpul konteks, menulis kod, menjalankan pengesahan, dan membuka PR. Yabanin ialah satah kawalan bagi kitar hayat itu — setiap panggilan model, setiap seruan alat, dan setiap dolar mengalir melalui gerbang dengan identiti, bajet, pengawal, dan jejak audit.
Halaman ini memetakan kitar hayat peringkat demi peringkat dan menyatakan dengan tepat apa yang Yabanin lakukan pada setiap langkah. Apabila sesuatu keupayaan ialah cadangan dan bukan automasi, kami nyatakan demikian — tiada apa di sini mengubah penghalaan anda secara senyap.
Kitar hayat, peringkat demi peringkat
| Peringkat | Apa yang ejen lakukan | Apa yang Yabanin sediakan |
|---|---|---|
| 1. Rancang / niat | Membuka sesi, mengambil tugasan | Pengetagan tugasan (X-Yabanin-Task); analitik kos bagi setiap tugasan; kunci ejen (yag_*) memberi setiap ejen identiti sendiri |
| 2. Konteks | Membaca dokumen, menyoal sistem dalaman | Gerbang MCP: organisasi anda mendaftarkan pelayan MCP luaran; ejen memanggilnya hanya dengan geran bagi setiap ejen, parameter yang dijaga, dan jejak audit yang penuh |
| 3. Jana | Menulis kod | Penghalaan model mengikut bentuk tugasan (pengelas + peringkat), rantai sandaran/failover, bajet token & perbelanjaan bagi setiap ejen |
| 4. Sahkan | Menjalankan ujian, eval | Suit eval luar talian (yb evaluate routing, yb evaluate guards) sebagai pintu regresi; pensampelan LLM-sebagai-hakim pada trafik pengeluaran |
| 5. Semak / perakuan | Membuka PR | Pengepala keputusan pada setiap respons (model yang mana, mengapa, berapa kosnya); atestasi garis keturunan bidang kuasa — kerja yang dihasilkan ejen boleh diaudit hujung ke hujung |
| 6. Operasi | Sesi yang berjalan lama | Laporan perbelanjaan bagi setiap ejen/tugasan, perbandingan model pada trafik sebenar (penilaian bayang), amaran bajet |
| × Delegasi | Ejen menjanakan subejen | Kunci subejen berskop dengan geran dan bajet sendiri; aliran tr_delegate jambatan |
Sehari pasukan ejen, melalui Yabanin
- Pagi. Sesi ejen pengekodan bermula dengan kunci
yag_. Setiap permintaan membawa tag tugasan; perbelanjaan jatuh pada tugasan, bukan pada baldi kongsi. - Pengumpulan konteks. Ejen memerlukan pengetahuan dalaman. Ia memanggil pelayan MCP organisasi melalui gerbang. Tiada geran — tiada panggilan. Cangkuk pengawal mengimbas parameter alat untuk rahsia sebelum apa-apa keluar.
- Penjanaan. Penghalaan memilih peringkat yang betul bagi setiap permintaan — model murah untuk kod rutin, premium untuk fungsi yang sukar — dalam bajet ejen.
- Pengesahan. Perubahan penghalaan yang pasukan hantar minggu lepas berjalan
melalui
yb evaluate routingdalam CI; regresi menggagalkan semakan sebelum ia sampai ke pengeluaran. - Semakan. Perubahan PR dijejak kepada model dan kos melalui pengepala keputusan; atestasi garis keturunan menjawab "bidang kuasa mana yang memproses ini".
- Jumaat. Skrin perbandingan model menunjukkan apa yang penilaian bayang ukur pada trafik pasukan sendiri. Manusia memutuskan sama ada untuk menukar penghalaan — Yabanin mengesyorkan, ia tidak menggunakan secara automatik.
Sambungkan ejen anda
Halakan ejen pengekodan anda ke endpoint serasi OpenAI gerbang. Satu-satunya kontrak yang gerbang dedahkan ialah URL asas ditambah kunci pembawa:
- URL asas —
http://<gateway-host>:<port>/v1(port yang sama yang gerbang dengar;…/v1/chat/completionsuntuk completions,…/v1/modelsuntuk menyenaraikan apa yang organisasi daftarkan). - Kunci — kunci API organisasi (
yb_…) atau, untuk kerja ejen, kunci bagi setiap ejen (yag_…). Hantar ia sebagaiAuthorization: Bearer <key>. - Model — namakan model (atau peringkat) yang anda mahu; gerbang menghalakannya mengikut bentuk
tugasan. Keputusan penghalaan dipulangkan pada pengepala
X-Yabanin-Decision.
Setiap alat di bawah hanyalah ejaan berbeza bagi panggilan yang satu itu. Gantikan
http://127.0.0.1:18082 dengan alamat gerbang anda dan yb_… / yag_… dengan
kunci sebenar. Ini disahkan terhadap kontrak gerbang; tiada satu pun memerlukan
stand yang sedang berjalan untuk dibaca.
OpenCode (make opencode-remote-wire melakukan ini)
make opencode-remote-wire menulis opencode.jsonc yang menghalakan ejen
yabanin (serta ejen program keluaran luna / sol-review) dan
subejennya melalui gerbang. Bentuk minimum (stand dev tempatan
make stand-opencode dibersarakan 2026-10-12):
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"yabanin": {
"npm": "@ai-sdk/openai-compatible",
"name": "Yabanin Gateway",
"options": {
"baseURL": "https://yabanin.ai/gw/v1",
"apiKey": "yb_…"
},
"models": {
"glm-5.3-flash": { "name": "GLM-5.3 Flash (preferred everywhere)" },
"glm-5.3": { "name": "GLM-5.3 (selectable)" }
}
}
},
"agent": {
"yabanin": { "model": "yabanin/glm-5.3-flash" },
"reason": { "model": "yabanin/glm-5.3-flash" },
"code": { "model": "yabanin/glm-5.3-flash" },
"complex-code": { "model": "yabanin/glm-5.3-flash" }
}
}
Nama model ialah konfigurasi pelaksanaan (registri / penghalaan organisasi anda), bukan
senarai tetap — halakan setiap ejen kepada apa sahaja yang organisasi anda daftarkan. Lihat
Integrasi OpenCode untuk kontrak penghalaan dan
sidecar pelaksana langganan tr_delegate.
Claude Code
Claude Code dikonfigurasi dengan URL asas Anthropic + kunci API. Halakannya ke
gerbang supaya trafik mengalir melaluinya (gerbang menyajikan permukaan serasi OpenAI
/v1; kunci dihantar sebagai kunci API klien):
export ANTHROPIC_BASE_URL="http://127.0.0.1:18082/v1"
export ANTHROPIC_API_KEY="yb_…" # or a yag_… agent key
claude
Sahkan nama model tepat yang organisasi anda daftarkan (GET /v1/models) — Claude
Code menghantar rentetan model yang dikonfigurasinya secara verbatim, jadi ia mesti sepadan dengan model
atau peringkat penghalaan yang didaftarkan.
Cursor (URL asas OpenAI tersuai)
Dalam Tetapan → Model tambah endpoint tersuai yang serasi OpenAI:
- URL asas:
http://127.0.0.1:18082/v1 - Kunci API:
yb_…atauyag_… - Model: nama model / peringkat yang organisasi anda daftarkan
Cursor kemudian menghantar permintaan chat/completions biasa melalui gerbang, jadi
penghalaan, bajet, dan pengepala keputusan semuanya terpakai.
Aider (serasi openai)
aider --model openai/glm-5.3 \
--openai-api-base http://127.0.0.1:18082/v1 \
--openai-api-key yb_…
--model openai/<name> menjadikan Aider menggunakan klien serasi OpenAI; URL asas
/v1 ialah apa yang gerbang sajikan.
SDK Go (chat/completions mentah)
resp, err := http.Post(
"http://127.0.0.1:18082/v1/chat/completions",
"application/json",
strings.NewReader(`{"model":"glm-5.3","messages":[{"role":"user","content":"ping"}],"max_tokens":8}`),
)
if err != nil { /* handle */ }
defer resp.Body.Close()
// The routing decision (model chosen, why, cost) is on resp.Header["X-Yabanin-Decision"].
Gunakan Authorization: Bearer <key> (tetapkan pengepala pada permintaan) dan bukannya
menanam kunci dalam badan.
SDK Node
import OpenAI from 'openai'
const client = new OpenAI({
baseURL: 'http://127.0.0.1:18082/v1',
apiKey: 'yb_…', // or a yag_… agent key
})
const res = await client.chat.completions.create({
model: 'glm-5.3',
messages: [{ role: 'user', content: 'ping' }],
max_tokens: 8,
})
// res.id and the routing decision come back on the response headers.
Mentadbir sambungan
Alat mana pun yang anda gunakan, permukaan tadbir urus ejen yang sama terpakai:
- Beri setiap ejen kuncinya sendiri (
yag_…) supaya perbelanjaan dan jejari letupan ialah bagi setiap ejen, bukan "kunci pasukan". Profil peranan ejen (Satah Kawalan → "Profil ejen") ialah templat boleh guna semula: mengeluarkan kunci pada profil mewarisi petunjuk peringkat, siling bajet harian, dan geran MCP — dan geran profil tidak sekali-kali boleh melebihi pelayan MCP yang didaftarkan untuk organisasi anda. - Tag kerja. Hantar
X-Yabanin-Task: <scope>/<task>supaya kos jatuh pada tugasan; hadkannya denganYABANIN_TASK_TOKEN_BUDGET. - Hadkan sesi.
YABANIN_TASK_TOKEN_BUDGET/YABANIN_SESSION_TOKEN_BUDGET; pada 100% gerbang memulangkan429yang klien undur padanya. - Sahkan garis keturunan.
yb lineage verify --org <org>selepas sesuatu larian.
Lihat Integrasi OpenCode untuk set penuh cadangan tadbir urus.
Sempadan gerbang
Dasar gerbang terpakai pada trafik yang dikonfigurasi sahaja. Tiga perkara kekal di luar gerbang, mengikut reka bentuk:
- Pengasingan ruang kerja — pepohon file yang ejen kerjakan ialah skop pelari, bukan gerbang.
- Semakan kod dan kelulusan keluaran — penerimaan perubahan yang dihasilkan ejen ialah proses CI/semakan anda, bukan keputusan gerbang.
- Sambungan alat dan SDK secara langsung — gerbang tidak boleh mentadbir trafik yang memintasnya. Semak laluan alat dan SDK secara berasingan.
Model mana yang sebenarnya melakukan kerja?
Semak pelaksanaan yang direkodkan, bukan hanya model yang diminta oleh klien. Keputusan sandaran atau penghalaan mungkin menukar model yang disampaikan di pertengahan laluan. Pemeriksa peneroka menunjukkan kedua-dua model yang diminta dan yang disampaikan, bersama keputusan penghalaan yang menerangkan perubahan itu.
Berapakah kos percubaan itu?
Sertakan permintaan yang gagal dan cubaan semula apabila rekod tersedia. Tunjukkan penggunaan atau harga yang tiada sebagai tidak diketahui, bukan sebagai sifar.
Apa yang sengaja tidak kami lakukan
- Tiada perubahan penghalaan yang digunakan secara automatik. Maklum balas kualiti memaparkan pengukuran dan cadangan; manusia mengesahkan perubahan dasar.
- Tiada panggilan alat yang tidak diaudit. Ejen tidak boleh mencapai sistem luaran tanpa geran, dan setiap panggilan direkodkan (parameter disunting).
- Tiada identiti kongsi. Ejen ialah prinsipal mereka sendiri — kunci, bajet, dan jejari letupan ialah bagi setiap ejen, tidak sekali-kali "kunci pasukan".
Dari mana angka itu datang
Angka perbandingan dan perbelanjaan yang ditunjukkan dalam papan pemuka diukur pada trafik anda (pertindihan penilaian bayang, log permintaan) dan diberi kapsyen dengan skop pengiraannya. Apabila metrik belum tersedia — kependaman bagi setiap model, skor kualiti — skrin menyatakannya dan bukannya mereka-reka nombor.