アクション: PASS / MASK / BLOCK

Guardian がコンテンツを評価するたびに、アクションを返します。PII ポリシーは PASS / MASK / BLOCK を使用し、Topic の判定は 2-state です — PASS または BLOCK のいずれかです。

PASS

一致したルールがない（または PASSING ルールのみ一致した）場合。コンテンツはそのまま続行します。

MASK

（PII のみ） 機微な箇所がマスクトークンに置き換えられます。Guardian はマスクされたコンテンツを返します。

BLOCK

ブロッキングルールまたは unsafe なトピックに一致した場合。リクエストは停止され、何も先へ送信されません。

全体のアクションは最も重大なものになる

レスポンスには、ルートの action と項目ごとの内訳があります。ルートのアクションは、PII と Topic の結果を統合した上で、検出されたすべての項目のうち最も重大なアクションです: BLOCK > MASK > PASS。したがって、1 つでもブロッキングに一致すると、他の部分がマスクのみであっても、リクエスト全体が BLOCK になります。

実際のレスポンス例

MASK — PII が一致し、置き換えられました。processed_content にマスクされたテキストが格納されます。マスクトークンは [<MASK_WORD>_<n>] の形式に従い、カテゴリごとに番号が付与されます（1 始まり、ドキュメント内の出現順、かつ値に対して安定です。同じ元の値には同じ番号が付くため、異なる 2 つの氏名はそれぞれ [PERSON_NAME_1] と [PERSON_NAME_2] になります）。各トークンの背後にある元の値は matched_text として公開され、unmaskOutput はこれを使って元に戻します。

{
  "action": "MASK",
  "input_results": [{
    "index": 0, "type": "text", "action": "MASK",
    "processed_content": "私の電話番号は [PHONE_NUMBER_1]、メールアドレスは [EMAIL_1] です。",
    "results": [{
      "policy_name": "PII Masking Policy", "policy_type": "PII", "action": "MASK",
      "detected_items": [
        { "rule_type": "regex", "rule_name": "phone_number", "mask_word": "PHONE_NUMBER_1", "matched_text": "010-2543-2513" },
        { "rule_type": "regex", "rule_name": "email", "mask_word": "EMAIL_1", "matched_text": "jane@acme.co.kr" }
      ]
    }]
  }]
}

BLOCK — unsafe な Topic に一致しました。processed_content は null です。

{
  "action": "BLOCK",
  "input_results": [{
    "index": 0, "type": "text", "action": "BLOCK", "processed_content": null,
    "results": [{
      "policy_name": "Topic Policy", "policy_type": "TOPIC", "action": "BLOCK",
      "detected_items": [{ "rule_id": "WPN", "rule_name": "Weapons", "action": "BLOCK", "confidence": 0.91 }]
    }]
  }]
}

フィールドの完全なリファレンス（PII と Topic の detected_items の違い）については、レスポンス形式を参照してください。

アクションが確認できる場所

API 開発者は、Guard API レスポンスから action を読み取ります。
Account Admin は、Opticon モニタリングですべてのアクションをトレースとして確認でき、PASS / MASK / BLOCK のタグが付きます。
Desktop Agent ユーザーは、AI ツールを使用する際に MASK/BLOCK を透過的に体験します。

PASS

MASK

BLOCK

​全体のアクションは最も重大なものになる

​実際のレスポンス例

​アクションが確認できる場所

全体のアクションは最も重大なものになる

実際のレスポンス例

アクションが確認できる場所