Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Per eseguire i controlli guardrail, invia una `InvokeGuardrailChecks` richiesta all'endpoint di runtime Amazon Bedrock.

## Formato della richiesta
<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`: obbligatorio Almeno un messaggio con un blocco di contenuto testuale.
+ `checks`: obbligatorio È necessario impostare almeno un campo di controllo.

## Formato della risposta
<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 i controlli richiesti vengono visualizzati in `results` e`usage`. Ogni `textUnits` valore è il numero di unità di testo valutate dal controllo. Per la definizione di un'unità di testo, consulta i [prezzi di Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/).

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

La tabella seguente elenca gli errori che l'`InvokeGuardrailChecks`API può restituire.


**InvokeGuardrailChecks Errori dell'API**  

| Codice HTTP | Errore | Causa | 
| --- | --- | --- | 
| 400 | ValidationException | La richiesta non è valida, non contiene campi obbligatori o viola un vincolo. | 
| 403 | AccessDeniedException | Il chiamante non è autorizzato a richiamare l'API. | 
| 429 | ThrottlingException | La frequenza delle richieste ha superato la quota dell'account. Riprova con backoff esponenziale. | 
| 500 | InternalServerException | Il servizio ha riscontrato un errore imprevisto. Riprova la richiesta . | 
| 503 | ServiceUnavailableException | Il servizio è temporaneamente non disponibile. Riprova con backoff esponenziale. |