Crea una barandilla

Para crear una barrera, se configuran las configuraciones, se definen los temas que se deben rechazar, se proporcionan filtros para gestionar el contenido perjudicial y confidencial y se escriben mensajes para cuando se bloqueen las solicitudes y las respuestas de los usuarios.

Una barrera debe contener al menos un filtro y mensajes para cuando se bloqueen las solicitudes y las respuestas de los usuarios. Puede optar por utilizar la mensajería predeterminada. Puede añadir filtros y realizar iteraciones en la barandilla más adelante siguiendo los pasos que se indican Edita una barandilla a continuación para configurar todos los componentes que necesite para la barandilla.

Seleccione la pestaña correspondiente al método que prefiera y siga los pasos.

Console

Para crear una barandilla

Inicie sesión en la AWS Management Console consola Amazon Bedrock y ábrala en https://console.aws.amazon.com/bedrock/.
En el panel de navegación izquierdo, selecciona Guardrails.
En la sección Barandillas, elija Crear barandilla.
En la página Proporcionar detalles de la barandilla, haga lo siguiente:
1. En la sección de detalles de la barandilla, proporcione un nombre y una descripción opcional para la barandilla.
2. (Opcional) De forma predeterminada, la barandilla está cifrada con un. Clave administrada de AWS Para usar tu propia clave de KMS gestionada por el cliente, selecciona la flecha derecha situada junto a la clave de KMS y selecciona la casilla de verificación Personalizar la configuración de cifrado (avanzada). Puede elegir una AWS KMS clave existente o seleccionar Crear una AWS KMS clave para crear una nueva.
3. (Opcional) Para añadir etiquetas a la barandilla, selecciona la flecha derecha situada junto a Etiquetas. A continuación, selecciona Añadir nueva etiqueta y define pares clave-valor para tus etiquetas. Para obtener más información, consulte Etiquetar recursos.
4. Seleccione Siguiente.
nota
Debe configurar al menos un filtro para crear una barandilla. A continuación, puede elegir Saltar a revisión y crear para omitir la creación de otros filtros.
(Opcional) En la página Configurar filtros de contenido, defina con qué intensidad desea filtrar el contenido relacionado con las categorías definidas Filtros de contenido de la siguiente manera:
1. Para configurar los filtros para las indicaciones de un modelo, seleccione Habilitar filtros para las solicitudes en la sección Puntos fuertes de los filtros para las solicitudes del modelo. Configure qué tan estricto quiere que sea cada filtro para las indicaciones que el usuario proporcione al modelo.
2. Para configurar los filtros para las respuestas del modelo, seleccione Habilitar filtros para las respuestas en la sección Puntos fuertes del filtro para las respuestas. Configure qué tan estricto quiere que sea cada filtro para las respuestas que devuelva el modelo.
3. Elija Siguiente.
(Opcional) En la página Agregar temas rechazados, haga lo siguiente:
1. Para definir el tema que se va a bloquear, selecciona Añadir tema denegado. A continuación, proceda del modo siguiente:
  1. Ingrese un nombre para el nuevo tema.
  2. En el cuadro Definición de tema, defina el tema. Para obtener instrucciones sobre cómo definir un tema denegado, consulteTemas denegados.
  3. (Opcional) Para añadir mensajes de entrada representativos o respuestas modelo relacionadas con este tema, seleccione la flecha derecha situada junto a Añadir frases de muestra. Introduce una frase en el cuadro. Para añadir otra frase, selecciona Añadir frase.
  4. Cuando hayas terminado de configurar el tema denegado, selecciona Confirmar.
2. Puede realizar las siguientes acciones con los temas denegados.
  - Para añadir otro tema, selecciona Añadir tema denegado.
  - Para editar un tema, selecciona el icono de los tres puntos en la misma fila que el tema en la columna Acciones. A continuación, elija Edit. Cuando hayas terminado de editar, selecciona Confirmar.
  - Para eliminar uno o varios temas, selecciona las casillas de verificación de los temas que deseas eliminar. Selecciona Eliminar y, a continuación, selecciona Eliminar lo seleccionado.
  - Para eliminar todos los temas, selecciona Eliminar y, a continuación, selecciona Eliminar todo.
  - Para configurar el tamaño de cada página de la tabla o la visualización de las columnas de la tabla, selecciona el icono de configuración ( ). Defina sus preferencias y, a continuación, seleccione Confirmar.
3. Cuando haya terminado de configurar los temas denegados, seleccione Siguiente.

(Opcional) En la página Añadir filtros de palabras, haga lo siguiente:

En la sección Filtrar blasfemias, selecciona Filtrar blasfemias para bloquear las blasfemias en las preguntas y respuestas. La lista de blasfemias se basa en las definiciones convencionales y se actualiza continuamente.

En la sección Añadir palabras y frases personalizadas, selecciona cómo añadir palabras y frases para que la barandilla las bloquee. Si decides subir un archivo, cada línea del archivo debe contener una palabra o una frase de hasta tres palabras. No incluyas un encabezado. Dispone de las opciones siguientes:

