Aggiungi un gruppo d'azione al tuo agente in Amazon Bedrock

Per aggiungere un gruppo di azioni a un agente

1. Accedi all' AWS Management Console utilizzo di un ruolo IAM con autorizzazioni Amazon Bedrock e apri la console Amazon Bedrock all'indirizzo https://console.aws.amazon.com/bedrock/.

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

3. Scegli Modifica in Agent Builder.

4. Nella sezione Gruppi di azioni, scegli Aggiungi.

5. (Facoltativo) Nella sezione Dettagli del gruppo di azioni, modifica il nome generato automaticamente e fornisci una descrizione facoltativa per il tuo gruppo di azioni.

6. Nella sezione Tipo di gruppo di azioni, selezionate uno dei seguenti metodi per definire i parametri che l'agente può richiedere agli utenti per facilitare l'esecuzione delle azioni:

   1. Definisci con i dettagli della funzione: definisci i parametri che l'agente deve richiedere all'utente per eseguire le azioni. Per ulteriori informazioni sull'aggiunta di funzioni, vedereDefinisci i dettagli delle funzioni per i gruppi di azione del tuo agente in Amazon Bedrock.

   2. Definisci con schemi API: definisci le operazioni API che l'agente può richiamare e i parametri. Usa uno schema OpenAPI che hai creato o usa l'editor di testo della console per creare lo schema. Per ulteriori informazioni sulla configurazione di uno schema OpenAPI, vedere Definisci OpenAPI schemi per i gruppi d'azione del tuo agente in Amazon Bedrock

7. Nella sezione Action group invocation, si imposta ciò che fa l'agente dopo aver previsto l'API o la funzione da richiamare e aver ricevuto i parametri necessari. Scegliete una delle seguenti opzioni:

   • Creazione rapida di una nuova funzione Lambda (scelta consigliata): consenti ad Amazon Bedrock di creare una funzione Lambda di base per il tuo agente che potrai modificare successivamente in AWS Lambda base al tuo caso d'uso. L'agente passerà l'API o la funzione che prevede e i parametri, in base alla sessione, alla funzione Lambda.

   • Seleziona una funzione Lambda esistente: scegli una funzione Lambda creata in precedenza AWS Lambda e la versione della funzione da utilizzare. L'agente passerà l'API o la funzione che prevede e i parametri, in base alla sessione, alla funzione Lambda.

     Nota

     Per consentire al responsabile del servizio Amazon Bedrock di accedere alla funzione Lambda, collega una policy basata sulle risorse alla funzione Lambda per consentire al responsabile del servizio Amazon Bedrock di accedere alla funzione Lambda.

   • Controllo dei ritorni: anziché passare i parametri per l'API o la funzione che prevede alla funzione Lambda, l'agente restituisce il controllo all'applicazione passando l'azione che prevede debba essere richiamata, oltre ai parametri e alle informazioni per l'azione che ha determinato dalla sessione, nella risposta. InvokeAgent Per ulteriori informazioni, consulta Restituisci il controllo allo sviluppatore dell'agente inviando le informazioni richieste in una InvokeAgent risposta.

8. A seconda della scelta del tipo di gruppo Action, verrà visualizzata una delle seguenti sezioni:

   • Se hai selezionato Definisci con i dettagli della funzione, avrai una sezione dedicata alle funzioni del gruppo di azioni. Effettuate le seguenti operazioni per definire la funzione:

     1. Fornite un nome e una descrizione facoltativa (ma consigliata).

     2. Nella sottosezione Parametri, scegli Aggiungi parametro. Definite i seguenti campi:

        Campo	Descrizione
        Nome	Assegna un nome al parametro.
        Descrizione (facoltativa)	Descrivi il parametro.
        Type	Specificare il tipo di dati del parametro.
        Richiesto	Specificate se l'agente richiede il parametro all'utente.

     3. Per aggiungere un altro parametro, scegliete Aggiungi parametro.

     4. Per modificare un campo in un parametro, selezionate il campo e modificatelo se necessario.

     5. Per eliminare un parametro, scegliete l'icona di eliminazione ( ) nella riga contenente il parametro.

     Se preferite definire la funzione utilizzando un oggetto JSON, scegliete l'editor JSON anziché Table. Il formato dell'oggetto JSON è il seguente (ogni chiave nell'parametersoggetto è un nome di parametro fornito dall'utente):

     {
         "name": "string",
         "description": "string",
         "parameters": [
             {
                 "name": "string",
                 "description": "string",
                 "required": "True" | "False",
                 "type": "string" | "number" | "integer" | "boolean" | "array"
             }
         ]
     }

     Per aggiungere un'altra funzione al gruppo di azioni definendo un altro set di parametri, scegliete Aggiungi funzione di gruppo di azioni.

   • Se hai selezionato Definisci con schemi API, avrai una sezione Schema del gruppo di azioni con le seguenti opzioni:

     • Per utilizzare uno schema OpenAPI preparato in precedenza con descrizioni, strutture e parametri API per il gruppo di azioni, seleziona Seleziona schema API e fornisci un link all'URI Amazon S3 dello schema.

     • Per definire lo schema OpenAPI con l'editor di schemi in linea, seleziona Definisci tramite editor di schemi in linea. Viene visualizzato uno schema di esempio che puoi modificare.

       1. Seleziona il formato per lo schema utilizzando il menu a discesa accanto a Formato.

       2. Per importare uno schema esistente da S3 per modificarlo, seleziona Importa schema, fornisci l'URI S3 e seleziona Importa.

       3. Per ripristinare lo schema allo schema di esempio originale, seleziona Reimposta, quindi conferma il messaggio visualizzato selezionando nuovamente Reimposta.

9. Quando hai finito di creare il gruppo di azioni, scegli Aggiungi. Se hai definito uno schema API, se non ci sono problemi, viene visualizzato un banner verde di successo. In caso di problemi durante la convalida dello schema, viene visualizzato un banner rosso. Sono disponibili le seguenti opzioni:

   • Scorri lo schema per visualizzare le righe in cui è presente un errore o un avviso sulla formattazione. Una X indica un errore di formattazione, mentre un punto esclamativo indica un avviso sulla formattazione.

   • Seleziona Visualizza dettagli nel banner rosso per visualizzare un elenco di errori relativi al contenuto dello schema API.

10. Assicurati di preparare ad applicare le modifiche che hai apportato all'agente prima di testarlo.