

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

# Implementare un flusso nella tua applicazione utilizzando versioni e alias
<a name="flows-deploy"></a>

Quando crei un flusso per la prima volta, vengono create una bozza di lavoro (`DRAFT`) e un alias di test (`TSTALIASID`) che rimanda alla versione bozza di lavoro. Quando apporti modifiche al flusso, le modifiche si applicano alla bozza di lavoro, quindi quest’ultima è la versione più recente del flusso. Dovrai continuare con la bozza di lavoro finché il comportamento del flusso non ti sembra soddisfacente. Quindi, puoi configurare il flusso per l’implementazione creando *versioni* del flusso.

Una *versione* è simile a uno snapshot che conserva la risorsa così com’era al momento della creazione. Puoi continuare a modificare la bozza di lavoro e creare versioni del flusso, secondo le esigenze. Amazon Bedrock crea le versioni in ordine numerico, a partire da 1. Le versioni sono immutabili perché fungono da snapshot del flusso al momento della creazione. Per aggiornare un flusso che hai implementato in produzione, devi creare una nuova versione dalla bozza di lavoro ed effettuare chiamate all’alias che punta a quella versione.

Per implementare il flusso, devi creare un *alias* che punti a una versione del flusso. Quindi, fai richieste `InvokeFlow` a quell’alias. Con gli alias, puoi passare comodamente da una versione all’altra del flusso senza tenere traccia della versione. Ad esempio, puoi modificare un alias in modo che punti a una versione precedente del flusso nel caso in cui esistano modifiche da ripristinare rapidamente.

Negli argomenti seguenti viene descritto come creare versioni e alias del flusso.

**Topics**
+ [Creare una versione di un flusso in Amazon Bedrock](flows-version-create.md)
+ [Visualizzazione delle informazioni sulle versioni dei flussi in Amazon Bedrock](flows-version-view.md)
+ [Eliminare una versione di un flusso in Amazon Bedrock](flows-version-delete.md)
+ [Creare un alias di un flusso in Amazon Bedrock](flows-alias-create.md)
+ [Visualizzare informazioni sugli alias dei flussi in Amazon Bedrock](flows-alias-view.md)
+ [Modificare l’alias di un flusso in Amazon Bedrock](flows-alias-modify.md)
+ [Eliminare l’alias di un flusso in Amazon Bedrock](flows-alias-delete.md)

# Creare una versione di un flusso in Amazon Bedrock
<a name="flows-version-create"></a>

Quando la configurazione del flusso ti soddisfa, crea una versione immutabile del flusso a cui puntare con un alias. Per scoprire come creare una versione del flusso, scegli la scheda relativa al tuo metodo preferito, quindi segui le fasi:

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

**Per creare una versione di Amazon Bedrock Flows**

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, scegli un flusso nella sezione **Amazon Bedrock Flows**.

1. Nella sezione **Versioni**, scegli **Pubblica versione**.

1. Dopo la pubblicazione della versione, viene visualizzato un banner per informarti che l’operazione è riuscita.

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

