Restituisci il controllo allo sviluppatore dell'agente inviando le informazioni richieste in una InvokeAgent risposta

Invece di inviare le informazioni che il tuo agente ha ottenuto dall'utente a una funzione Lambda per l'adempimento, puoi scegliere di restituire il controllo allo sviluppatore dell'agente inviando le informazioni nella risposta. InvokeAgent È possibile configurare il ritorno del controllo allo sviluppatore dell'agente durante la creazione o l'aggiornamento di un gruppo di azioni. Tramite l'API, si specifica RETURN_CONTROL come customControl valore nell'actionGroupExecutoroggetto in una UpdateAgentActionGrouprichiesta CreateAgentActionGroupor. Per ulteriori informazioni, consulta Aggiungi un gruppo d'azione al tuo agente in Amazon Bedrock.

Se configurate il ritorno al controllo per un gruppo di azioni e se l'agente stabilisce che deve richiamare un'azione in questo gruppo di azioni, i dettagli dell'API o della funzione rilevati dall'utente verranno restituiti nel invocationInputs campo della InvokeAgentrisposta, insieme a un valore univocoinvocationId. A questo punto puoi effettuare le seguenti operazioni:

• Configura l'applicazione per richiamare l'API o la funzione che hai definito, a condizione che vengano restituite le informazioni restituite in. invocationInputs

• Invia i risultati della chiamata dell'applicazione in un'altra InvokeAgentrichiesta, sul sessionState campo, per fornire un contesto all'agente. È necessario utilizzare lo stesso invocationId valore actionGroup restituito nella InvokeAgentrisposta. Queste informazioni possono essere utilizzate come contesto per un'ulteriore orchestrazione, inviate alla post-elaborazione affinché l'agente formatti una risposta o utilizzate direttamente nella risposta dell'agente all'utente.

  Nota

  Se lo includi returnControlInvocationResults nel sessionState campo, il inputText campo verrà ignorato.

Per informazioni su come configurare il ritorno del controllo allo sviluppatore dell'agente durante la creazione del gruppo di azioni, consultaAggiungi un gruppo d'azione al tuo agente in Amazon Bedrock.

Esempio di restituzione del controllo allo sviluppatore dell'agente

Ad esempio, potresti avere i seguenti gruppi di azione:

• Un gruppo di PlanTrip azioni con un'suggestActivitiesazione che aiuta gli utenti a trovare le attività da svolgere durante un viaggio. Il description motivo per questa azione diceThis action suggests activities based on retrieved weather information.

• Un gruppo di WeatherAPIs azione con un'getWeatherazione che aiuta l'utente a conoscere le condizioni meteorologiche per una località specifica. I parametri richiesti per l'azione sono location edate. Il gruppo di azioni è configurato per restituire il controllo allo sviluppatore dell'agente.

Di seguito è riportata una sequenza ipotetica che potrebbe verificarsi:

1. L'utente richiede all'agente la seguente domanda: What should I do today? Questa richiesta viene inviata nel inputText campo di una richiesta. InvokeAgent

2. L'agente riconosce che l'suggestActivitiesazione deve essere invocata, ma, data la descrizione, prevede che debba prima richiamare l'getWeatherazione come contesto per contribuire alla realizzazione dell'azione. suggestActivities

3. L'agente sa che la corrente date esiste2024-09-15, ma ha bisogno location dell'utente come parametro obbligatorio per conoscere le condizioni meteorologiche. Richiede all'utente la domanda «Dove ti trovi?»

4. L'utente risponde. Seattle

5. L'agente restituisce i parametri per getWeather la seguente InvokeAgentrisposta (seleziona una scheda per vedere esempi di un gruppo di azioni definito con quel metodo):

   Function details

   HTTP/1.1 200
   x-amzn-bedrock-agent-content-type: application/json
   x-amz-bedrock-agent-session-id: session0
   Content-type: application/json
    
   {
       "returnControl": {
           "invocationInputs": [{
               "functionInvocationInput": {
                   "actionGroup": "WeatherAPIs",
                   "function": "getWeather",
                   "parameters": [
                       {
                           "name": "location",
                           "type": "string",
                           "value": "seattle"
                       },
                       {
                           "name": "date",
                           "type": "string",
                           "value": "2024-09-15"
                       }
                   ]
               }
           }],
           "invocationId": "79e0feaa-c6f7-49bf-814d-b7c498505172"
       }
   }

   OpenAPI schema

   HTTP/1.1 200
   x-amzn-bedrock-agent-content-type: application/json
   x-amz-bedrock-agent-session-id: session0
   Content-type: application/json
   
   {
       "invocationInputs": [{
           "apiInvocationInput": {
               "actionGroup": "WeatherAPIs",
               "apiPath": "/get-weather",
               "httpMethod": "get",
               "parameters": [
                   {
                       "name": "location",
                       "type": "string",
                       "value": "seattle"
                   },
                   {
                       "name": "date",
                       "type": "string",
                       "value": "2024-09-15"
                   }
               ]
           }
       }],
       "invocationId": "337cb2f6-ec74-4b49-8141-00b8091498ad"
   }

6. L'applicazione è configurata per utilizzare questi parametri per ottenere le condizioni meteorologiche seattle relative alla data2024-09-15. Il tempo è determinato a essere piovoso.

7. Questi risultati vengono inviati nel sessionState campo di un'altra InvokeAgentrichiesta, utilizzando la stessa invocationId e function come risposta precedente. actionGroup Seleziona una scheda per vedere esempi di un gruppo di azioni definito con quel metodo:

   Function details

   POST https://bedrock-agent-runtime.us-east-1.amazonaws.com/agents/AGENT12345/agentAliases/TSTALIASID/sessions/abb/text
               
   {
       "enableTrace": true,
       "sessionState": {
           "invocationId": "79e0feaa-c6f7-49bf-814d-b7c498505172",
           "returnControlInvocationResults": [{
               "functionResult": {
                   "actionGroup": "WeatherAPIs",
                   "function": "getWeather",
                   "responseBody": {
                       "TEXT": {
                           "body": "It's rainy in Seattle today."
                       }
                   }
               }
           }]
       }
   }

   OpenAPI schema

   POST https: //bedrock-agent-runtime.us-east-1.amazonaws.com/agents/AGENT12345/agentAliases/TSTALIASID/sessions/abb/text
    
   {
       "enableTrace": true,
       "sessionState": {
           "invocationId": "337cb2f6-ec74-4b49-8141-00b8091498ad",
           "returnControlInvocationResults": [{
               "apiResult": {
                   "actionGroup": "WeatherAPIs",
                   "httpMethod": "get",
                   "apiPath": "/get-weather",
                   "responseBody": {
                       "application/json": {
                           "body": "It's rainy in Seattle today."
                       }
                   }
               }
           }]
       }
   }

8. L'agente prevede che debba avviare l'suggestActivitiesazione. Utilizza il contesto in cui quel giorno piove e nella risposta suggerisce all'utente attività al chiuso anziché all'aperto.