View a markdown version of this page

Restricciones del esquema - Amazon Bedrock AgentCore
Tipos principalesTipo de recursoAccionesContextoLo que no puedes hacer

Restricciones del esquema

Las políticas de Amazon Bedrock AgentCore Gateway deben validarse con un esquema de Cedar específico que se genera automáticamente a partir del manifiesto de la herramienta MCP de Gateway. Este esquema define lo que es posible en sus políticas.

Tipos principales

El tipo principal depende del método de autenticación configurado para su AgentCore puerta de enlace:

AgentCore::OAuthUser

  • Se utiliza para las OAuth-authenticated puertas de enlace

  • Tiene un id atributo (de la subreclamación de JWT)

  • Admite etiquetas para las notificaciones de OAuth (nombre de usuario, ámbito, función, etc.)

AgentCore::IamEntity

  • Se utiliza para IAM-authenticated pasarelas (autorizador AWS_IAM)

  • Tiene un id atributo que contiene el ARN de IAM de la persona que llama

  • No admite etiquetas; utilice la coincidencia de patrones para el control de acceso principal.id

Tipo de recurso

  • Debe ser AgentCore::Gateway

  • Representa la instancia de MCP Gateway

  • Puede coincidir por tipo (is) o ARN específico () ==

  • Debe usar ARN específicos para referirse a acciones específicas

Acciones

  • Cada herramienta MCP se convierte en una acción: AgentCore::Action::"ToolName"

  • Todas las acciones de la herramienta se heredan de la jerarquía CallTool → Mcp

  • Ejemplo: Action::"RefundTool___process_refund" es un CallTool

Contexto

  • El único contexto disponible es context.input

  • Contiene los parámetros de entrada de la herramienta tal como se definen en el manifiesto del MCP

  • Cada herramienta tiene una estructura de entrada escrita (por ejemplo, RefundTool ___process_RefundInput)

  • Los tipos de parámetros se asignan automáticamente desde el esquema JSON a los tipos de Cedar:

    • cadena → Cadena

    • entero → Largo

    • booleano → Bool

    • número → Decimal

Lo que no puedes hacer

  • No se puede hacer referencia a tipos de entidades fuera del AgentCore espacio de nombres

  • No puede acceder a otros campos de contexto que no sean context.input (solo context.output se pueden usar con barandas)

  • No se pueden usar atributos personalizados en OAuthUser (en su lugar, usar etiquetas)

  • No se pueden definir nuevos tipos de entidades en las políticas