除了使用代理的一般说明之外,本页还介绍了特定于 AdkApp
的功能。
准备工作
本教程假定您已阅读并遵循以下说明:
- 开发 Agent Development Kit 代理:将
agent
作为AdkApp
的实例进行开发。 - 用户身份验证,以用户身份进行身份验证,以便查询代理。
支持的操作
AdkApp
支持以下操作:
stream_query
:用于对查询的响应进行流式传输。create_session
:用于创建新会话。list_sessions
:用于列出可用的会话。get_session
:用于检索特定会话。delete_session
:用于删除特定会话。
如需列出所有受支持的操作,请运行以下命令:
import pprint
pprint.pprint(remote_app.operation_schemas())
管理会话
将智能体部署到 Vertex AI Agent Engine 后,AdkApp
会使用基于云的托管式会话。本部分介绍了如何使用受管理的会话。
创建会话
如需为用户创建会话,请执行以下操作:
session = remote_app.create_session(user_id="USER_ID")
其中 USER_ID 是用户定义的 ID,字符数限制为 128。
列出会话
如需列出用户的会话,请执行以下操作:
remote_app.list_sessions(user_id="USER_ID")
其中 USER_ID 是用户定义的 ID,字符数限制为 128。
获取会话
如需获取特定会话,您需要同时提供用户 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)