メインコンテンツへスキップ
AI トラフィックのどこに機密データが現れるかの記録を残したいが、まだリクエストを 拒否し始める準備はできていない。Compliance Logger プリセットはまさにそれです: PII の出現を監視して記録し、何も変更しないガードレールです。キーにアタッチ すると、フラグされたすべての用語が Matches フィードに着地する一方、リクエストは バイト単位で変更されないままアップストリームに流れます。 これは observe-only のユースケースに焦点を当てたランディングページです。完全な エンジン — すべてのルールの種類、アクション、ルート — については ガードレールリファレンスを参照してください。

1. observe-only ガードレールを 1 つのプリセットで

**Compliance Logger(observe-only)**は、ガードレールテンプレートピッカーの Compliance カテゴリにあります。これはアクション flag を持つ単一の pii ルールです — マッチを記録し、トラフィックをそのままにするアクションです。block も、 mask も、モデル呼び出しも、SDK 変更もありません:ポリシーはゲートウェイに存在し、 あなたのアプリは以前と全く同様に /v1/chat/completions を呼び出し続けます。

Flag、決して強制しない

アクションは flag です — マッチに注釈を付け、リクエストとレスポンスを 手つかずで通します。何もブロックされず、何もマスクされません。

両方のステージ

ステージは both です — ルールはリクエストモデルのレスポンスを スキャンするため、入りと出りの両方で PII を確認できます。

クォータオーバーヘッドゼロ

組み込み PII 検出は決定的な文字列マッチングです — アップストリームの judge 呼び出しなし、追加トークンなし、モデルの背後で直列化されるものもありません。
Flag = 観察のみ。 flag アクションはマッチを記録し、トラフィックを 変更しません。強制する前にポリシーを測定するため、あるいは挙動を変えずに コンプライアンスログを保持するための適切なツールです。完全な block / mask / flag のトレードオフについてはアクションを 参照してください。

2. Compliance Logger プリセット、出荷されたとおりに

コンソールの Guardrails ビューで New guardrail スプリットボタンを開き、 Compliance テンプレートカテゴリを選びます。**Compliance Logger (observe-only)**シードは単一の pii ルールです:
フィールド
Typepii
Stageboth(リクエスト + レスポンス)
Actionflag(観察のみ)
Entitiesemailphonessncredit_cardip
これらのエンティティのいずれかに対するすべてのマッチが記録されます。何も ブロックも変更もされません。プリセットはシードであり、ロックではありません — キーをアタッチする前に、エンティティセットを編集したり、名前を変更したり、 さらにルールを重ねたりできます。
フラグはリクエスト上で稼働します — キーがアタッチされた瞬間に実際の トラフィック上でルールが発火するため、Matches フィードは別個のサンプリング ジョブではなく、実際の呼び出しから埋まります。

3. コンソールでプリセットを適用する

