추출된 정보를 응답으로 전송하여 에이전트 개발자에게 제어권을 반환합니다. InvokeAgent - Amazon Bedrock
에이전트 개발자에게 제어권을 반환하는 예시

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

추출된 정보를 응답으로 전송하여 에이전트 개발자에게 제어권을 반환합니다. InvokeAgent

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

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

  • 에서 반환된 정보를 제공하면 정의한 API 또는 함수를 호출하도록 애플리케이션을 설정하십시오. invocationInputs

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

    참고

    returnControlInvocationResultssessionState필드에 포함하는 경우 해당 필드는 inputText 무시됩니다.

작업 그룹을 만드는 동안 에이전트 개발자에게 제어권을 반환하도록 구성하는 방법을 알아보려면 을 참조하십시오Amazon Bedrock에서 에이전트에 작업 그룹 추가.

에이전트 개발자에게 제어권을 반환하는 예시

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

  • 사용자가 여행 중에 할 활동을 찾는 데 도움이 되는 활동이 포함된 PlanTrip suggestActivities 작업 그룹입니다. 이 작업에 description 대한 내용은 다음과 같습니다This action suggests activities based on retrieved weather information.

  • 사용자가 특정 위치의 날씨를 파악할 수 있도록 도와주는 getWeather 액션이 포함된 WeatherAPIs 액션 그룹입니다. 액션의 필수 매개변수는 location 및 date 입니다. 작업 그룹은 에이전트 개발자에게 제어권을 반환하도록 구성되어 있습니다.

발생할 수 있는 가상의 순서는 다음과 같습니다.

  1. 사용자가 상담원에게 다음과 같은 질문을 던집니다. What should I do today? 이 쿼리는 요청 inputText 필드로 전송됩니다. InvokeAgent

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

  3. date에이전트는 현재 상황을 알고 있지만 2024-09-15 날씨를 파악하기 위한 필수 매개변수로 사용자의 정보가 필요합니다. location 그러면 사용자에게 “현재 어디에 계십니까?” 라는 질문을 다시 묻는 메시지가 나타납니다.

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

  5. 에이전트는 다음 getWeather InvokeAgent응답에서 매개 변수를 반환합니다. 탭을 선택하면 해당 메서드로 정의된 작업 그룹의 예를 볼 수 있습니다.

    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. 이 결과를 이전 응답과 function 동일한 invocationIdactionGroup, 를 사용하여 다른 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 작업을 호출해야 한다고 예측합니다. 응답에서는 그날 비가 온다는 컨텍스트를 사용하여 사용자에게 실외 대신 실내 활동을 제안해 줍니다.