Policy group
Satu bundel konfigurasi guardrail yang dapat dipakai ulang, terpasang ke kunci API Anda — dengan override per-kunci dan bypass master untuk beban kerja yang sepenuhnya tepercaya.
Satu bundel konfigurasi guardrail
Policy group adalah bundel bernama berisi pengaturan guardrail. Setiap kunci API ditetapkan ke sebuah policy group, dan grup Default otomatis dibuat untuk setiap akun. Alih-alih mengonfigurasi guardrail per kunci, Anda mengonfigurasi grup sekali dan mengarahkan banyak kunci ke grup itu. Sebuah policy group menyimpan:
- ambang injeksi (sensitivitas model injeksi input; hanya menentukan blokir jika pemblokiran injection aktif);
- konfigurasi mode PII dan moderasi konten;
- mode output DLP dan mode jailbreak / injeksi tidak langsung;
- serta aturan allow/deny tool MCP.
Pasang banyak kunci ke satu grup. Beri kunci prod grup yang ketat dan kunci dev grup yang lebih longgar, tanpa menduplikasi konfigurasi — ubah grup dan setiap kunci di dalamnya diperbarui sekaligus.
Timpa grup untuk satu kunci
Sebuah kunci API bisa membawa blob JSONB guardrail_overrides yang secara selektif menimpa grupnya untuk kunci itu saja. Hanya dua guardrail yang bisa di-override per kunci: piiEnabled dan contentModerationEnabled. Kolom yang Anda hilangkan jatuh kembali ke policy group.
Injeksi TIDAK bisa di-override. Pemeriksaan injeksi prompt tidak bisa dimatikan per kunci. injectionEnabled: false di override diabaikan.
Override per-kunci
Pengaturan mana yang menang
Ketika guardrail yang sama dikonfigurasi di lebih dari satu tempat, sumber berprioritas tertinggi yang menang:
- Dipaksa sistem (ops) — kontrol darurat tingkat platform (mis. blocklist darurat) yang selalu diutamakan, di mana pun.
- Override per-kunci — guardrail_overrides kunci (hanya PII / konten) mengalahkan policy group-nya.
- Policy group — mode dan ambang yang dikonfigurasi grup.
- Default sistem — baseline platform yang dipakai ketika tidak ada yang lain disetel.
Baca dari atas ke bawah: aturan yang lebih tinggi menimpa semua di bawahnya. Inilah kenapa blokir darurat ops tidak bisa dibatalkan oleh override pelanggan, dan override per-kunci bisa melonggarkan grupnya sendiri tetapi bukan pemeriksaan injeksi.
guardrails_enabled — bypass Path B
Setiap policy group memiliki sakelar master, guardrails_enabled, yang default-nya TRUE. Ini adalah bypass "Path B": ketika Anda MEMATIKANNYA, pipeline guardrail pra-panggilan yang memblokir dilewati untuk kunci di grup itu. Injeksi prompt tetap dinilai di latar belakang dan dicatat, dan tidak pernah memblokir, meskipun pemblokiran injection aktif untuk akun Anda. Kunci tersebut juga kehilangan jalur gratis sampai guardrail diaktifkan kembali: model free/ dan cf-* mengembalikan 403 free_requires_guardrails, dan jatah harian paket Free tidak lagi berlaku.
Gunakan dengan hati-hati. Dengan master toggle mati, PII, moderasi konten, dan guardrail pra-panggilan lainnya dinonaktifkan, sedangkan injeksi prompt dinilai tetapi tidak diblokir. Respons lalu membawa
X-Anoman-Guardrail-Master: disabledsehingga Anda bisa membedakan permintaan yang di-bypass. Hanya gunakan ini untuk beban kerja yang sepenuhnya tepercaya dan terisolasi.
Di dashboard, master toggle hadir dengan peringatan dan dialog konfirmasi, justru karena ia mematikan masking PII, moderasi konten, dan guardrail pra-panggilan lainnya.
Di mana mengelola grup
Kelola konfigurasi grup dan master toggle di dashboard pada /dashboard/guardrails. Tetapkan kunci ke grup dan setel override per-kunci di toggle kunci API pada /dashboard/keys.
Akun organisasi: hanya owner/admin. Di organisasi, hanya owner atau admin yang dapat membuat, mengubah, menghapus, atau menetapkan policy group. Peran lain hanya dapat melihatnya, dan kunci API organisasi mendapat 403 insufficient_account_role. Di akun pribadi, pemilik dapat mengubahnya dari dashboard atau dengan kunci API miliknya.
Konfigurasi policy group Anda
Setel konfigurasi guardrail sekali, pasang ke setiap kunci, dan timpa di mana Anda perlu.