Dasar Alat
Dasar alat ialah peraturan per organisasi yang memutuskan panggilan alat yang boleh
dilakukan oleh ejen anda. Satu peraturan mengikat subjek (id kunci ejen, atau * = setiap ejen
organisasi) kepada corak alat dan tindakan (allow / deny).
Organisasi tanpa dasar membenarkan segala-galanya — pendawaian tidak mengenakan sekatan, tingkah laku hanya berubah apabila pengendali mentakrifkan peraturan.
Di mana dasar terpakai
| Permukaan | Kesan |
|---|---|
Panggilan MCP (/api/mcp/invoke) | nama alat mentah disemak sebelum proxy menghantar keluar; nafi → 403 policy_denied |
Hantaran A2A (/api/a2a/send) | nama alat a2a:<agent> disemak dengan cara yang sama |
Pelaksana terbina dalam (yabanin:web_fetch, …) | disemak sebagai yabanin:<tool> sebelum pelaksanaan |
Respons model (/v1/chat/completions, JSON dan SSE) | tool_calls yang model isytiharkan disemak sebelum klien melihatnya: panggilan yang dinafikan dibuang, dan pilihan yang setiap panggilannya dinafikan tamat dengan stop dan bukannya tool_calls — pelaksana sisi klien tidak sekali-kali menerimanya |
Panggilan yang dinafikan dikira bagi setiap organisasi dan alat dalam
metrik gateway_tool_policy_denied_total — permukaan penjejakan untuk keputusan
dasar (respons itu sendiri tidak lagi mengandungi panggilan yang dinafikan).
Tertib penilaian
Padanan paling khusus menang:
- nama alat tepat > awalan kad liar yang lebih panjang > kad liar yang lebih pendek >
* - subjek khusus ejen mengalahkan
* - nombor
priorityyang lebih rendah (0–1000, lalai 100) - tertib nama yang stabil
Kad liar ialah bintang di hujung sahaja (web_*, mcp:github:*); bintang di
bahagian dalam ditolak. Jadi deny web_* + allow web_search bergabung, dan
pengecualian per ejen mengalahkan nafi seluruh organisasi.
Pelaksanaan sisi pelayan (alat terbina dalam)
Pelayan MCP maya yabanin menjalankan alat dalam proses gerbang, jadi
keluar berlaku daripada kedudukan rangkaian dan bidang kuasa gerbang — bukan
daripada mesin pembangun:
POST /api/mcp/invoke {"server":"yabanin","tool":"web_fetch","params":{"url":"https://example.com/doc"}}
Katalog terbina dalam
| Alat | Nama dasar berkesan | Apa yang dilakukannya |
|---|---|---|
web_fetch | yabanin:web_fetch | HTTP GET satu URL; kandungan seperti teks sahaja, had 2 MiB |
http_request | yabanin:http_<method> | Kaedah HTTP arbitrari (get/post/put/patch/delete) dengan badan JSON — nama dasar bergabung dengan kaedah, jadi network-readonly menafikan yabanin:http_post secara semula jadi |
http_head | yabanin:http_head | Permintaan HEAD: pengepala respons (pengepala kelayakan dibuang) tanpa badan |
dns_lookup | yabanin:dns_lookup | Selesaikan nama hos kepada rekod A/AAAA daripada penyelesai gerbang |
time_now | yabanin:time_now | Masa gerbang semasa (RFC3339 UTC + epoch); tiada keluar |
Penemuan (prinsipal ejen sahaja; alat yang dinafikan oleh dasar organisasi disembunyikan daripada katalog):
GET /api/mcp/yabanin/tools
Semua alat dail keluar berkongsi senarai benarkan SSRF pelaksanaan + semakan
IP terpelihara (satu permukaan dail keluar dengan registri MCP) dan menjalankan cangkuk
pengawal pra-keluar pada parameter mereka; setiap pelaksanaan mendarat pada jejak audit
standard sebagai mcp:yabanin:<tool> dengan atribusi ejen/tugas.
Praset pemula
Digunakan daripada konsol pentadbir (skrin Dasar Alat) atau API; praset mencipta baris boleh sunting — ia adalah templat, bukan tingkah laku tersembunyi, dan penggunaan dua kali melangkau baris sedia ada:
- network-off — nafi alat yang kelihatan seperti rangkaian keluar bagi setiap ejen (keluarga web fetch/browse/http, termasuk pelaksana sisi pelayan)
- network-readonly — benarkan alat rangkaian berbentuk baca, nafi nama berbentuk tulis
(
http_post,post_*,send_*, …) - internal-only — nafi segala-galanya kecuali
yabanin:web_fetch(semua keluar melalui titik terkawal)
Corak praset ialah usaha terbaik yang jujur terhadap nama alat biasa; ia bukan lengkap — semak dan kembangkan untuk tindanan anda.
API pentadbir (root sahaja, berskop organisasi)
| Kaedah | Laluan |
|---|---|
| POST | /api/organizations/{id}/tool-policies |
| GET | /api/organizations/{id}/tool-policies |
| GET | /api/organizations/{id}/tool-policies/{name} |
| PATCH | /api/organizations/{id}/tool-policies/{name} |
| DELETE | /api/organizations/{id}/tool-policies/{name} |
| GET | /api/organizations/{id}/tool-policies/presets |
| POST | /api/organizations/{id}/tool-policies/presets/{preset} |
Keputusan enjin disimpan dalam cache bagi setiap organisasi selama 5 saat; setiap mutasi CRUD membuang cache serta-merta.
Ditangguhkan (bukan matlamat v1 yang didokumentasikan)
- Aliran kerja kelulusan (nafi / benarkan / tanya-pentadbir dengan baris gilir
menunggu) — lajur
actionskema menjangkakannya, enjin dan UI hanya menyertakan allow/deny. - Kelas alat di luar corak nama (anotasi readOnly/destructive), pemadanan alat semantik, kuota per alat.