Creare una collaborazione multiagente - Amazon Bedrock

Creare una collaborazione multiagente

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.

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

  3. Associare la versione alias degli agenti collaboratori all’agente supervisore.

    Nota

    Attualmente è possibile associare al massimo 10 agenti collaboratori a un agente supervisore.

  4. Preparare e testare il team di collaborazione multiagente.

  5. Implementare e invocare l’agente supervisore.

È possibile creare una collaborazione multiagente nella console Amazon Bedrock, utilizzando le API, la AWS CLI o 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
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 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.

  2. Se non hai già eseguito l’accesso ad Agente builder, 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.

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

    3. Scegli Modifica in Agente Builder.

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

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

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

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

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

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

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

    4. (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.

  2. Scegli Aggiungi collaboratore per aggiungere questo agente collaboratore al team di collaborazione multiagente. Per aggiungere altri agenti collaboratori, ripeti la fase 1 finché non avrai aggiunto tutti i tuoi agenti collaboratori.

  3. 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
Fase 5: implementare una collaborazione multiagente

  • Implementa 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
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 CreateAgent (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.

    Per assegnare un ruolo di supervisore a un agente esistente, invia una richiesta UpdateAgent a un endpoint in fase di compilazione di Agent per Amazon Bedrock. 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:

    Campo Caso d’uso
    agentResourceRoleArn Per specificare un ARN del ruolo di servizio con autorizzazioni per chiamare le operazioni API sull’agente
    foundationModel Per specificare un modello di fondazione (FM) con cui l’agente può orchestrare
    instruction Per fornire istruzioni che indichino all’agente cosa fare; utilizzato nel segnaposto $instructions$ del modello di prompt di orchestrazione
    agentCollaboration

    Per assegnare il ruolo di supervisore all’agente.

    Specificare SUPERVISOR se si vuole che l’agente supervisore coordini le risposte degli agenti collaboratori e fornisca la risposta.

    Specificare SUPERVISOR_ROUTER se si vuole che l’agente supervisore inoltri le informazioni all’agente collaboratore appropriato per inviare la risposta finale.

    Per impostazione predefinita, questo campo è impostato su DISABLED.

    I seguenti campi sono facoltativi:

    Campo Caso d’uso
    description Descrive cosa fa l’agente
    idleSessionTTLInSeconds Durata dopo la quale l’agente termina la sessione ed elimina tutte le informazioni archiviate
    customerEncryptionKeyArn ARN di una chiave KMS per crittografare le risorse degli agenti
    tags Per associare i tag all’agente.
    promptOverrideConfiguration Per personalizzare i prompt inviati al modello di fondazione in ogni fase dell’orchestrazione.
    guardrailConfiguration Per aggiungere un guardrail all’agente. Per specificare l’ID o l’ARN del guardrail e la versione da utilizzare.
    clientToken Per garantire che la richiesta dell’API venga completata solo una volta. Per ulteriori informazioni, consulta Garanzia di idempotenza.

    La risposta restituisce un oggetto CreateAgent che contiene dettagli sull’agente supervisore appena creato. Se l’agente non viene creato, l’oggetto CreateAgent 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.

    Devi includere almeno i seguenti campi:

    Campo Caso d’uso
    collaboratorName Per specificare un nome alternativo per l’agente collaboratore. Questo nome apparirà solo nelle istruzioni di collaborazione e non sostituisce il nome dell’agente originale.
    agentDescriptor Per specificare l’alias dell’agente Arn.
    collaborationInstruction Per fornire istruzioni per dire all’agente collaboratore cosa fare.
    relayConversationHistory

    Impostare TO_COLLABORATOR per specificare che l’agente supervisore condividerà il contesto delle conversazioni precedenti con questo agente collaboratore.

    Valori validi: TO_COLLABORATOR | DISABLED.
Fase 4: preparare e testare il team di collaborazione multiagente
Fase 4: implementare una collaborazione multiagente

  • Implementa la collaborazione multiagente configurando l’agente supervisore per effettuare una richiesta InvokeAgent.