Skip to main content

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​

PermukaanKesan
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:

  1. nama alat tepat > awalan kad liar yang lebih panjang > kad liar yang lebih pendek > *
  2. subjek khusus ejen mengalahkan *
  3. nombor priority yang lebih rendah (0–1000, lalai 100)
  4. 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​

AlatNama dasar berkesanApa yang dilakukannya
web_fetchyabanin:web_fetchHTTP GET satu URL; kandungan seperti teks sahaja, had 2 MiB
http_requestyabanin: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_headyabanin:http_headPermintaan HEAD: pengepala respons (pengepala kelayakan dibuang) tanpa badan
dns_lookupyabanin:dns_lookupSelesaikan nama hos kepada rekod A/AAAA daripada penyelesai gerbang
time_nowyabanin:time_nowMasa 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)​

KaedahLaluan
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 action skema menjangkakannya, enjin dan UI hanya menyertakan allow/deny.
  • Kelas alat di luar corak nama (anotasi readOnly/destructive), pemadanan alat semantik, kuota per alat.