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.

# Uso de la API
<a name="guardrails-use-invoke-guardrail-checks-using"></a>

Para realizar comprobaciones de barandillas, envíe una `InvokeGuardrailChecks` solicitud al punto de conexión de tiempo de ejecución de Amazon Bedrock.

## Formato de las solicitudes
<a name="guardrails-use-invoke-guardrail-checks-request"></a>

```
{
  "messages": [
    {
      "role": "user",
      "content": [{ "text": "string" }]
    }
  ],
  "checks": {
    "contentFilter": {
      "categories": [
        { "category": "VIOLENCE | HATE | SEXUAL | INSULTS | MISCONDUCT" }
      ]
    },
    "promptAttack": {
      "categories": [
        { "category": "JAILBREAK | PROMPT_INJECTION | PROMPT_LEAKAGE" }
      ]
    },
    "sensitiveInformation": {
      "entities": [
        { "type": "EMAIL | PHONE | US_SOCIAL_SECURITY_NUMBER | ..." }
      ]
    }
  }
}
```
+ `messages`: obligatorio. Al menos un mensaje con un bloque de contenido de texto.
+ `checks`: obligatorio. Debe configurarse al menos un campo de verificación.

## Formato de las respuestas
<a name="guardrails-use-invoke-guardrail-checks-response"></a>

```
{
  "results": {
    "contentFilter":        { "results": [ ... ] },
    "promptAttack":         { "results": [ ... ] },
    "sensitiveInformation": { "results": [ ... ], "truncated": false }
  },
  "usage": {
    "contentFilter":        { "textUnits": 0 },
    "promptAttack":         { "textUnits": 0 },
    "sensitiveInformation": { "textUnits": 0 }
  }
}
```

Solo los cheques que ha solicitado aparecen en `results` y`usage`. Cada `textUnits` valor es el número de unidades de texto que evaluó la verificación. Para ver la definición de una unidad de texto, consulta los [precios de Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/).

## Errores
<a name="guardrails-use-invoke-guardrail-checks-errors"></a>

En la siguiente tabla se enumeran los errores que la `InvokeGuardrailChecks` API puede devolver.


**InvokeGuardrailChecks Errores de API**  

| Código de HTTP | Error | Causa | 
| --- | --- | --- | 
| 400 | ValidationException | La solicitud tiene un formato incorrecto, faltan campos obligatorios o infringe una restricción. | 
| 403 | AccessDeniedException | La persona que llama no está autorizada a invocar la API. | 
| 429 | ThrottlingException | La tasa de solicitudes superó la cuota de la cuenta. Vuelva a intentarlo con un retraso exponencial. | 
| 500 | InternalServerException | El servicio encontró un error inesperado. Intente realizar de nuevo la solicitud . | 
| 503 | ServiceUnavailableException | El servicio no está disponible temporalmente. Vuelva a intentarlo con un retroceso exponencial. |