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

# Testare un flusso in Amazon Bedrock
<a name="flows-test"></a>

Dopo aver creato un flusso, avrai una *bozza di lavoro*. La bozza di lavoro è una versione del flusso che puoi sviluppare e testare in modo iterativo. Ogni volta che apporti modifiche al flusso, la bozza di lavoro viene aggiornata.

Quando esegui il test del flusso, Amazon Bedrock verifica innanzitutto quanto segue e genera un’eccezione se la verifica fallisce:
+ Connettività tra tutti i nodi del flusso.
+ È configurato almeno un nodo di output del flusso.
+ I tipi di variabili di input e output vengono abbinati come richiesto.
+ Le espressioni delle condizioni sono valide e viene fornito un risultato predefinito.

Se la verifica fallisce, dovrai correggere gli errori prima di poter testare e convalidare le prestazioni del flusso. Di seguito è riportata la procedura per testare il flusso. Scegli la scheda relativa al tuo metodo preferito, quindi segui la procedura:

------
#### [ Console ]

**Per testare il flusso**

1. Se non sei già nel **Generatore di flussi**, procedi come segue:

   1. Accedi alla Console di gestione AWS con un’identità IAM che disponga delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock all’indirizzo [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).

   1. Seleziona **Amazon Bedrock Flows** nel riquadro di navigazione a sinistra. Quindi, nella sezione **Amazon Bedrock Flows**, seleziona un flusso da testare.

   1. Scegli **Modifica nel Generatore di flussi**.

1. Nella **pagina del Generatore di flussi**, nel riquadro a destra, inserisci un input per invocare il flusso. Verifica che il tipo di dati di input corrisponda al tipo di dati di output che hai configurato per il nodo di input del flusso.

1. Scegli **Esegui**.

1. I nodi o le connessioni nella configurazione del flusso che generano errori vengono evidenziati in rosso e quelli che attivano gli avvisi vengono evidenziati in giallo. Leggi i messaggi di errore e gli avvisi, risolvi i problemi identificati, salva il flusso ed esegui nuovamente il test.
**Nota**  
Per applicare le modifiche apportate durante il test del flusso, è necessario salvare il flusso.

1. (Facoltativo) Per visualizzare gli input, gli output e la durata di esecuzione per ciascun nodo, scegli **Mostra traccia** nella risposta. Per ulteriori informazioni, consulta [Tenere traccia di ciascuna fase del flusso visualizzandone la traccia in Amazon BedrockTenere traccia di ciascuna fase del flusso visualizzandone la traccia](flows-trace.md). Per tornare al visual builder, scegli **Nascondi traccia** o seleziona l’icona di compressione.

1. Se le prestazioni del flusso ti soddisfano, scegli **Salva ed esci**.

1. Puoi continuare l’iterazione della creazione del flusso. Se il flusso ti soddisfa e vuoi implementarlo in produzione, crea una versione del flusso e un alias per puntare alla versione. Per ulteriori informazioni, consulta [Implementare un flusso nella tua applicazione utilizzando versioni e alias](flows-deploy.md).

------
#### [ API ]

Per testare il flusso, invia una richiesta [InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html) con un endpoint di runtime [Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). Includi l’ARN o l’ID del flusso nel campo `flowIdentifier` e l’ARN o l’ID dell’alias da utilizzare nel campo `flowAliasIdentifier`.

Per visualizzare gli input e gli output per ciascun nodo, imposta il campo `enableTrace` su `TRUE`. Per ulteriori informazioni, consulta [Tenere traccia di ciascuna fase del flusso visualizzandone la traccia in Amazon BedrockTenere traccia di ciascuna fase del flusso visualizzandone la traccia](flows-trace.md).

Il testo della richiesta specifica l’input per il flusso e presenta il seguente formato:

```
{
   "inputs": [ 
      { 
         "content": { 
            "document": "JSON-formatted string"
         },
         "nodeName": "string",
         "nodeOutputName": "string"
      }
   ],
   "enableTrace": TRUE | FALSE
}
```