Opción	Instrucciones
Agrega palabras y frases manualmente	Añade palabras y frases directamente en la sección Ver y editar palabras y frases.
Sube desde un archivo local	Para cargar un archivo.txt o .csv que contenga las palabras y frases, selecciona Elegir archivo después de seleccionar esta opción.
Cargar desde un objeto de Amazon S3	Para cargar un archivo desde Amazon S3, especifique el objeto S3 después de seleccionar esta opción. Cada línea del archivo debe contener una palabra o una frase de hasta tres palabras.

Puedes editar las palabras y frases que la barandilla bloqueará en la sección Ver y editar palabras y frases. Dispone de las opciones siguientes:
- Si ha subido una lista de palabras de un archivo local o de un objeto de Amazon S3, esta sección se rellenará con su lista de palabras. Para filtrar los elementos con errores, selecciona Mostrar errores.
- Para añadir un elemento a la lista de palabras, selecciona Añadir palabra o frase. Introduzca una palabra o una frase de hasta tres palabras en el cuadro y pulse Entrar o seleccione el icono de marca de verificación para confirmar el elemento.
- Para editar un elemento, selecciona el icono de edición ( ) situado junto al elemento.
- Para eliminar un elemento de la lista de palabras, selecciona el icono de la papelera ( ) o, si estás editando un elemento, elige el icono de eliminar ( ) situado junto al elemento.
- Para eliminar los elementos que contienen errores, selecciona Eliminar todo y, a continuación, selecciona Eliminar todas las filas con errores
- Para eliminar todos los elementos, selecciona Eliminar todo y, a continuación, selecciona Eliminar todas las filas
- Para buscar un elemento, introduce una expresión en la barra de búsqueda.
- Para mostrar solo los elementos con errores, selecciona el menú desplegable denominado Mostrar todo y selecciona Mostrar solo errores.
- Para configurar el tamaño de cada página de la tabla o la visualización de las columnas de la tabla, selecciona el icono de configuración ( ). Defina sus preferencias y, a continuación, seleccione Confirmar.
- De forma predeterminada, en esta sección se muestra el editor de tablas. Para cambiar a un editor de texto en el que pueda introducir una palabra o frase en cada línea, seleccione Editor de texto. El editor de texto ofrece las siguientes funciones:
  - Puede copiar una lista de palabras de otro editor de texto y pegarla en este editor.
  - Aparece un icono X rojo junto a los elementos que contienen errores y aparece una lista de errores en la parte inferior del editor.

(Opcional) En la página Añadir filtros de información confidencial, configure los filtros para bloquear o enmascarar la información confidencial. Para obtener más información, consulte Filtros de información confidencial. Haga lo siguiente:

En la sección de tipos de PII, configure las categorías de información de identificación personal (PII) para bloquearlas o ocultarlas. Dispone de las opciones siguientes:
- Para agregar un tipo de PII, elija Agregar un tipo de PII. A continuación, proceda del modo siguiente:
  1. En la columna Tipo, seleccione un tipo de PII.
  2. En la columna de comportamiento de la barandilla, seleccione si la barandilla debe bloquear el contenido que contenga el tipo de PII o enmascararlo con un identificador.
- Para añadir todos los tipos de PII, selecciona la flecha desplegable situada junto a Añadir un tipo de PII. A continuación, seleccione el comportamiento de la barandilla que desee aplicarles.
  
  aviso
  Si especifica un comportamiento, se sobrescribirá cualquier comportamiento existente que haya configurado para los tipos de PII.
- Para eliminar un tipo de PII, elija el icono de la papelera ().
- Para eliminar las filas que contienen errores, selecciona Eliminar todo y, a continuación, selecciona Eliminar todas las filas con errores
- Para eliminar todos los tipos de PII, selecciona Eliminar todo y, a continuación, selecciona Eliminar todas las filas
- Para buscar una fila, introduce una expresión en la barra de búsqueda.
- Para mostrar solo las filas con errores, selecciona el menú desplegable denominado Mostrar todo y selecciona Mostrar solo errores.
- Para configurar el tamaño de cada página de la tabla o la visualización de las columnas de la tabla, selecciona el icono de configuración ( ). Defina sus preferencias y, a continuación, seleccione Confirmar.

En la sección de patrones de expresiones regulares, usa expresiones regulares para definir los patrones que la barandilla debe filtrar. Dispone de las opciones siguientes:

Para añadir un patrón, selecciona Añadir patrón de expresiones regulares. Configure los siguientes campos:

Campo	Descripción
Nombre	Un nombre para el patrón
Patrón de expresiones regulares	Una expresión regular que define el patrón
Comportamiento de las medidas de seguridad	Elija si desea bloquear el contenido que contiene el patrón o enmascararlo con un identificador. Para enmascarar el patrón solo en los registros, elija Ninguno.
Añadir descripción	(Opcional) Escribe una descripción para el patrón

