为 Identity 提供独立的持久化存储空间，用于保存和跨 Session 复用文件。同一 Identity 的不同 Template 和 Session 可共享其中的文件。
Drive 目前为 Beta 功能，接口定义、响应结构和行为可能发生变化。请关注文档更新，并在生产环境使用前完成兼容性验证。
开启使用
支持通过 API 管理 Drive，或启用托管工具供 Agent 使用。
- API：支持查询、上传、下载、删除文件和清空存储空间。
- 托管工具：创建或更新 Template 时，在
managed_tool_config.enabled_tools中加入drive，随后使用该 Template 为目标 Identity 创建 Session。
enabled_tools 为完整启用列表，更新时应保留其他需要启用的托管工具。
- Agent 使用 Drive 的完整能力需同时启用 DeliverArtifacts。
- 直接调用 Drives API 不依赖 Template 的 Drive 工具开关或 DeliverArtifacts。
- Drive 用于文件的持久化存储与跨 Session 复用，DeliverArtifacts 用于单次向用户交付文件。
托管工具
开启 Drive 后，Agent 可使用以下工具，操作范围为当前 Session 所属 Identity 的 Drive。
| 工具 | 功能 |
|---|---|
list_drive_entries | 查询 Drive 中的文件和子目录。 |
add_drive_file | 将当前 Session 已交付的文件保存到 Drive。 |
mount_drive_file | 将 Drive 文件挂载到当前 Session，供 Agent 读取和处理。 |
delete_drive_entry | 删除 Drive 中的指定文件或目录。 |
使用流程
- 启用能力：为 Template 开启 Drive，并确保 DeliverArtifacts 可用。
- 创建会话：使用该 Template 创建 Session。
- 保存文件：将 Agent 生成的文件保存到 Drive。
- 读取文件：在同一 Identity 的 Session 中，查找并挂载已保存的文件，用于读取和处理。