Skip to main content

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​

PeringkatApa yang ejen lakukanApa yang Yabanin sediakan
1. Rancang / niatMembuka sesi, mengambil tugasanPengetagan tugasan (X-Yabanin-Task); analitik kos bagi setiap tugasan; kunci ejen (yag_*) memberi setiap ejen identiti sendiri
2. KonteksMembaca dokumen, menyoal sistem dalamanGerbang MCP: organisasi anda mendaftarkan pelayan MCP luaran; ejen memanggilnya hanya dengan geran bagi setiap ejen, parameter yang dijaga, dan jejak audit yang penuh
3. JanaMenulis kodPenghalaan model mengikut bentuk tugasan (pengelas + peringkat), rantai sandaran/failover, bajet token & perbelanjaan bagi setiap ejen
4. SahkanMenjalankan ujian, evalSuit eval luar talian (yb evaluate routing, yb evaluate guards) sebagai pintu regresi; pensampelan LLM-sebagai-hakim pada trafik pengeluaran
5. Semak / perakuanMembuka PRPengepala 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. OperasiSesi yang berjalan lamaLaporan perbelanjaan bagi setiap ejen/tugasan, perbandingan model pada trafik sebenar (penilaian bayang), amaran bajet
× DelegasiEjen menjanakan subejenKunci subejen berskop dengan geran dan bajet sendiri; aliran tr_delegate jambatan

Sehari pasukan ejen, melalui Yabanin​

  1. Pagi. Sesi ejen pengekodan bermula dengan kunci yag_. Setiap permintaan membawa tag tugasan; perbelanjaan jatuh pada tugasan, bukan pada baldi kongsi.
  2. 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.
  3. Penjanaan. Penghalaan memilih peringkat yang betul bagi setiap permintaan — model murah untuk kod rutin, premium untuk fungsi yang sukar — dalam bajet ejen.
  4. Pengesahan. Perubahan penghalaan yang pasukan hantar minggu lepas berjalan melalui yb evaluate routing dalam CI; regresi menggagalkan semakan sebelum ia sampai ke pengeluaran.
  5. Semakan. Perubahan PR dijejak kepada model dan kos melalui pengepala keputusan; atestasi garis keturunan menjawab "bidang kuasa mana yang memproses ini".
  6. 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/completions untuk completions, …/v1/models untuk menyenaraikan apa yang organisasi daftarkan).
  • Kunci — kunci API organisasi (yb_…) atau, untuk kerja ejen, kunci bagi setiap ejen (yag_…). Hantar ia sebagai Authorization: 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_… atau yag_…
  • 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 dengan YABANIN_TASK_TOKEN_BUDGET.
  • Hadkan sesi. YABANIN_TASK_TOKEN_BUDGET / YABANIN_SESSION_TOKEN_BUDGET; pada 100% gerbang memulangkan 429 yang 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.