Amazon Bedrock 에이전트가 사용자로부터 유도한 정보를 보내도록 Lambda 함수 구성

입력 이벤트 - API 작업의 요청 본문 또는 에이전트가 직접적으로 호출해야 한다고 결정하는 작업에 대한 함수 파라미터의 관련 메타데이터 및 채워진 필드를 포함합니다.

응답 - API 작업 또는 함수에서 반환된 응답 본문에 대한 관련 메타데이터 및 채워진 필드를 포함합니다.

API 스키마로 작업 그룹을 정의한 경우 입력 이벤트 형식은 다음과 같습니다.

{
    "messageVersion": "1.0",
    "agent": {
        "name": "string",
        "id": "string",
        "alias": "string",
        "version": "string"
    },
    "inputText": "string",
    "sessionId": "string",
    "actionGroup": "string",
    "apiPath": "string",
    "httpMethod": "string",
    "parameters": [
        {
            "name": "string",
            "type": "string",
            "value": "string"
        },
    ...
    ],
    "requestBody": {
        "content": {
            "<content_type>": {
                "properties": [
                   {
                       "name": "string",
                       "type": "string",
                       "value": "string"
                    },
                            ...
                ]
            }
        }
    },
    "sessionAttributes": {
        "string": "string",
    },
    "promptSessionAttributes": {
        "string": "string"
    }
}

함수 세부 정보로 작업 그룹을 정의한 경우 입력 이벤트 형식은 다음과 같습니다.

{
    "messageVersion": "1.0",
    "agent": {
        "name": "string",
        "id": "string",
        "alias": "string",
        "version": "string"
    },
    "inputText": "string",
    "sessionId": "string",
    "actionGroup": "string",
    "function": "string",
    "parameters": [
        {
            "name": "string",
            "type": "string",
            "value": "string"
        },
    ...
    ],
    "sessionAttributes": {
        "string": "string",
    },
    "promptSessionAttributes": {
        "string": "string"
    }
}

messageVersion - Lambda 함수로 이동하는 이벤트 데이터의 형식과 Lambda 함수에서 나올 것으로 예상되는 응답 형식을 식별하는 메시지 버전입니다. Amazon Bedrock은 버전 1.0만 지원합니다.

agent - 작업 그룹이 속한 에이전트의 이름, ID, 별칭 및 버전에 대한 정보가 들어 있습니다.

inputText - 대화 턴에 대한 사용자 입력입니다.

sessionId - 에이전트 세션의 고유 식별자입니다.

actionGroup - 작업 그룹의 이름입니다.

parameters - 객체 목록을 포함합니다. 각 객체에는 OpenAPI 스키마 또는 함수에 정의된 대로 API 작업의 파라미터 이름, 유형 및 값이 포함됩니다.

API 스키마로 작업 그룹을 정의한 경우 입력 이벤트에는 다음 필드가 포함됩니다.

함수 세부 정보로 작업 그룹을 정의한 경우 입력 이벤트에는 다음 필드가 포함됩니다.

sessionAttributes - 세션 속성 및 해당 값을 포함합니다. 이러한 속성은 세션에 저장되며 에이전트에 컨텍스트를 제공합니다.

promptSessionAttributes - 프롬프트 세션 속성 및 해당 값을 포함합니다. 이러한 속성은 대화를 한 번 주고받을 때마다 저장되며 에이전트에 컨텍스트를 제공합니다.

API 스키마로 작업 그룹을 정의한 경우 응답 형식은 다음과 같습니다.

{
    "messageVersion": "1.0",
    "response": {
        "actionGroup": "string",
        "apiPath": "string",
        "httpMethod": "string",
        "httpStatusCode": number,
        "responseBody": {
            "<contentType>": {
                "body": "JSON-formatted string" 
            }
        }
    },
    "sessionAttributes": {
        "string": "string",
        ...
    },
    "promptSessionAttributes": {
        "string": "string",
        ...
    },
    "knowledgeBasesConfiguration": [
        {
            "knowledgeBaseId": "string",
            "retrievalConfiguration": {
                "vectorSearchConfiguration": {
                    "numberOfResults": int,
                    "overrideSearchType": "HYBRID | SEMANTIC",
                    "filter": RetrievalFilter object
                }
            }
        },
        ...
    ]
}

함수 세부 정보로 작업 그룹을 정의한 경우 응답 형식은 다음과 같습니다.

{
    "messageVersion": "1.0",
    "response": {
        "actionGroup": "string",
        "function": "string",
        "functionResponse": {
            "responseState": "FAILURE | REPROMPT",
            "responseBody": {
                "<functionContentType>": { 
                    "body": "JSON-formatted string"
                }
            }
        }
    },
    "sessionAttributes": {
        "string": "string",
    },
    "promptSessionAttributes": {
        "string": "string"
    },
    "knowledgeBasesConfiguration": [
        {
            "knowledgeBaseId": "string",
            "retrievalConfiguration": {
                "vectorSearchConfiguration": {
                    "numberOfResults": int,
                    "filter": {
                        RetrievalFilter object
                    }
                }
            }
        },
        ...
    ]
}

messageVersion - Lambda 함수로 이동하는 이벤트 데이터의 형식과 Lambda 함수에서 나올 것으로 예상되는 응답 형식을 식별하는 메시지 버전입니다. Amazon Bedrock은 버전 1.0만 지원합니다.

response - API 응답에 대한 다음 정보를 포함합니다.

(선택 사항) sessionAttributes - 세션 속성 및 해당 값을 포함합니다. 자세한 내용은 세션 및 프롬프트 세션 속성 단원을 참조하십시오.

(선택 사항) promptSessionAttributes - 프롬프트 속성 및 해당 값을 포함합니다. 자세한 내용은 세션 및 프롬프트 세션 속성 단원을 참조하십시오.

(선택 사항) knowledgeBasesConfiguration - 에이전트에 연결된 지식 기반에 대한 쿼리 구성 목록을 포함합니다. 자세한 내용은 지식 기반 검색 구성 단원을 참조하십시오.