> ## Documentation Index
> Fetch the complete documentation index at: https://docs.starfort.io/llms.txt
> Use this file to discover all available pages before exploring further.

# アクション: PASS / MASK / BLOCK

> すべてのGuardianの判断は、3つのアクションのいずれかに帰結します。それぞれの意味と、全体のアクションがどのように選ばれるかを学びます。

Guardianがコンテンツを評価するたびに、**アクション**を返します。中間の状態はポリシータイプによって異なります。**PII**ポリシーは`PASS` / `MASK` / `BLOCK`を使用し、**Topic**ポリシーは`PASS` / `CHECK` / `BLOCK`を使用します。

<CardGroup cols={2}>
  <Card title="PASS" icon="check">
    一致したルールがない（または`PASSING`ルールのみ一致した）場合。コンテンツはそのまま続行します。
  </Card>

  <Card title="MASK" icon="eye-slash">
    *（PIIのみ）* 機微な箇所がマスクトークンに置き換えられます。Guardianはマスクされたコンテンツを返します。
  </Card>

  <Card title="CHECK" icon="magnifying-glass">
    *（Topicのみ）* `controversial`なトピックに一致しました — レビューが必要としてフラグ付けされます。**Desktop AgentおよびProxy Serverでは、CHECKはPASSとして適用されます**（コンテンツは通過し、トレースに記録されるのみ）。API呼び出し元には`CHECK`が直接返されます。
  </Card>

  <Card title="BLOCK" icon="ban">
    ブロッキングルールまたはunsafeなトピックに一致した場合。リクエストは停止され、何も先へ送信されません。
  </Card>
</CardGroup>

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

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

## 実際のレスポンス例

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

```json theme={null}
{
  "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`です。

```json theme={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": "무기", "action": "BLOCK", "confidence": 0.91 }]
    }]
  }]
}
```

<Note>
  フィールドの完全なリファレンス（PIIとTopicの`detected_items`の違い）については、[レスポンス形式](/ja/v1.2/api/response-format)を参照してください。
</Note>

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

* **API開発者**は、[Guard APIレスポンス](/ja/v1.2/api/response-format)から`action`を読み取ります。
* **Account Admin**は、[Opticonモニタリング](/ja/v1.2/admin/monitoring-opticon)ですべてのアクションをトレースとして確認でき、`PASS` / `MASK` / `CHECK` / `BLOCK`のタグが付きます（トレースタグは、PASSとして適用された場合でも`CHECK`を保持します）。
* **Desktop Agentユーザー**は、AIツールを使用する際にMASK/BLOCKを透過的に体験します。