

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à.

# Casi d’uso per Guardrail per Amazon Bedrock
<a name="guardrails-use"></a>

Dopo aver creato un guardrail, puoi applicarlo utilizzando le seguenti funzionalità:
+ [Inferenza del modello](inference.md): applica un guardrail ai prompt inviati e alle risposte generate durante l’esecuzione dell’inferenza su un modello.
+ [Agenti](agents.md): associa un guardrail a un agente per applicarlo ai prompt inviati all’agente e alle risposte restituite.
+ [Knowledge base](knowledge-base.md): applica un guardrail quando interroghi una knowledge base e generi risposte da essa.
+ [Flusso](flows.md): aggiungi un guardrail a un nodo del prompt o a un nodo della knowledge base in un flusso per applicarlo agli input e agli output di questi nodi.

La tabella seguente descrive come includere un guardrail per ciascuna di queste funzionalità utilizzando l'API Console di gestione AWS Amazon Bedrock.


****  

| Caso d’uso | Console | "Hello, World\!" | 
| --- | --- | --- | 
| Inferenza del modello | Seleziona il guardrail quando [utilizzi un playground](playgrounds.md). | Specificalo nell'intestazione di una [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)richiesta [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)or o includi nel guardrailConfig campo nel corpo di una [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) o di una richiesta. [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html) | 
| Associa a un agente | Quando [crei o aggiorni](agents-build-modify.md) l’agente, specificalo nella sezione Dettagli guardrail di Agente Builder. | Includi un campo guardrailConfiguration nel corpo di una richiesta [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html) o [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html). | 
| Utilizza durante la query di una knowledge base | Segui i passaggi indicati nella sezione [Guardrail](kb-test-config.md#kb-test-config-guardrails) delle configurazioni della query. Aggiungi un guardrail quando imposti Configurazioni. | Includi un campo guardrailConfiguration nel corpo di una richiesta [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html). | 
| Includi in un nodo del prompt di un flusso | Quando [crei](flows-create.md) o [aggiorni](flows-modify.md) un flusso, seleziona il nodo del prompt e specifica il guardrail nella sezione Configura. | Quando definisci il nodo prompt nel nodes campo di una [UpdateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateFlow.html)richiesta [CreateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateFlow.html)or, includi un guardrailConfiguration campo in. [PromptFlowNodeConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptFlowNodeConfiguration.html) | 
| Includi in un nodo della knowledge base in un flusso | Quando [crei](flows-create.md) o [aggiorni](flows-modify.md) un flusso, seleziona il nodo della knowledge base e specifica il guardrail nella sezione Configura. | Quando definisci il nodo della knowledge base nel nodes campo di una [UpdateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateFlow.html)richiesta [CreateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateFlow.html)or, includi un guardrailConfiguration campo in. [KnowledgeBaseFlowNodeConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_KnowledgeBaseFlowNodeConfiguration.html) | 

Questa sezione illustra l’utilizzo di un guardrail con inferenza del modello e l’API Amazon Bedrock. Puoi utilizzare le operazioni di inferenza di base ([InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)and [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)) e l'ConverseAPI ([Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) and [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html)). Con entrambi i set di operazioni è possibile utilizzare un guardrail con l’inferenza del modello in modalità sincrona e in streaming. È inoltre possibile valutare selettivamente l’input dell’utente e configurare il comportamento di risposta in streaming. 

**Topics**
+ [Utilizzare il guardrail con operazioni di inferenza per valutare l’input dell’utente](guardrails-input-tagging-base-inference.md)
+ [Usa l' ApplyGuardrail API nella tua applicazione](guardrails-use-independent-api.md)