쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

세션 관리 APIs 사용하여 대화 기록 및 컨텍스트 저장 및 검색

포커스 모드
세션 관리 APIs 사용하여 대화 기록 및 컨텍스트 저장 및 검색 - Amazon Bedrock

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

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

참고

세션 관리 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 GitHub 리포지토리의 langgraph-checkpoint-aws를 참조하세요.

참고

세션을 사용하여 오픈 소스 프레임워크로 구축된 생성형 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, ListInvocationsGetInvocationStep API 작업을 사용하여 세션 메타데이터 및 상호 작용 세부 정보를 검색합니다.

  • 세션 종료 - 세션이 완료되면 EndSession API 작업으로 세션을 종료합니다. 세션을 종료한 후에도 여전히 해당 콘텐츠에 액세스할 수 있지만를 추가할 수는 없습니다. 세션과 해당 콘텐츠를 삭제하려면 DeleteSession API 작업을 사용합니다.

고려 사항

세션을 생성하고 관리하기 전에 다음 사항에 유의하세요.

  • Amazon Bedrock APIs 및 AWS SDKs. AWS 관리 콘솔을 사용하여 세션을 관리할 수 없습니다.

  • LangGraph 기반 에이전트 애플리케이션의 경우 langchain-aws 라이브러리의 BedrockSessionSaver 클래스를 사용할 수 있습니다. 이는 LangGraph CheckpointSaver의 사용자 지정 구현입니다. BedrockSessionSaver 라이브러리 사용에 대한 자세한 내용은 섹션을 참조하세요BedrockSessionSaver LangGraph 라이브러리를 사용하여 세션 관리. 코드를 직접 보려면 LangChain GitHub 리포지토리의 langgraph-checkpoint-aws를 참조하세요.

  • 세션을 생성할 때 고객 관리형 AWS KMS 키를 지정하는 경우 세션을 생성하는 사용자 또는 역할에 키를 사용할 권한이 있어야 합니다. 자세한 설명은 세션 암호화 섹션을 참조하세요.

  • 세션 관리 APIs에는 다음과 같은 할당량이 있습니다.

    • 모든 호출에서 세션의 호출 단계 수 - 1000

    • 각 호출 단계의 최대 크기 - 50MB

    • IdleSession 제한 시간 – 1시간

    • 보존 기간 - 세션 데이터는 30일 후에 자동으로 삭제됩니다.

프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.