Para editar un patrón, elige el icono de tres puntos en la misma fila que el tema de la columna Acciones. A continuación, elija Edit. Cuando haya terminado de editar, elija Confirmar.
Para eliminar uno o varios patrones, active las casillas de verificación de los patrones que desee eliminar. Elija Eliminar y, a continuación, seleccione Eliminar lo seleccionado.
Para eliminar todos los patrones, selecciona Eliminar y, a continuación, selecciona Eliminar todo.
Para buscar un patrón, introduce una expresión en la barra de búsqueda.
Para configurar el tamaño de cada página de la tabla o la visualización de las columnas de la tabla, seleccione el icono de configuración ( ). Defina sus preferencias y, a continuación, seleccione Confirmar.

Cuando termine de configurar los filtros de información confidencial, seleccione Siguiente.

En la página Definir mensajes bloqueados, configure los mensajes que desee devolver al usuario cuando la barandilla detecte y bloquee el contenido. Haga lo siguiente:
1. En el campo Mensajes mostrados para mensajes bloqueados de la sección Mensajes bloqueados, introduzca el mensaje para ver si la barandilla bloquea un mensaje enviado al modelo.
2. En el campo Mensajes mostrados para las respuestas bloqueadas de la sección Mensajes bloqueados, introduzca el mensaje que se mostrará si la barandilla bloquea una respuesta generada por el modelo.
3. Elija Siguiente.
Revisar y crear: revise la configuración de la barandilla.
1. Selecciona Editar en cualquier sección en la que desees realizar cambios.
2. Cuando esté satisfecho con la configuración de la barandilla, seleccione Crear para crear la barandilla.

API

Para crear una barandilla, envíe una solicitud. CreateGuardrail El formato de la solicitud es el siguiente:


POST /guardrails HTTP/1.1
Content-type: application/json

{
   "blockedInputMessaging": "string",
   "blockedOutputsMessaging": "string",
   "contentPolicyConfig": { 
      "filtersConfig": [ 
         { 
            "inputStrength": "NONE | LOW | MEDIUM | HIGH",
            "outputStrength": "NONE | LOW | MEDIUM | HIGH",
            "type": "SEXUAL | VIOLENCE | HATE | INSULTS | MISCONDUCT | PROMPT_ATTACK"
         }
      ]
   },
    "wordPolicyConfig": {
    "wordsConfig": [
      {
        "text": "string"
      }
    ],
    "managedWordListsConfig": [
      {
        "type": "string"
      }
    ]
  },
  "sensitiveInformationPolicyConfig": {
    "piiEntitiesConfig": [
      {
        "type": "string",
        "action": "string"
      }
    ],
    "regexesConfig": [
      {
        "name": "string",
        "description": "string",
        "regex": "string",
        "action": "string"
      }
    ]
  },
   "description": "string",
   "kmsKeyId": "string",
   "name": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ],
   "topicPolicyConfig": { 
      "topicsConfig": [ 
         { 
            "definition": "string",
            "examples": [ "string" ],
            "name": "string",
            "type": "DENY"
         }
      ]
   }
}

Especifique una name y description para la barandilla.
Especifique los mensajes para cuando la barandilla bloquee correctamente un mensaje o una respuesta del modelo en los campos y. blockedInputMessaging blockedOutputsMessaging
Especifique los temas para que la barandilla no entre en el objeto. topicPolicy Cada elemento de la topics lista pertenece a un tema. Para obtener más información sobre los campos de un tema, consulte el tema.
- Coloque una name mano description para que la barandilla pueda identificar correctamente el tema.
- Especifique DENY en el campo. action
- (Opcional) Proporcione hasta cinco ejemplos que clasifique como pertenecientes al tema de la examples lista.
Especifique las intensidades del filtro para las categorías dañinas definidas en Amazon Bedrock en el contentPolicy objeto. Cada elemento de la filters lista pertenece a una categoría peligrosa. Para obtener más información, consulte Filtros de contenido. Para obtener más información sobre los campos de un filtro de contenido, consulte ContentFilter.
- Especifique la categoría en el type campo.
- Especifique la intensidad del filtro para las solicitudes en el strength campo del textToTextFiltersForPrompt campo y para las respuestas del modelo en el strength campo deltextToTextFiltersForResponse.
(Opcional) Coloque cualquier etiqueta en la barandilla. Para obtener más información, consulte Etiquetar recursos.
(Opcional) Por motivos de seguridad, incluye el ARN de una clave KMS en el kmsKeyId campo.

El formato de respuesta es el siguiente:


HTTP/1.1 202
Content-type: application/json

{
   "createdAt": "string",
   "guardrailArn": "string",
   "guardrailId": "string",
   "version": "string"
}

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Requisitos previos

Pruebe una barandilla

Crea una barandilla

Para crear una barandilla

nota

aviso