Per creare una versione del flusso, invia una richiesta [CreateFlowVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateFlowVersion.html) con un [endpoint in fase di build di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e specifica l’ARN o l’ID del flusso come `flowIdentifier`.

La risposta restituisce un ID e un ARN per la versione. Le versioni vengono create in modo incrementale, a partire da 1.

------

# Visualizzazione delle informazioni sulle versioni dei flussi in Amazon Bedrock
<a name="flows-version-view"></a>

Per scoprire come visualizzare le informazioni sulle versioni di un flusso, scegli la scheda relativa al tuo metodo preferito, quindi segui le fasi:

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

**Per vedere le informazioni su una versione di un flusso**

1. Apri la [Console di gestione AWS](https://console.aws.amazon.com/) e accedi all’account. Vai ad Amazon Bedrock.

1. Seleziona **Flussi** nel riquadro di navigazione a sinistra. Quindi, nella sezione **Flussi**, seleziona un flusso che intendi visualizzare.

1. Scegli la versione da visualizzare nella sezione **Versioni**.

1. Per visualizzare i dettagli sui nodi e le configurazioni collegati alla versione del flusso, seleziona il nodo e visualizza i dettagli nel riquadro **Generatore di flussi**. Per apportare modifiche al flusso, usa la bozza di lavoro e crea una nuova versione.

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

Per ottenere informazioni su una versione del flusso, invia una richiesta [GetFlowVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetFlowVersion.html) con un [endpoint in fase di build di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e specifica l’ARN o l’ID del flusso come `flowIdentifier`. Nel campo `flowVersion`, specifica il numero di versione.

Per elencare le informazioni per tutte le versioni di un flusso, invia una richiesta [ListFlowVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListFlowVersions.html) con un [endpoint in fase di build di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e specifica l’ARN o l’ID del flusso come `flowIdentifier`. È inoltre possibile specificare i parametri opzionali seguenti:


****  

| Campo | Breve descrizione | 
| --- | --- | 
| maxResults | Il numero massimo di risultati da restituire nella risposta. | 
| nextToken | Se i risultati sono superiori al numero specificato nel campo maxResults, la risposta restituisce un valore nextToken. Per visualizzare il batch di risultati successivo, invia il valore nextToken in un’altra richiesta. | 

------

# Eliminare una versione di un flusso in Amazon Bedrock
<a name="flows-version-delete"></a>

Per scoprire come eliminare una versione di un flusso, scegli la scheda relativa al tuo metodo preferito, quindi segui le fasi:

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

**Per eliminare una versione di un flusso**

1. Apri la [Console di gestione AWS](https://console.aws.amazon.com/) e accedi all’account. Vai ad Amazon Bedrock.

1. Seleziona **Flussi** nel riquadro di navigazione a sinistra. Quindi, nella sezione **Flussi**, seleziona un flusso.

1. Scegli **Elimina**.

1. Viene visualizzata una finestra di dialogo che ti informa delle conseguenze dell’eliminazione. Per confermare l’eliminazione della versione, immetti **delete** nel campo di input e scegli **Elimina**.

1. Viene visualizzato un banner blu per informarti che la versione sta per essere eliminata. Al termine dell’eliminazione, viene visualizzato un banner che notifica la riuscita dell’operazione.

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

Per eliminare una versione di un flusso, invia una richiesta [DeleteFlowVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteFlowVersion.html) con un [endpoint in fase di build di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Specifica l’ARN o l’ID del flusso nel campo `flowIdentifier` e la versione da eliminare nel campo `flowVersion`.

------

# Creare un alias di un flusso in Amazon Bedrock
<a name="flows-alias-create"></a>

Per invocare un flusso, devi prima creare un alias che punti a una versione del flusso. Per scoprire come creare un alias, scegli la scheda relativa al tuo metodo preferito, quindi segui le fasi:

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

**Per creare un alias per Amazon Bedrock Flows**

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, scegli un flusso nella sezione **Flussi**.

1. Nella sezione **Alias** scegli **Crea alias**.

1. Inserisci un nome univoco per l’alias e una descrizione facoltativa.

1. Scegli una delle seguenti opzioni:
   + Per creare una nuova versione, scegli **Creare una nuova versione e associarla a questo alias**.
   + Per utilizzare una versione esistente, scegli **Usare una versione esistente per associare questo alias**. Nel menu a discesa, scegli la versione a cui associare l’alias.

1. Seleziona **Crea alias**. Nella parte superiore viene visualizzato un banner per informarti che l’operazione è riuscita.

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

Per creare un alias che punti a una versione del flusso, invia una richiesta [CreateFlowAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateFlowAlias.html) a un [endpoint in fase di build di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).

I seguenti campi sono obbligatori:


****  

| Campo | Descrizione di base | 
| --- | --- | 
| flowIdentifier | L’ARN o l’ID del flusso per il quale creare un alias. | 
| name | Un nome dell’alias. | 
| routingConfiguration | Specifica la versione a cui mappare l’alias nel campo flowVersion. | 

I seguenti campi sono facoltativi:


****  

| Campo | Caso d’uso | 
| --- | --- | 
| description | Per inserire una descrizione per l’alias. | 
| clientToken | Per impedire la duplicazione della richiesta. | 

------

La creazione di un alias produce una risorsa con un identificatore e un nome della risorsa Amazon (ARN) che puoi specificare quando invochi un flusso dalla tua applicazione. Per scoprire come invocare un flusso, consulta [Testare un flusso in Amazon Bedrock](flows-test.md).

# Visualizzare informazioni sugli alias dei flussi in Amazon Bedrock
<a name="flows-alias-view"></a>

Per scoprire come visualizzare le informazioni sugli alias di un flusso, scegli la scheda relativa al tuo metodo preferito, quindi segui le fasi:

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

**Per visualizzare i dettagli di un alias**

1. Apri la [Console di gestione AWS](https://console.aws.amazon.com/) e accedi all’account. Vai ad Amazon Bedrock.

1. Seleziona **Flussi** nel riquadro di navigazione a sinistra. Quindi, nella sezione **Flussi**, seleziona un flusso.

1. Scegli l’alias da visualizzare nella sezione **Alias**.

1. Puoi visualizzare il nome e la descrizione dell’alias e dei tag associati all’alias.

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

Per ottenere informazioni sull’alias di flusso, invia una richiesta [GetFlowAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetFlowAlias.html) con un [endpoint in fase di build di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e specifica l’ARN o l’ID del flusso come `flowIdentifier`. Nel campo `aliasIdentifier`, specifica l’ID o l’ARN dell’alias.

Per elencare le informazioni per tutti gli alias di un flusso, invia una richiesta [ListFlowAliass](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListFlowAliass.html) con un [endpoint in fase di build Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) e specifica l’ARN o l’ID del flusso come `flowIdentifier`. È inoltre possibile specificare i parametri opzionali seguenti:


****  

| Campo | Breve descrizione | 
| --- | --- | 
| maxResults | Il numero massimo di risultati da restituire nella risposta. | 
| nextToken | Se i risultati sono superiori al numero specificato nel campo maxResults, la risposta restituisce un valore nextToken. Per visualizzare il batch di risultati successivo, invia il valore nextToken in un’altra richiesta. | 

------

# Modificare l’alias di un flusso in Amazon Bedrock
<a name="flows-alias-modify"></a>

Per scoprire come modificare l’alias di un flusso, scegli la scheda relativa al tuo metodo preferito, quindi segui le fasi:

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

**Per modificare un alias**

1. Apri la [Console di gestione AWS](https://console.aws.amazon.com/) e accedi all’account. Vai ad Amazon Bedrock.

1. Seleziona **Flussi** nel riquadro di navigazione a sinistra. Quindi, nella sezione **Flussi**, seleziona un flusso.

1. Nella sezione **Alias**, scegli il pulsante di opzione accanto all’alias che desideri modificare.

1. Puoi modificare il nome e la descrizione dell’alias. Inoltre, puoi eseguire una delle seguenti operazioni:
   + Per creare una nuova versione e associare l’alias a quella versione, scegli **Creare una nuova versione e associarla all’alias**.
   + Per associare questo alias a una versione esistente diversa, scegli **Usare una versione esistente e associare l’alias**.

1. Seleziona **Salva**.

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

Per aggiornare un alias, invia una richiesta [UpdateFlowAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateFlowAlias.html) con un [endpoint in fase di build di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Includi nella richiesta sia i campi da mantenere che quelli da modificare.

------

# Eliminare l’alias di un flusso in Amazon Bedrock
<a name="flows-alias-delete"></a>

Per scoprire come eliminare l’alias di un flusso, scegli la scheda relativa al tuo metodo preferito, quindi segui le fasi:

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

**Per eliminare un alias**

1. Apri la [Console di gestione AWS](https://console.aws.amazon.com/) e accedi all’account. Vai ad Amazon Bedrock.

1. Seleziona **Flussi** nel riquadro di navigazione a sinistra. Quindi, nella sezione **Flussi**, seleziona un flusso.

1. Per scegliere l’alias da eliminare, nella sezione **Alias**, scegli il pulsante di opzione accanto all’alias che desideri eliminare.

1. Scegli **Elimina**.

1. Viene visualizzata una finestra di dialogo che ti informa delle conseguenze dell’eliminazione. Per confermare che desideri eliminare l’alias, immetti **delete** nel campo input, quindi scegli **Elimina**.

1. Viene visualizzato un banner per informarti che l’alias sta per essere eliminato. Al termine dell’eliminazione, viene visualizzato un banner che notifica la riuscita dell’operazione.

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

Per eliminare l’alias di un flusso, invia una richiesta [DeleteFlowAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteFlowAlias.html) con un [endpoint in fase di build di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Specifica l’ARN o l’ID del flusso nel campo `flowIdentifier` e l’ARN o l’ID dell’alias da eliminare nel campo `aliasIdentifier`.

------