View a markdown version of this page

ポリシーエンジンを作成する - Amazon Bedrock AgentCore
前提条件ポリシーエンジンを作成するその後に必要な識別子

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ポリシーエンジンを作成する

ポリシーエンジンは、エージェントツール呼び出しを評価して承認するポリシーのコレクションです。ゲートウェイに関連付けられている場合、ポリシーエンジンはすべてのエージェントリクエストを傍受し、定義されたポリシーに基づいて各アクションを許可するか拒否するかを決定します。

前提条件

ポリシーエンジンを作成する前に、ゲートウェイを設定します。詳細については、「Amazon Bedrock AgentCore ゲートウェイのセットアップ」を参照してください。

ポリシーエンジンを作成する

以下は、ポリシーエンジンを作成する方法を示しています。

ポリシーエンジン名は 48 文字以内[A-Za-z][A-Za-z0-9_]*で一致する必要があります。文字で始まり、その後は文字、数字、アンダースコアのみが許可されます。ハイフンは有効ではないため、 my_policy_engine ではなく を使用してくださいmy-policy-engine。ポリシー名にも同じルールが適用されます。

例
AgentCore CLI

  1. AgentCore プロジェクトで、プロジェクト設定にポリシーエンジンを追加します。

    agentcore add policy-engine \
  --name my_policy_engine \
  --description "My Policy Engine" \
  --attach-to-gateways my-gateway \
  --attach-mode LOG_ONLY

  2. プロジェクトをデプロイして、アカウントに作成します。

    agentcore deploy --yes

    agentcore add はエンジンを にのみ記録しますagentcore/agentcore.json。 agentcore deploy はエンジンを作成します。デプロイ出力にはエンジン ID と ARN が含まれます。--attach-to-gateways同じステップでエンジンをゲートウェイに--attach-modeアタッチします。ポリシーのないLOG_ONLYエンジンはライブトラフィックを拒否しません。エンジンを独自の KMS キーで暗号化するには、 を追加します--encryption-key-arn。「ポリシーエンジンの暗号化をカスタマイズする」を参照してください。

AWS CLI

  1. ターミナルで次のコードを実行して、 CLI AWS を使用してポリシーエンジンを作成します。

    aws bedrock-agentcore-control create-policy-engine \
  --name my_policy_engine \
  --description "My Policy Engine"

    レスポンスには、 policyEngineIdと の両方が含まれますpolicyEngineArn。両方を保持します。これらは、「」で説明されているように、さまざまな場所で使用されますその後に必要な識別子。

AWS Python SDK (Boto3)

  1. 次の Python コードは、Python SDK (Boto3) AWS を使用してポリシーエンジンを作成する方法を示しています。

    import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.create_policy_engine(
    name='my_policy_engine',
    description='My Policy Engine'
)

print(f"Policy Engine ID: {response['policyEngineId']}")
print(f"Policy Engine ARN: {response['policyEngineArn']}")

その後に必要な識別子

エンジンを作成すると、2 つの識別子が返され、交換可能ではありません。

policyEngineId

--engine AgentCore CLI のすべてのポリシーオペレーション - CreatePolicy、UpdatePolicy、、DeletePolicyおよび ListPoliciesによって使用されます。my_policy_engine-a1b2c3d4e5名前と生成された 10 文字のサフィックスのようになります。ID が予想される ARN を渡すと、検証エラーとして拒否されます。

policyEngineArn

エンジンを、 CreateGatewayまたは policyEngineConfiguration.arnのように、 LOG_ONLYまたは modeの UpdateGatewayとともにゲートウェイにアタッチするために使用されますENFORCE。AgentCore CLI は、 を渡すとこれを解決します--attach-to-gateways。

ポリシーの作成の詳細については、「ポリシーの作成」を参照してください。エンジンと切り替えモードのアタッチについては、「ポリシー適用モード」を参照してください。