本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 API

要运行护栏检查，请向 Amazon Bedrock 运行时终端节点发送InvokeGuardrailChecks请求。

请求格式

{
  "messages": [
    {
      "role": "user",
      "content": [{ "text": "string" }]
    }
  ],
  "checks": {
    "contentFilter": {
      "categories": [
        { "category": "VIOLENCE | HATE | SEXUAL | INSULTS | MISCONDUCT" }
      ]
    },
    "promptAttack": {
      "categories": [
        { "category": "JAILBREAK | PROMPT_INJECTION | PROMPT_LEAKAGE" }
      ]
    },
    "sensitiveInformation": {
      "entities": [
        { "type": "EMAIL | PHONE | US_SOCIAL_SECURITY_NUMBER | ..." }
      ]
    }
  }
}

响应格式

{
  "results": {
    "contentFilter":        { "results": [ ... ] },
    "promptAttack":         { "results": [ ... ] },
    "sensitiveInformation": { "results": [ ... ], "truncated": false }
  },
  "usage": {
    "contentFilter":        { "textUnits": 0 },
    "promptAttack":         { "textUnits": 0 },
    "sensitiveInformation": { "textUnits": 0 }
  }
}

只有您请求的支票才会显示在results和下usage。每个textUnits值都是校验评估的文本单位数。有关文本单位的定义，请参阅 Amazon Bedrock 定价。

错误

下表列出了 InvokeGuardrailChecks API 可能返回的错误。