Politika

Politika dosyası

Politika bir YAML dosyasıdır ve her çağrıda deterministik olarak değerlendirilir. OPA/Rego gibi ayrı bir politika dili yoktur.

Tam örnek

agent: support-agent-v1

tools:
  - name: "lookup_order"
    allow: true
  - name: "issue_refund"
    allow: true
    constraints:
      amount: { max: 5000 }
    require_approval_when:
      amount: { min: 500 }
  - name: "send_email"
    allow: true
    require_approval: true
    egress_scan: true
  - name: "delete_customer"
    allow: false

defaults:
  unlisted_tools: deny
  fail_closed: true

guard_model:
  enabled: false
  provider: "typesafe"

loop_breaker:
  enabled: true
  max_identical_calls: 3

Üst düzey alanlar

Alan	Tür	Açıklama
`agent`	string	Politikanın ait olduğu ajan kimliği.
`tools`	liste	Araç kuralları (aşağıda).
`resources`	liste	İsteğe bağlı kaynak (MCP resource) kuralları: `uri_pattern` (regex ya da alt dize), `allow`, `require_approval`.
`defaults`	nesne	`unlisted_tools`, `fail_closed`, `shadow_mode`.
`mode` / `shadow_mode`	enforce \| shadow \| dry-run	Politika düzeyinde shadow.
`loop_breaker`	nesne	Döngü kırıcı ayarları.
`guard_model`	nesne	AI Guard ayarları.

Araç kuralı

Alan	Açıklama
`name`	Araç adı.
`allow`	`false` ise araç her zaman engellenir.
`constraints`	Argüman kısıtları: `min`, `max`, `enum`, `regex`. İhlal = BLOCK.
`require_approval`	`true` ise her çağrı insan onayına gider.
`require_approval_when`	Koşullu onay: argüman eşiğe ulaşırsa (`min`/`max`) onaya gider.
`egress_scan`	`false` verilmedikçe argümanlar sır/PII için taranır (varsayılan: açık).
`shadow_mode`	Yalnızca bu araç için gözlem modu.
`max_identical` / `max_consecutive`	Bu araca özel döngü eşikleri.

Varsayılanlar

Anahtar	Değer	Etki
`unlisted_tools`	`deny`	Listede olmayan araç engellenir. Önerilen.
`fail_closed`	`true`	Denetleyici hatasında risk altındaki çağrı engellenir/onaya gider.

DikkatSDK'da hiç politika verilmezse izin verici bir varsayılan kullanılır: listelenmeyen araçlara izin verilir ama egress/ingress ve loop breaker açıktır. Üretimde mutlaka açık bir politika ve unlisted_tools: deny kullanın.

Doğrulama

Panelin politika sayfası, kaydetmeden önce YAML'ı POST /api/policy/validate ile doğrular. Geçersiz politika kaydedilmez.