기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
참고
세션 관리 APIs는 미리 보기 중이며 변경될 수 있습니다.
세션 관리 APIs를 사용하면 LangGraph 및 LlamaIndex와 같은 오픈 소스 프레임워크로 구축된 생성형 AI 애플리케이션에서 지속적인 대화를 위한 체크포인트를 저장할 수 있습니다. APIs를 사용하여 다단계 생성형 AI 워크플로에서 상태 및 대화 컨텍스트를 안전하게 관리할 수 있습니다. 상태 및 컨텍스트 지속성을 위해 사용자 지정 백엔드 솔루션을 구축, 유지 관리 또는 확장할 필요가 없습니다.
세션 관리 APIs를 사용하여 다음을 수행할 수 있습니다.
-
반복 테스트 및 human-in-the-loop 위한 체크포인트 워크플로 단계입니다.
-
중단 시점부터 대화와 작업을 재개합니다.
-
세션 로그를 검토하여 워크플로 단계를 분석하고 실패를 디버깅합니다.
세션은 Amazon Bedrock의 리소스이므로 AWS Identity and Access Management (IAM)을 사용하여 세션에 대한 액세스를 제어할 수 있습니다. 기본적으로 Amazon Bedrock은 세션 메타데이터를 포함한 세션 암호화에 AWS관리형 키를 사용하거나 자체 AWS KMS 키를 사용할 수 있습니다. 자세한 내용은 세션 암호화 단원을 참조하십시오.
Amazon Bedrock APIs 또는 AWS SDKs. LangGraph 기반 애플리케이션의 경우 langgraph_checkpoint_aws.saver
라이브러리의 BedrockSessionSaver
클래스를 사용할 수 있습니다. 이는 LangGraph CheckpointSaver의 사용자 지정 구현입니다. 자세한 내용은 LangChain
참고
세션을 사용하여 오픈 소스 프레임워크로 구축된 생성형 AI 애플리케이션의 상태 및 대화 기록을 저장합니다. Amazon Bedrock Agents의 경우 서비스는 대화 컨텍스트를 자동으로 관리하고 InvokeAgent API 작업에서 지정한 에이전트별 sessionId와 연결합니다.
주제
사용 사례 예제
고객이 여행 일정을 계획하는 데 도움이 되도록 LangGraph 에이전트를 사용하는 애플리케이션이 있을 수 있습니다. 사용자는이 에이전트와 대화를 시작하여 예정된 여행의 여정을 생성하고 목적지, 선호 호텔 및 항공편 세부 정보를 추가할 수 있습니다.
세션 관리 APIs를 사용하면 에이전트가 확장된 다단계 상호 작용 전반에 걸쳐 중간 상태 및 영구 컨텍스트를 저장할 수 있습니다. 에이전트는 Amazon Bedrock 세션을 사용하여 각 대상이 추가된 후 상태를 체크포인트하여 고객의 기본 설정에 대한 세부 정보를 보존할 수 있습니다.
대화가 중단되거나 실패하면 에이전트는 나중에 텍스트 및 이미지를 포함하여 컨텍스트가 그대로 유지된 상태로 세션을 재개할 수 있습니다. 이렇게 하면 고객이 정보를 반복할 필요 없이 에이전트가 계속할 수 있습니다. 또한 실패할 경우 세션 세부 정보를 조사하여 원인을 디버깅할 수 있습니다.
워크플로
세션 관리 APIs를 사용하는 워크플로는 다음과 같습니다. BedrockSessionSaver 라이브러리 사용에 대한 자세한 내용은 섹션을 참조하세요BedrockSessionSaver LangGraph 라이브러리를 사용하여 세션 관리.
-
세션 생성 - 최종 사용자가 대화를 처음 시작할 때 CreateSession API 작업을 사용하여 세션을 생성하고 세션의 ID를 지정합니다. 대화 상태를 저장하고 검색할 때이 ID를 사용합니다.
-
대화 및 컨텍스트 저장 - 최종 사용자가 생성형 AI 어시스턴트와 상호 작용할 때 CreateInvocation API를 사용하여 세션 내에서 상호 작용 그룹을 생성합니다. 각 호출에 대해 PutInvocationStep API 작업을 사용하여 각 상호 작용에 대해 텍스트 및 이미지를 포함한 세분화된 상태 체크포인트를 저장합니다.
-
대화 기록 및 컨텍스트 검색 - GetSession, ListInvocations 및 GetInvocationStep API 작업을 사용하여 세션 메타데이터 및 상호 작용 세부 정보를 검색합니다.
-
세션 종료 - 세션이 완료되면 EndSession API 작업으로 세션을 종료합니다. 세션을 종료한 후에도 여전히 해당 콘텐츠에 액세스할 수 있지만를 추가할 수는 없습니다. 세션과 해당 콘텐츠를 삭제하려면 DeleteSession API 작업을 사용합니다.
고려 사항
세션을 생성하고 관리하기 전에 다음 사항에 유의하세요.
-
Amazon Bedrock APIs 및 AWS SDKs. AWS 관리 콘솔을 사용하여 세션을 관리할 수 없습니다.
-
LangGraph 기반 에이전트 애플리케이션의 경우
langchain-aws
라이브러리의BedrockSessionSaver
클래스를 사용할 수 있습니다. 이는 LangGraph CheckpointSaver의 사용자 지정 구현입니다. BedrockSessionSaver 라이브러리 사용에 대한 자세한 내용은 섹션을 참조하세요BedrockSessionSaver LangGraph 라이브러리를 사용하여 세션 관리. 코드를 직접 보려면 LangChainGitHub 리포지토리의 langgraph-checkpoint-aws 를 참조하세요. -
세션을 생성할 때 고객 관리형 AWS KMS 키를 지정하는 경우 세션을 생성하는 사용자 또는 역할에 키를 사용할 권한이 있어야 합니다. 자세한 설명은 세션 암호화 섹션을 참조하세요.
-
세션 관리 APIs에는 다음과 같은 할당량이 있습니다.
-
모든 호출에서 세션의 호출 단계 수 - 1000
-
각 호출 단계의 최대 크기 - 50MB
-
IdleSession 제한 시간 – 1시간
-
보존 기간 - 세션 데이터는 30일 후에 자동으로 삭제됩니다.
-