이 페이지에서는 에이전트 사용을 위한 일반 안내 외에도 AdkApp
와 관련된 기능을 설명합니다.
시작하기 전에
이 튜토리얼에서는 사용자가 다음 안내를 읽고 따랐다고 가정합니다.
- Agent Development Kit 에이전트 개발:
AdkApp
인스턴스로agent
를 개발합니다. - 사용자 인증: 에이전트 쿼리를 위해 사용자로 인증을 수행합니다.
지원되는 작업
AdkApp
에 지원되는 작업은 다음과 같습니다.
stream_query
: 쿼리에 대한 응답을 스트리밍합니다.create_session
: 새 세션을 만듭니다.list_sessions
: 사용 가능한 세션을 나열합니다.get_session
: 특정 세션을 검색합니다.delete_session
: 특정 세션을 삭제합니다.
지원되는 모든 작업을 나열하려면 다음 명령어를 실행합니다.
import pprint
pprint.pprint(remote_app.operation_schemas())
세션 관리
AdkApp
는 에이전트를 Vertex AI Agent Engine에 배포한 후 클라우드 기반 관리 세션을 사용합니다. 이 섹션에서는 관리형 세션을 사용하는 방법을 설명합니다.
세션 만들기
사용자의 세션을 만들려면 다음 단계를 따르세요.
session = remote_app.create_session(user_id="USER_ID")
여기서 USER_ID는 글자 수 제한이 128자인 사용자 정의 ID입니다.
세션 나열
사용자의 세션을 나열하려면 다음 단계를 따르세요.
remote_app.list_sessions(user_id="USER_ID")
여기서 USER_ID는 글자 수 제한이 128자인 사용자 정의 ID입니다.
세션 가져오기
특정 세션을 가져오려면 사용자 ID와 세션 ID가 모두 필요합니다.
session = remote_app.get_session(user_id="USER_ID", session_id="SESSION_ID")
세션 삭제
세션을 삭제하려면 사용자 ID와 세션 ID가 모두 필요합니다.
remote_app.delete_session(user_id="USER_ID", session_id="SESSION_ID")
쿼리에 대한 응답 스트리밍
세션에서 상담사의 응답을 스트리밍하려면 다음 단계를 따르세요.
for event in remote_app.stream_query(
user_id="USER_ID",
session_id="SESSION_ID", # Optional
message="What is the exchange rate from US dollars to SEK today?",
):
print(event)