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à.
Aggiungi un gruppo d'azione al tuo agente in Amazon Bedrock
Dopo aver configurato il OpenAPI schema e funzione Lambda per il tuo gruppo di azioni, puoi creare il gruppo di azioni. Scegli la scheda relativa al tuo metodo preferito, quindi segui i passaggi:
Nota
Se stai usando Anthropic Claude 3.5 Sonnet, assicuratevi che il nome dell'utensile, che sarà nella forma, httpVerb__actionGroupName__apiName
segua il formato ^[a-zA-Z0-9_-]{1,64}$
del nome dello strumento Anthropic. Il tuo nome actionGroupName e quello di APIname non devono contenere caratteri di sottolineatura doppi. '__'
- Console
-
Quando crei un agente, puoi aggiungere gruppi di azioni alla bozza di lavoro.
Dopo aver creato un agente, potete aggiungervi gruppi di azioni effettuando le seguenti operazioni:
Per aggiungere un gruppo di azioni a un agente
-
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/
-
Seleziona Agenti dal riquadro di navigazione a sinistra. Quindi, scegli un agente nella sezione Agenti.
-
Scegli Modifica in Agent Builder.
-
Nella sezione Gruppi di azioni, scegli Aggiungi.
-
(Facoltativo) Nella sezione Dettagli del gruppo di azioni, modifica il nome generato automaticamente e fornisci una descrizione facoltativa per il tuo gruppo di azioni.
-
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:
-
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.
-
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 Definire OpenAPI schemi per i gruppi di azioni del tuo agente in Amazon Bedrock
-
-
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 determinata dalla sessione, nel InvokeAgentrisposta. Per ulteriori informazioni, consulta Restituisci il controllo allo sviluppatore dell'agente inviando le informazioni richieste in una InvokeAgent risposta.
-
-
A seconda della scelta del tipo di gruppo Azione, 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:
-
Fornite un nome e una descrizione facoltativa (ma consigliata).
-
Per richiedere la conferma all'utente prima che la funzione venga richiamata, seleziona Enabled. La richiesta di conferma prima di richiamare la funzione può impedire all'applicazione di intraprendere azioni dovute a iniezioni tempestive dolose.
-
Nella sottosezione Parametri, scegli Aggiungi parametro. Definite i seguenti campi:
Campo Descrizione Nome Assegna un nome al parametro. Descrizione (facoltativa) Descrivi il parametro. Tipo Specificare il tipo di dati del parametro. Richiesto Specificate se l'agente richiede il parametro all'utente. -
Per aggiungere un altro parametro, scegliete Aggiungi parametro.
-
Per modificare un campo in un parametro, selezionate il campo e modificatelo se necessario.
-
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'
parameters
oggetto è 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.
-
Seleziona il formato per lo schema utilizzando il menu a discesa accanto a Formato.
-
Per importare uno schema esistente da S3 per modificarlo, seleziona Importa schema, fornisci l'URI S3 e seleziona Importa.
-
Per ripristinare lo schema allo schema di esempio originale, seleziona Reimposta, quindi conferma il messaggio visualizzato selezionando nuovamente Reimposta.
-
-
-
-
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.
-
-
Assicurati di preparare ad applicare le modifiche che hai apportato all'agente prima di testarlo.
-
- API
-
Per creare un gruppo d'azione, invia un CreateAgentActionGrouprichiesta con un endpoint di build Agents for Amazon Bedrock. È necessario fornire uno schema di funzioni o uno schema OpenAPI.
L'elenco seguente descrive i campi della richiesta:
-
I seguenti campi sono obbligatori:
Campo Breve descrizione agentId L'ID dell'agente a cui appartiene il gruppo di azione. agentVersion La versione dell'agente a cui appartiene il gruppo di azioni. actionGroupName Il nome del gruppo di azione. -
Per definire i parametri per il gruppo di azioni, è necessario specificare uno dei seguenti campi (non è possibile specificare entrambi).
Campo Breve descrizione Schema delle funzioni Definisce i parametri per il gruppo di azioni che l'agente richiede all'utente. Per ulteriori informazioni, consulta Definisci i dettagli delle funzioni per i gruppi di azione del tuo agente in Amazon Bedrock. Schema API Specifica lo schema OpenAPI che definisce i parametri per il gruppo di azioni o i collegamenti a un oggetto S3 che lo contiene. Per ulteriori informazioni, consulta Definire OpenAPI schemi per i gruppi di azioni del tuo agente in Amazon Bedrock. Di seguito viene illustrato il formato generale di e:
functionSchema
apiSchema
-
Ogni elemento dell'
functionSchema
array è un FunctionSchemaoggetto. Per ogni funzione, specificare quanto segue:-
Fornisci un
name
valore facoltativo (ma consigliato)description
. -
Facoltativamente, specificare
ENABLED
ilrequireConfirmation
campo per richiedere la conferma all'utente prima che la funzione venga richiamata. La richiesta di conferma prima di richiamare la funzione può proteggere l'applicazione dall'intraprendere azioni dovute a iniezioni tempestive dannose. -
Nell'
parameters
oggetto, ogni chiave è un nome di parametro, mappato ai dettagli relativi all'oggetto. ParameterDetail
Il formato generale di
functionSchema
è il seguente:"functionSchema": [ { "name": "string", "description": "string", "requireConfirmation": ENABLED | DISABLED, "parameters": { "
<string>
": { "type": "string" | number | integer | boolean | array, "description": "string", "required": boolean }, ... // up to 5 parameters } }, ... // up to 11 functions ] -
-
APISchemaPuò essere in uno dei seguenti formati:
-
Per il seguente formato, puoi incollare direttamente il formato JSON o YAML OpenAPI schema come valore.
"apiSchema": { "payload": "string" }
-
Per il formato seguente, specifica il nome del bucket Amazon S3 e la chiave dell'oggetto in cui OpenAPI lo schema è archiviato.
"apiSchema": { "s3": { "s3BucketName": "string", "s3ObjectKey": "string" } }
-
-
-
Per configurare il modo in cui il gruppo di azioni gestisce la chiamata del gruppo di azioni dopo aver ottenuto i parametri dall'utente, è necessario specificare uno dei seguenti campi all'interno del campo.
actionGroupExecutor
Campo Breve descrizione lambda Per inviare i parametri a una funzione Lambda per gestire i risultati della chiamata del gruppo di azioni, specifica l'Amazon Resource Name (ARN) di Lambda. Per ulteriori informazioni, consulta Configura le funzioni Lambda per inviare informazioni che un agente Amazon Bedrock riceve dall'utente. Controllo personalizzato Per ignorare l'utilizzo di una funzione Lambda e restituire invece il gruppo di azioni previsto, oltre ai parametri e alle informazioni richiesti, InvokeAgent
nella risposta, specificare.RETURN_CONTROL
Per ulteriori informazioni, consulta Restituisci il controllo allo sviluppatore dell'agente inviando le informazioni richieste in una InvokeAgent risposta. -
I seguenti campi sono facoltativi:
Campo Breve descrizione parentActionGroupFirma AMAZON.UserInput
Specificare per consentire all'agente di richiedere nuovamente all'utente ulteriori informazioni se non dispone di informazioni sufficienti per completare un altro gruppo di azioni. È necessario lasciare vuotiactionGroupExecutor
i campidescription
apiSchema
, e se si specifica questo campo.description Una descrizione del gruppo di azioni. actionGroupState Se consentire o meno all'agente di richiamare il gruppo di azioni. clientToken Un identificatore per impedire la duplicazione delle richieste.
-