View a markdown version of this page

Sintaxis y ejemplos de la política de Amazon Bedrock - AWS Organizations
La sintaxis de la política de Amazon Bedrock incluye los siguientes elementos

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.

Sintaxis y ejemplos de la política de Amazon Bedrock

Una política de Amazon Bedrock es un archivo de texto sin formato que se estructura de acuerdo con las reglas de JSON. La sintaxis de las políticas de Amazon Bedrock sigue la sintaxis de todos los tipos de políticas de administración. Para obtener más información, consulte Sintaxis de política y herencia para tipos de políticas de administración. Este tema se centra en aplicar esa sintaxis general a los requisitos específicos del tipo de política de Amazon Bedrock.

El siguiente ejemplo de política de Amazon Bedrock muestra la sintaxis básica de la política de Amazon Bedrock:

{
    "bedrock": {
        "guardrail_inference": {
            "us-east-1": {
                "config_1": {
                    "identifier": {
                        "@@assign": "arn:aws:bedrock:us-east-1:123456789012:guardrail/hu1dlsv9wy1d:1"
                    },
                    "selective_content_guarding": {
                        "system": {
                            "@@assign": "selective"
                        },
                        "messages": {
                            "@@assign": "comprehensive"
                        }
                    },
                    "model_enforcement": {
                        "included_models": {
                            "@@assign": ["ALL"]
                        },
                        "excluded_models": {
                            "@@assign": ["amazon.titan-embed-text-v2:0", "cohere.embed-english-v3"]
                        }
                    }
                }
            }
        }
    }
}

La sintaxis de la política de Amazon Bedrock incluye los siguientes elementos

"bedrock"

La clave de nivel superior de los documentos de política de Amazon Bedrock.

"guardrail_inference"

Define la configuración de aplicación de las barandillas.

<region>

La región en la que se aplicará la política. Por ejemplo, "us-east-1".

"config_1"

Identificador de configuración de los ajustes de la barandilla.

"identifier" (Obligatorio)

Guardrail ARN, seguido :version de la versión Guardrail.

  • El Guardrail debe ser propiedad de la cuenta de administración. No puede crear una política con un Guardrail de otra cuenta.

  • La barandilla debe tener una versión, y esa versión no puede ser preliminar. Para crear una versión de su barandilla, consulte Crear una versión de una barandilla en la guía del usuario de Amazon Bedrock.

  • El Guardrail debe tener una política basada en los recursos que permita a los miembros de la organización llamar. ApplyGuardrail

  • La barandilla debe crearse y usarse en la región especificada.

"selective_content_guarding" (opcional)

Amazon Bedrock APIs permite marcar contenido específico dentro de la entrada que la persona que llama quiere que las barandillas procesen. Esta configuración permite a las autoridades controlar si respetan o no las decisiones de etiquetado de contenido tomadas por la persona que llama. Si se especifica, se requiere una de las siguientes opciones"system". "messages"

"system" (opcional)

Elija cómo procesarán las barandillas las indicaciones del sistema. El valor predeterminado es cuando no se especificacomprehensive.

  • "comprehensive": Evalúe todo el contenido independientemente de las etiquetas de contenido de protección.

  • "selective": Evalúe únicamente el contenido que se encuentre dentro de las etiquetas de contenido de protección. No evalúa ningún contenido cuando no se especifica ninguna etiqueta.

"messages" (opcional)

Elija cómo procesarán las barandillas el contenido de los mensajes con las conversaciones entre el usuario y el asistente. El valor predeterminado es comprehensive cuando no se especifica.

  • "comprehensive": Evalúe todo el contenido independientemente de las etiquetas de contenido de protección.

  • "selective": Evalúe únicamente el contenido que se encuentre dentro de las etiquetas de contenido de protección. Evalúa todo el contenido de los mensajes cuando no se especifica ninguna etiqueta.

"model_enforcement" (opcional)

Información específica del modelo para la configuración de barandillas reforzadas. Si no está presente, la configuración se aplica a todos los modelos.

"included_models" (Obligatorio)

Lista de modelos en los que se puede instalar la barandilla. Cuando está vacío, aplica la normativa a todos los modelos. También acepta la palabra clave «TODOS» para incluir de forma explícita todos los modelos.

"excluded_models" (Obligatorio)

Modelos que excluyen de la aplicación de la barandilla. Si está vacío, no excluye a ningún modelo de la aplicación. Si un modelo está presente en las listas de modelos incluidos y excluidos, queda excluido.