에이전트 플랫폼 세션은 사용자와 에이전트 간의 상호작용 기록을 유지합니다. 세션은 장기 메모리와 대화 컨텍스트의 명확한 소스를 제공합니다.
Agent Platform 세션을 사용하는 방법에는 여러 가지가 있습니다.
에이전트 개발 키트 (ADK): ADK 에이전트를 Gemini Enterprise Agent Platform에 배포하면 세션 관리가 자동으로 처리됩니다.
API 호출: ADK 에이전트를 사용하여 세션을 관리하지 않으려면 Agent Platform 세션에 직접 API를 호출하면 됩니다.
핵심 개념
세션: 세션은 사용자와 에이전트 시스템 간의 지속적인 단일 상호작용에 대한 메시지와 작업(이벤트)의 시간순 시퀀스를 나타냅니다.
이벤트: 이벤트는 대화 콘텐츠 및 함수 호출과 같은 에이전트에서 수행한 작업을 저장합니다. 이벤트는 커스텀 데이터와 다양한 프레임워크를 수용할 수 있는 유연한 스키마를 지원합니다.
상태: 상태는 현재 대화 중에만 관련된 임시 데이터를 보유합니다.
메모리: 메모리는 특정 사용자의 여러 세션에서 액세스할 수 있는 맞춤설정된 정보입니다. 에이전트는 메모리를 사용하여 사용자에 대한 응답을 맞춤설정하고 세션 간 연속성을 보장할 수 있습니다.
핵심 기능
에이전트 플랫폼 세션의 핵심 기능은 다음과 같습니다.
새 대화 시작: 사용자가 에이전트와 상호작용을 시작할 때 새 세션을 만듭니다.
기존 대화 재개: 에이전트가 일시중지된 대화를 재개할 수 있도록 특정 세션을 가져옵니다.
진행 상황 저장: 세션 기록에 새로운 상호작용(이벤트)을 추가하여 세션을 업데이트합니다.
대화 목록: 특정 사용자와 애플리케이션의 활성 세션 스레드를 찾습니다.
정리: 대화가 종료되거나 더 이상 필요하지 않으면 세션 객체와 연결된 데이터를 삭제합니다.
엔터프라이즈 보안 및 거버넌스
Agent Platform 세션은 무단 액세스 또는 데이터 무단 반출로부터 대화 기록, 세션 상태, 이벤트를 보호하는 데 도움이 되는 엔터프라이즈 보안 제어를 지원합니다.
VPC 서비스 제어 (VPC 서비스 제어)
에이전트 플랫폼 세션은 VPC 서비스 제어를 지원하여 세션 데이터 및 대화 이벤트의 데이터 무단 반출 위험을 완화합니다. sessions 및 events는 Agent Platform API (aiplatform.googleapis.com)를 통해 제공되는 Agent Runtime(reasoningEngines) 인스턴스의 하위 리소스이므로 VPC 서비스 제어 서비스 경계에 Agent Platform API를 추가하면 모든 세션 작업 (CreateSession, GetSession, ListSessions, UpdateSession, DeleteSession, AppendEvent, ListEvents)이 보호됩니다.
세션에 VPC 서비스 제어를 구성할 때는 다음 가이드라인을 따르세요.
- 경계 구성: Agent Platform API(
aiplatform.googleapis.com)를 VPC 서비스 제어 서비스 경계에 추가합니다. 세션을 호스팅하는 상위 Agent Runtime 인스턴스를 만들기 전에 프로젝트가 서비스 경계에 추가되었는지 확인합니다. - 비공개 엔드포인트 연결:
restricted.googleapis.com(199.36.153.4/30) 또는 Google API용 내부 Private Service Connect 엔드포인트를 통해 VPC 네트워크에서LOCATION-aiplatform.googleapis.com(또는 전역 엔드포인트의 경우aiplatform.googleapis.com)로 요청을 라우팅합니다. - 서비스 경계에서 Agent Gateway와 함께 세션 사용: Agent Runtime에 배포된 에이전트가 Agent-to-Anywhere (이그레스) 모드에서 시행 중인 Agent Gateway에 바인딩되면 에이전트에서 세션으로의 아웃바운드 API 호출이 게이트웨이를 통과합니다. 경계 또는 게이트웨이 차단을 방지하려면 다음 안내를 따르세요.
vpcEgress가ALL_TRAFFIC로 설정된 에이전트 연결 템플릿(AgentConnectivityTemplate)과googleapis.com.의 비공개 Cloud DNS 피어링을 사용하여 게이트웨이를 구성합니다. 자세한 내용은 Agent Gateway의 VPC 서비스 제어 규정 준수를 참조하세요.- 에이전트가 세션 엔드포인트(
https://LOCATION-aiplatform.googleapis.com/API_VERSION/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/sessions)를 호출할 수 있도록 에이전트 레지스트리에 리전 및 mTLSAgent Platform API엔드포인트를 등록하고 허용 목록에 추가하고 에이전트 ID에 IAP 이그레서 (roles/iap.egressor) 역할을 부여합니다. 단계별 안내는 Agent Gateway를 통해 Agent Runtime 트래픽 라우팅을 참조하세요.
고객 관리 암호화 키(CMEK)
기본적으로 Google Cloud 는 Google-owned and Google-managed encryption keys를 사용하여 저장 시 세션 상태 및 대화 이벤트를 암호화합니다. Cloud Key Management Service (Cloud KMS)에서 관리하는 키를 사용하여 세션 데이터를 보호하려면 상위 Agent Runtime 인스턴스를 만들 때 encryption_spec (kms_key_name)를 지정합니다. 해당 인스턴스에 저장된 모든 세션과 이벤트는 CMEK 구성을 상속합니다. 일반적인 프로젝트 및 키 설정 단계는 Gemini Enterprise Agent Platform의 CMEK를 참조하세요.
세션에 CMEK를 사용할 때는 다음 제한사항이 적용됩니다.
- 전역 엔드포인트 및 배포된 런타임 제한사항: Cloud Key Management Service에서는 암호화 키가 지리적 데이터 레지던시 경계 내에 있어야 하므로 세션이
global엔드포인트 (location="global")를 사용하도록 구성된 경우 CMEK를 사용할 수 없습니다. CMEK를 사용하려면 일치하는 Cloud KMS 키가 있는 지원되는 리전 또는 멀티 리전 위치에 에이전트 런타임 코드를 배포하지 않고 독립형 상위 인스턴스를 만듭니다. 멀티 리전 인스턴스의 경우us에는us키를,eu에는europe키를 사용합니다. 상위 인스턴스가 Agent Runtime에 에이전트를 배포하는 경우 단일 리전 위치를 사용해야 합니다. 배포된 런타임은 멀티 리전 엔드포인트(us또는eu)에서 CMEK를 지원하지 않기 때문입니다. - 암호화 키를 업데이트할 수 없음: Cloud KMS 키로 인스턴스를 만든 후에는 해당 인스턴스의 키를 변경할 수 없습니다. 다른 키를 사용하려면 새 인스턴스를 만들어야 합니다.