ここでのすべてのステップは、自分のセッション下のコンソール アクションです。 ガードレールの作成と編集にはワークスペースで Developer+ が必要です。最後の /v1/* 呼び出しのみが sk-orca-... リレーキーを使います。
1

テンプレートを開く

コンソールで Guardrails を開き、New guardrail スプリットボタンを クリックし、Compliance テンプレートカテゴリから **Compliance Logger (observe-only)**を選びます。
2

名前を付けて保存する

ガードレールに名前(≤ 64 文字)を付けます。例:compliance-logger。 オプションでエンティティリストを削ったり拡張したりし、保存します。アクションは flag のままにしておきます — それが observe-only に保つものです。
3

テストする

Test タブを開き、input ステージでサンプルを貼り付け、ポリシーをローカルで 実行します — アップストリーム呼び出しなし、クォータなし (§5 を参照)。
4

キーをアタッチする

API キーを編集し、Guardrail ドロップダウンから compliance-logger を 選びます(キーに guardrail_id を設定します)か、ワークスペース デフォルトにマークします。キーにアタッチアカウントデフォルトを参照してください。

4. 具体例 1 つ

compliance-logger(プリセット、変更なし)という名前のガードレールがキーに アタッチされています。以前と全く同様にゲートウェイを呼び出します — 新しい ヘッダーなし、SDK 変更なし:
curl https://api.orcarouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "Reply to jane@acme.com about her SSN 123-45-6789"}
    ]
  }'
リクエストは変更なしで通過します — アップストリームモデルは全く同じ テキストを目にし、レスポンスは変更されず、通常の completion が返ってきます。 その背後で、pii ルールが emailssn をフラグし、各マッチがワークスペースの Matches フィードに着地します。呼び出し元は違いを目にすることはありません。 あなたは監査証跡を得ます。
観察のみは強制なしを意味します。Compliance Logger は漏洩をブロックしたり データをリダクトしたりしません — それらを記録します。アクションを起こす準備が できたら、アクションを block または mask に切り替えるか、 PII Shieldシークレットのブロックのような強制 プリセットと組み合わせます。

5. アタッチする前にテストする

どのキーもそれを指す前に、ルールが期待どおりにフラグすることを証明します。 エディタ内の Test タブを開き、サンプルを貼り付け、ステージを選んで実行します:
Reply to jane@acme.com about her SSN 123-45-6789
サンドボックスは現在のポリシーをローカルで評価し、判定を返します — flag ルール では、どのエンティティがマッチしたかを確認でき、アップストリームには何も送信 されず、何もメータリングされません。言い回しのコーパスに対するスイープについては、 Eval ハーネスが隣のタブにあります。

6. 何が発火したか確認する

これが observe-only プリセットの要点です:Matches フィードです。 フラグされたすべての出現は、マッチ — ルールの種類、アクション、ステージ、詳細 文字列 — を記録し、GET /api/guardrail/match(Member)で表に出ます。マッチした 部分文字列そのもの(実際の email、SSN)は、Log raw content がオンのときに のみ記録され、これはデフォルトでオフです。
コンプライアンスログの場合、Log raw content をオフのままにしておくことが たいてい要点です:規制対象データを自分のテレメトリにコピーすることなく、SSN が 出現したこととその頻度を学べます。トリアージのために部分文字列が必要なときに のみ、ガードレールごとにオンにします。設定は非遡及的です。 Matches フィードロギングとプライバシーを参照してください。
フィードをステージでフィルターすれば、PII がトラフィックのどこに入るか — 入力プロンプトかモデル出力か — を確認でき、ルールの種類pii ルールを 切り分けられます。マッチしたエンティティ(email、ssn、…)は、各マッチの詳細 文字列に保持されます。そのシグナルが、アクションを flag から block または mask に切り替える準備ができているかどうかを教えてくれます。 ガードレールへのすべての編集は、同じトランザクション内でバージョン付きの履歴行を 書き込みます — 任意の 2 つのバージョンを diff し、History ビューから revert できます。バージョニングを参照してください。

7. 観察のみから強制へ

Compliance Logger は、ロールアウトの第一段階となるよう設計されています:
flag のみのプリセットをアタッチし、Matches フィードを実際のトラフィックで 埋めさせます。リクエストが決してブロックされないため、測定中に本番への リスクはゼロです。
フィードと誤検知のチューニングを 使って、エンティティセットがあなたのデータにマッチし、ノイジーでないことを 確認します。
アクションを mask(モデルの前に PII をリダクト)または block に 切り替えるか、強制プリセットに差し替えます。エンティティごとの entity_actionsを使って、ひとつのルール内で 一部のエンティティをマスクしつつ、高深刻度のものをブロックします。
手作りのものではなく、規制フレームワークのログが必要ですか?Compliance Logger は、コンプライアンスパックが具現化するプリセットのひとつです。 フレームワーク駆動のレディネスと署名付きレポートについては、 コンプライアンスセクションを参照してください。

8. 次に進む先

アクション:block / mask / flag

完全なアクションモデル — いつ観察し、いつリダクトし、いつ拒否するか。

PII Shield

強制する対応物 — ログするだけでなく、リクエスト上で PII をマスクします。

Matches フィード

フラグされたすべての出現をブラウズ、グループ化、フィルター、エクスポートします。

ロギングとプライバシー

Log-raw-content トグルと、デフォルトで記録されるもの。
observe-only ガードレールはそれ自体では何もゲートしません — それは測定の面です。 ガードレールとファイアウォールがどう作業を分担するかのより広い全体像については、 ガードレール vs. ファイアウォールを 参照してください。完全なエンジン — ステージ、高度なルール、ルート — については、 ガードレールリファレンスを読んでください。