Inserisci l’input nel campo `document`, inserisci un nome per l’input nel campo `nodeName` e inserisci un nome per l’input nel campo `nodeOutputName`.

La risposta viene restituita in uno stream. Ciascun evento restituito contiene l’output di un nodo nel campo `document`, il nodo elaborato nel campo `nodeName` e il tipo di nodo nel campo `nodeType`. Questi eventi sono nel seguente formato:

```
{
    "flowOutputEvent": { 
        "content": { 
            "document": "JSON-formatted string"
        },
        "nodeName": "string",
        "nodeType": "string"
    }
}
```

Se il flusso termina, viene restituito anche un campo `flowCompletionEvent` con `completionReason`. Se si verifica un errore, viene restituito il campo di errore corrispondente.

------

# Tenere traccia di ciascuna fase del flusso visualizzandone la traccia in Amazon Bedrock
<a name="flows-trace"></a>

Quando invochi un flusso, puoi visualizzare la *traccia* per vedere gli input e gli output di ciascun nodo. La traccia consente di tracciare il percorso dall’input alla risposta che restituisce. È possibile utilizzare la traccia per risolvere gli errori che si verificano, per identificare le fasi che portano a un risultato imprevisto o a un rallentamento delle prestazioni e per valutare come è possibile migliorare il flusso.

Per visualizzare la traccia, procedi come indicato di seguito:
+ Nella console, segui le fasi nella scheda **Console** in [Testare un flusso in Amazon Bedrock](flows-test.md) e scegli **Mostra traccia** nella risposta dall’invocazione del flusso.
+ Nell’API, imposta il campo `enableTrace` su `true` in una richiesta [InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html). Ciascuno `flowOutputEvent` nella risposta viene restituito insieme a `flowTraceEvent`.

Ciascun evento della traccia include il nome del nodo che ha ricevuto un input o prodotto un output e la data in cui l’input o l’output è stato elaborato. Per maggiori informazioni su un tipo di evento della traccia, seleziona una scheda:

------
#### [ FlowTraceConditionNodeResultEvent ]

Questo tipo di traccia identifica quali condizioni sono soddisfatte per un nodo di condizione e aiuta a identificare il ramo o i rami del flusso che vengono attivati durante l’invocazione. Il seguente oggetto JSON mostra l’aspetto di [FlowTraceEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_FlowTraceEvent.html) per il risultato di un nodo di condizione:

```
{
    "trace": {
        "conditionNodeOutputTrace": {
            "nodeName": "string",
            "satisfiedConditions": [
                {
                    "conditionName": "string"
                },
                ...
            ],
            "timestamp": timestamp
        }
    }
}
```

------
#### [ FlowTraceNodeInputEvent ]

Questo tipo di traccia mostra l’input inviato a un nodo. Se l’evento è a valle di un nodo iteratore ma a monte di un nodo collettore, il campo `iterationIndex` indica l’indice dell’elemento nell’array da cui proviene l’input. Il seguente oggetto JSON mostra l’aspetto di [FlowTraceEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_FlowTraceEvent.html) per l’input in un nodo.

```
{
    "trace": {
        "nodeInputTrace": {
            "fields": [
                {
                    "content": {
                        "document": JSON object
                    },
                    "nodeInputName": "string"
                },
                ...
            ],
            "nodeName": "string",
            "timestamp": timestamp,
            "iterationIndex": int
        }
    }
}
```

------
#### [ FlowTraceNodeOutputEvent ]

Questo tipo di traccia mostra l’output prodotto da un nodo. Se l’evento è a valle di un nodo iteratore ma a monte di un nodo collettore, il campo `iterationIndex` indica l’indice dell’elemento nell’array da cui proviene l’output. Il seguente oggetto JSON mostra l’aspetto di [FlowTraceEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_FlowTraceEvent.html) per l’output di un nodo.

```
{
    "trace": {
        "nodeOutputTrace": {
            "fields": [
                {
                    "content": {
                        "document": JSON object
                    },
                    "nodeOutputName": "string"
                },
                ...
            ],
            "nodeName": "string",
            "timestamp": timestamp,
            "iterationIndex": int
        }
    }
}
```

------