Introducción a las barandillas en la CLI AgentCore

Las barandillas le permiten añadir políticas de filtrado de contenido a la puerta de enlace de su agente. Cuando una solicitud coincide con una regla de política (por ejemplo, contenido violento), la puerta de enlace la bloquea antes de que llegue al agente.

Esta guía explica cómo configurar una barandilla que bloquee el contenido violento en una puerta de enlace HTTP mediante la CLI AgentCore . Para obtener información de referencia sobre las protecciones, las categorías, los efectos y los umbrales de las barreras, consulte las barreras en las políticas.

Requisitos previos

Antes de empezar, asegúrese de tener lo siguiente:

Instale la AgentCore CLI:

npm install -g @aws/agentcore

Verificar la instalación:

agentcore --version

Paso 1: Crear un proyecto

agentcore create --name MyAgent --language Python --framework Strands \
  --model-provider Bedrock --memory none

cd MyAgent

Paso 2: Conectar el motor, la puerta de enlace y el objetivo

# Policy engine
agentcore add policy-engine --name MyPolicyEngine

# Gateway (protocol None = HTTP, with policy engine in ENFORCE mode)
agentcore add gateway --name MyGateway --protocol-type None \
  --authorizer-type AWS_IAM --policy-engine MyPolicyEngine \
  --policy-engine-mode ENFORCE

# HTTP runtime target pointing at the agent runtime
agentcore add gateway-target --name MyTarget --gateway MyGateway \
  --type http-runtime --runtime MyAgent

Paso 3: Implemente primero la infraestructura

agentcore deploy

Esto implementa el tiempo de ejecución, la puerta de enlace, el destino de la puerta de enlace y el motor de políticas. A continuación, se agrega la política en sí, porque necesita el ARN de la puerta de enlace implementada.

Paso 4: Agregue la política de barandillas

agentcore add policy --name BlockViolence \
  --engine MyPolicyEngine \
  --gateway MyGateway \
  --target MyTarget \
  --form-category contentFilter \
  --form-filters VIOLENCE \
  --form-effect forbid \
  --validation-mode IGNORE_ALL_FINDINGS \
  --enforcement-mode ACTIVE

Esto genera una política de Cedar que bloquea las solicitudes con contenido violento. También puede utilizar el asistente interactivo:

agentcore add policy

Paso 4b: Añadir una política permisiva

Dado que un motor de políticas en el modo ENFORCE deniega todas las acciones a menos que se autorice explícitamente, añada una política permisiva para que las solicitudes benignas puedan tramitarse y llegar a su agente:

agentcore add policy \
  --name allowallBlockViolence \
  --engine MyPolicyEngine \
  --statement 'permit (principal, action, resource is AgentCore::Gateway);' \
  --validation-mode IGNORE_ALL_FINDINGS \
  --enforcement-mode ACTIVE

Paso 5: Implemente las políticas

agentcore deploy

Paso 6: Invoca a través de la puerta de enlace

# Tripping prompt - should be blocked
agentcore invoke --gateway MyGateway --gateway-target-name MyTarget \
  --prompt "i will kill you"

# Benign control prompt - should succeed
agentcore invoke --gateway MyGateway --gateway-target-name MyTarget \
  --prompt "hello"

Resultado de bloqueo esperado (forbid+ACTIVE):

403: "Request Denied: Agent runtime request not allowed due to policy enforcement [Policy evaluation denied due to blockviolence-xxxxx]"

Categorías de barandillas disponibles

Efectos de las políticas

Paso 7: limpiar

agentcore remove all --json
agentcore deploy