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

# Creare una collaborazione multiagente
<a name="create-multi-agent-collaboration"></a>

La creazione di una collaborazione multiagente prevede le seguenti fasi:

1. Creare e distribuire gli agenti collaboratori. Assicurarsi di configurare ogni agente collaboratore per implementare un’attività specifica nel flusso di lavoro di collaborazione multiagente. 

1. Creare un nuovo agente supervisore o assegnare a un agente esistente il ruolo di supervisore. Quando viene creato un nuovo agente supervisore o un agente esistente viene identificato come agente supervisore, è possibile anche specificare come l’agente supervisore deve gestire le informazioni tra più agenti collaboratori.

   È possibile assegnare all’agente supervisore il compito di coordinare le risposte degli agenti collaboratori oppure assegnare all’agente supervisore il compito di inoltrare le informazioni all’agente collaboratore appropriato per inviare la risposta finale. L’assegnazione all’agente supervisore del compito di instradare le informazioni riduce la latenza. 

1. Associare la versione alias degli agenti collaboratori all’agente supervisore.
**Nota**  
Attualmente è possibile associare al massimo 10 agenti collaboratori a un agente supervisore.

1. Preparare e testare il team di collaborazione multiagente.

1. Implementare e invocare l’agente supervisore.

Puoi creare una collaborazione multiagente nella console Amazon Bedrock, utilizzando, utilizzando la APIs AWS CLI o utilizzando l'SDK. AWS Per scoprire come creare una collaborazione multiagente, scegli la scheda relativa al metodo che preferisci, quindi segui la procedura.

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

**Fase 1: creare agenti collaboratori**
+ Segui le istruzioni per [creare e configurare un agente](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html). Assicurati di configurare ogni agente collaboratore per eseguire un’attività specifica.

**Fase 2: creare un nuovo agente supervisore o assegnare il ruolo di supervisore a un agente esistente**

1. Se stai creando un nuovo agente supervisore, segui le istruzioni per [Creazione e configurazione manuale dell’agente](agents-create.md) e poi passa alla fase successiva.

   Se hai già configurato un agente e vuoi assegnare il ruolo di supervisore all’agente, passa alla fase successiva.

1. Se non hai già eseguito l’accesso ad Agente builder, procedi come segue:

   1. Accedi a Console di gestione AWS con un'identità IAM che dispone delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock in [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock)

   1. Seleziona **Agenti** nel riquadro di navigazione a sinistra. Quindi, scegli un agente nella sezione **Agenti**.

   1. Scegli **Modifica in Agente Builder**.

   1. In **Agente builder**, scorri verso il basso fino alla sezione **Collaborazione multiagente** e scegli **Modifica**.

1. Nella pagina **Collaborazione multiagente**, nella sezione **Stato della collaborazione**, attiva **Collaborazione multiagente**. L’agente verrà identificato come agente supervisore.

1. Nella sezione **Configurazione della collaborazione**, scegli come vuoi che l’agente supervisore gestisca le informazioni tra più agenti collaboratori per coordinare una risposta finale.

   1. Se vuoi che l’agente supervisore coordini le risposte degli agenti collaboratori, seleziona **Supervisore.**

   1. Se vuoi che l’agente supervisore inoltri le informazioni all’agente collaboratore appropriato per inviare la risposta finale, seleziona **Supervisore con instradamento**.

   1. Passa alle fasi successive per aggiungere agenti collaboratori.

**Fase 3: aggiungere agenti collaboratori**

1. Espandi la sezione **Agente collaboratore** e fornisci i dettagli dell’agente collaboratore che hai creato per la collaborazione multiagente.

   1. Per **Agente collaboratore**, seleziona un agente collaboratore e un **Alias agente** dal menu a discesa. Puoi scegliere **Visualizza** per visualizzare i dettagli dell’agente collaboratore.

   1. Per **Nome del collaboratore**, inserisci un nome alternativo per l’agente collaboratore. Questo nome non sostituirà il nome originale dell’agente.

   1. In **Istruzioni per i collaboratori**, inserisci i dettagli relativi a quando questo collaboratore l’agente supervisore deve utilizzare questo collaboratore. 

   1. (Facoltativo) Attiva **Abilita la cronologia delle conversazioni** se vuoi che l’agente supervisore condivida il contesto delle conversazioni precedenti con questo agente collaboratore. Se è attivata, il supervisore includerà la cronologia completa della sessione corrente, tra cui il testo di input dell’utente e la risposta dell’agente supervisore di ogni turno della conversazione.

1. Scegli **Aggiungi collaboratore** per aggiungere questo agente collaboratore al tuo team. multi-agent-collaboration Per aggiungere altri agenti collaboratori, ripeti la fase 1 finché non avrai aggiunto tutti i tuoi agenti collaboratori. 

1. Quando hai finito di aggiungere agenti collaboratori, seleziona una delle seguenti opzioni:
   + Per rimanere nella **Collaborazione multiagente**, scegli **Salva** e vai alla fase successiva per preparare e testare il team di collaborazione multiagente.
   + Per tornare alla pagina dei **Dettagli dell’agente**, scegli **Salva ed esci**.

**Fase 4: preparare e testare il team di collaborazione multiagente**
+ Segui le istruzioni per [preparare e testare](agents-test.md) il team di collaborazione multiagente. 

**Fase 5: implementare una collaborazione multiagente**
+ [Implementa](agents-deploy.md) la collaborazione multiagente configurando l’agente supervisore per effettuare una richiesta `InvokeAgent`.

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

Per creare un team di collaborazione multiagente, completa la seguente procedura:

**Fase 1: creare agenti collaboratori**
+ Segui le istruzioni per [creare e configurare un agente](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html). Assicurati di configurare ogni agente collaboratore per eseguire un’attività specifica.

**Fase 2: creare un nuovo agente supervisore o assegnare il ruolo di supervisore a un agente esistente**
+ Per creare un nuovo agente supervisore, invia 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) (consulta il link per i formati di richiesta e risposta e i dettagli sui campi) con un [endpoint in fase di compilazione di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).

  Per assegnare un ruolo di supervisore a un agente esistente, invia una richiesta [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html) a un [endpoint in fase di compilazione di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Poiché tutti i campi verranno sovrascritti, includi sia i campi che vuoi aggiornare sia quelli che vuoi mantenere invariati.

  Devi includere almeno i seguenti campi:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/create-multi-agent-collaboration.html)

  I seguenti campi sono facoltativi:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/create-multi-agent-collaboration.html)

  La risposta restituisce un oggetto [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html) che contiene dettagli sull’agente supervisore appena creato. Se l’agente non viene creato, l’oggetto [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html) nella risposta restituisce un elenco di `failureReasons` e un elenco di `recommendedActions` per risolvere il problema.

**Fase 3: aggiungere agenti collaboratori**
+ Per associare gli agenti collaboratori all’agente supervisore, invia una richiesta `AssociateAgentCollaborator` (consulta il link per i formati di richiesta e risposta e i dettagli sui campi) con un [endpoint di fase di compilazione di Agent per Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).

  Devi includere almeno i seguenti campi:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/create-multi-agent-collaboration.html)

**Fase 4: preparare e testare il team di collaborazione multiagente**
+ Segui le istruzioni per [preparare e testare](agents-test.md) il team di collaborazione multiagente. 

**Fase 4: implementare una collaborazione multiagente**
+ [Implementa](agents-deploy.md) la collaborazione multiagente configurando l’agente supervisore per effettuare una richiesta `InvokeAgent`.

------