View a markdown version of this page

Crear un motor de políticas - Amazon Bedrock AgentCore
Requisitos previosCree un motor de políticasIdentificadores que necesitará después

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Crear un motor de políticas

Un motor de políticas es un conjunto de políticas que evalúa y autoriza las llamadas de los agentes a las herramientas. Cuando se asocia a una puerta de enlace, el motor de políticas intercepta todas las solicitudes de los agentes y determina si permite o deniega cada acción en función de las políticas definidas.

Requisitos previos

Antes de crear un motor de políticas, configure una puerta de enlace. Para obtener más información, consulte Configurar una AgentCore puerta de enlace de Amazon Bedrock.

Cree un motor de políticas

A continuación, se muestra cómo crear un motor de políticas.

El nombre de un motor de políticas debe coincidir [A-Za-z][A-Za-z0-9_]* y tener un máximo de 48 caracteres. Comienza con una letra y, después, solo se permiten letras, dígitos y guiones bajos. Los guiones no son válidos, así que my_policy_engine utilícelos en lugar de. my-policy-engine La misma regla se aplica a los nombres de las políticas.

ejemplo
AgentCore CLI

  1. En un AgentCore proyecto, añada un motor de políticas a la configuración del proyecto:

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

  2. Implemente el proyecto para crearlo en su cuenta:

    agentcore deploy --yes

    agentcore addsolo graba el motoragentcore/agentcore.json; agentcore deploy es lo que lo crea. El resultado de la implementación incluye el ID y el ARN del motor. --attach-to-gatewaysy --attach-mode conecte el motor a una puerta de enlace en el mismo paso: comience de LOG_ONLY manera que un motor sin políticas no deniegue el tráfico en directo. Para cifrar el motor con su propia clave KMS, añada--encryption-key-arn; consulte Personalizar el cifrado del motor de políticas.

AWS CLI

  1. Ejecute el siguiente código en una terminal para crear un motor de políticas mediante la AWS CLI:

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

    La respuesta contiene las dos palabras policyEngineId ypolicyEngineArn. Conserve ambos: se utilizan en diferentes lugares, tal y como se describe enIdentificadores que necesitará después.

AWS Python SDK (Boto3)

  1. El siguiente código de Python muestra cómo crear un motor de políticas mediante el SDK de AWS Python (Boto3):

    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']}")

Identificadores que necesitará después

Al crear un motor, se obtienen dos identificadores y no son intercambiables:

policyEngineId

Se utiliza en todas las operaciones de políticas (CreatePolicyListPolicies,UpdatePolicy,DeletePolicy,) y --engine en la AgentCore CLI. Se ve asímy_policy_engine-a1b2c3d4e5: tu nombre, más un sufijo de diez caracteres generado. Si se pasa un ARN en el que se espera un ID, se rechaza como error de validación.

policyEngineArn

Se utiliza para conectar el motor a una puerta de enlace, ya sea policyEngineConfiguration.arn en CreateGateway oUpdateGateway, junto a una mode de LOG_ONLY oENFORCE. La AgentCore CLI resuelve esto por ti cuando apruebas--attach-to-gateways.

Para obtener más información sobre la creación de políticas, consulte Crear una política. Para conectar un motor y cambiar de modo, consulte Modos de aplicación de políticas.