InvokeAgent 응답에서 유도된 정보를 전송하여 에이전트 개발자에게 제어 반환 - Amazon Bedrock
에이전트 개발자에게 제어를 반환하는 예제

InvokeAgent 응답에서 유도된 정보를 전송하여 에이전트 개발자에게 제어 반환

에이전트가 사용자로부터 가져온 정보를 Lambda 함수로 전송하여 이행하는 대신 InvokeAgent 응답의 정보를 전송하여 에이전트 개발자에게 제어를 반환하도록 선택할 수 있습니다. 작업 그룹을 생성하거나 업데이트할 때 에이전트 개발자에 대한 제어 반환을 구성할 수 있습니다. API를 통해 CreateAgentActionGroup 또는 UpdateAgentActionGroup 요청에서 actionGroupExecutor 객체의 customControl값으로 RETURN_CONTROL을 지정합니다. 자세한 내용은 Amazon Bedrock에서 에이전트에 작업 그룹 추가 단원을 참조하십시오.

사용자가 작업 그룹에 대한 제어 반환을 구성하고, 에이전트가 이 작업 그룹의 작업을 직접적으로 호출해야 한다고 결정한 경우, 사용자로부터 유도된 API 또는 함수 세부 정보가 고유한 invocationId와 함께 InvokeAgent 응답의 invocationInputs 필드에 반환됩니다. 그러면 다음 작업을 수행할 수 있습니다.

  • invocationInputs에 반환된 정보를 바탕으로, 사용자가 정의한 API 또는 함수를 간접적으로 호출하도록 애플리케이션을 설정합니다.

  • 애플리케이션의 간접 호출 결과를 sessionState 필드에서 다른 InvokeAgent 요청에 전송하여 에이전트에 컨텍스트를 제공합니다. InvokeAgent 응답에 반환된 것과 동일한 invocationId 및 actionGroup을 사용해야 합니다. 이 정보는 추가 오케스트레이션을 위한 컨텍스트로 사용하거나, 에이전트가 응답을 포맷할 수 있도록 사후 처리로 전송하거나, 에이전트의 사용자 응답에 직접 사용할 수 있습니다.

    참고

    sessionState 필드에 returnControlInvocationResults를 포함하면 inputText 필드가 무시됩니다.

작업 그룹을 만들면서 에이전트 개발자에 대한 제어 반환을 구성하는 방법을 알아보려면 Amazon Bedrock에서 에이전트에 작업 그룹 추가 섹션을 참조하세요.

에이전트 개발자에게 제어를 반환하는 예제

예를 들어, 다음과 같은 작업 그룹이 있을 수 있습니다.

  • 사용자가 여행 중에 즐길 액티비티를 찾는 데 도움이 되는 suggestActivities 작업이 포함된 PlanTrip 작업 그룹입니다. 이 작업의 description에는 This action suggests activities based on retrieved weather information이라는 설명이 있습니다.

  • getWeather 작업이 포함된 WeatherAPIs 작업 그룹은 사용자가 특정 위치의 날씨를 확인하는 데 도움이 됩니다. 이 작업의 필수 파라미터는 location 및 date입니다. 작업 그룹은 에이전트 개발자에 제어를 반환하도록 구성됩니다.

다음은 발생할 수 있는 가상의 시퀀스입니다.

  1. 사용자가 에이전트에게 What should I do today?라는 쿼리를 프롬프팅합니다. 이 쿼리는 InvokeAgent 요청의 inputText 필드에 전송됩니다.

  2. 에이전트는 suggestActivities 작업을 간접 호출해야 함을 인식하지만, 설명을 고려하면 먼저 suggestActivities 작업을 이행하는 데 도움이 되는 컨텍스트로 getWeather 작업을 간접 호출해야 한다고 예측합니다.

  3. 에이전트는 현재 date가 2024-09-15임을 알고 있지만, 날씨 정보를 가져오려면 필수 파라미터로 사용자의 location이 필요합니다. 에이전트가 “지금 계신 위치가 어디인가요?”라는 질문으로 사용자를 다시 프롬프팅합니다.

  4. 사용자가 Seattle이라고 응답합니다.

  5. 에이전트는 다음 InvokeAgent 응답에서 getWeather에 대한 파라미터를 반환합니다(해당 메서드로 정의된 작업 그룹의 예제를 보려면 아래 탭을 선택).

    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. 애플리케이션은 이러한 파라미터를 사용하여 2024-09-15 날짜의 seattle 날씨를 가져오도록 구성되어 있습니다. 비 예보가 있다는 정보가 확인됩니다.

  7. 사용자는 이전 응답과 동일한 invocationId, actionGroup, function을 사용하여 다른 InvokeAgent 요청의 sessionState 필드에 이러한 결과를 보냅니다. 아래 탭을 선택하여 해당 메서드로 정의된 작업 그룹의 예제를 확인하세요.

    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. 에이전트는 suggestActivities 작업을 직접 호출해야 한다고 예측합니다. 당일 비가 오는 컨텍스트를 사용하여 응답에서 사용자에게 실외 활동이 아닌 실내 활동을 제안합니다.