alibabacloud-pds-multimodal-search

PDS 多模态搜索

请仔细阅读本文档的全部内容

功能

• 获取 drive/drive_id、查询企业空间、团队空间和个人空间 → 阅读 references/drive.md
• 将本地文件上传到企业空间、团队空间和个人空间 → 阅读 references/upload-file.md
• 将企业空间、团队空间和个人空间中的文件下载到本地 → 阅读 references/download-file.md
• 搜索或查找文件 → 阅读 references/search-file.md
• 在云盘上分析、快速查看和总结文档/音频/视频 → 阅读 references/multianalysis-file.md
• 图像搜索、相似图像搜索、图文混合检索 → 阅读 references/visual-similar-search.md

Agent 执行指南

• 必须按顺序执行步骤：不要跳过任何步骤，也不要在上一步完成前执行下一步。
• 必须遵循文档说明：aliyun pds cli 命令及参数必须遵循本文档的说明，不得编造命令。
• [必须] CLI User-Agent — 每次调用 aliyun CLI 命令都必须包含： --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search
• 文件操作前必须确定目标空间：搜索、上传、下载或分析之前，先判断用户明确指的是企业空间、团队空间、个人空间还是所有空间。
• 不得悄悄扩大空间范围：如果用户明确说“企业空间”，只能使用企业空间的 drive_id。如果用户明确说“团队空间”，只能使用匹配的团队空间 drive_id。如果用户明确说“个人空间”，只能使用个人空间的 drive_id。只有用户未限定范围时，才能跨多个空间搜索。
• 企业空间和团队空间不可互换：虽然 list-my-group-drive 会同时返回两者，但 root_group_drive 是企业空间，items 是团队空间。绝不能用其中一个替代另一个。
• 如果缺少所请求的空间，停止并说明：例如，如果用户要求企业空间，但 root_group_drive 为空，则不得改为搜索团队空间。

核心概念：

• 域：具有唯一 domain_id 的 PDS 实例，不同域之间的数据完全隔离
• 用户：域下的最终用户，具有 user_id
• 群组：域下的团队组织，分为企业群组和团队群组
• 云盘：存储空间，可属于用户（个人空间）或群组（企业空间或团队空间）
• 文件：空间下的文件或文件夹，具有 file_id
• 挂载应用：PDS 挂载应用插件，用于将 PDS 空间挂载到本地，方便用户访问和管理 PDS 空间中的文件

空间选择规则

选择 drive_id 前，请应用以下规则：

用户表述	允许的云盘来源	禁止的回退选项
"企业空间" / "company space" / "enterprise space"	仅 root_group_drive	items 中的任何云盘
"团队空间" / "某个团队空间" / "team space"	仅 items	root_group_drive
"个人空间" / "我的空间" / "personal space"	仅 list-my-drives.items	群组云盘
"网盘里" / "我的网盘" / 未指定空间	所有相关空间	无

继续之前，请进行简短的自检：

1. 用户是否明确指定了目标空间类型？
2. 选定的 drive_id 是否来自该空间类型对应的响应字段？
3. 如果存在多个团队空间，而用户只说了“团队空间”，是否需要进一步确认具体是哪一个团队空间？

如果任何一项无法确定，请勿猜测。

---

安装要求

前提条件：需要 Aliyun CLI >= 3.3.3

验证 CLI 版本：

aliyun version  # requires >= 3.3.3

如果尚未安装或版本过低， 请运行 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash 进行更新， 或参阅 references/cli-installation-guide.md 获取安装说明。

验证 PDS 插件版本：

aliyun pds version  # requires >= 0.1.4

安装后，必须启用插件自动安装：

aliyun configure set --auto-plugin-install true

然后[必须]运行 aliyun plugin update，确保本地机器上的所有现有插件始终保持最新。

---

CLI 初始化（必须在核心工作流之前运行）

在核心工作流开始时（调用任何 CLI 之前）：

[必须]启用 AI-Mode — 执行 Agent Skill 需要 AI-mode。 在调用任何 CLI 之前运行以下命令：

aliyun configure ai-mode enable
aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search"

[必须]在每个退出点禁用 AI-Mode — 无论出于何种原因，在给出最终回复之前，都必须先禁用 AI-mode。此要求适用于所有退出路径：工作流成功、工作流失败、出错/异常、用户取消、会话结束，或任何不会再执行 CLI 命令的其他情形。 AI-mode 仅用于调用 Agent Skill 的场景，Skill 停止运行后不得保持启用状态。

aliyun configure ai-mode disable

---

身份验证配置

前提条件：必须已配置 Alibaba Cloud 凭证

安全规则：

• 禁止读取、输出或打印 AK/SK 值（例如，禁止使用 echo $ALIBABA_CLOUD_ACCESS_KEY_ID）
• 禁止要求用户在对话或命令行中直接输入 AK/SK
• 禁止使用 aliyun configure set 设置明文凭证
• 仅允许使用 aliyun configure list 检查凭证状态

检查凭证配置：

aliyun configure list

确认输出显示有效的配置文件（AK、STS 或 OAuth 身份）。

如果没有有效配置，请先停止。

1. 从 Alibaba Cloud Console 获取凭证
2. 在此会话之外配置凭证（在终端中运行 aliyun configure 或设置环境变量）
3. 配置完成后运行 aliyun configure list 进行验证

# Install Aliyun CLI (if not installed)
curl -fsSL --max-time 10 https://aliyuncli.alicdn.com/install.sh | bash
aliyun version  # confirm >= 3.3.3

# Enable auto plugin installation
aliyun configure set --auto-plugin-install true

# Install Python dependencies (for multipart upload script)
pip3 install requests

PDS 专属配置

执行任何 PDS 操作之前，必须先配置 domain_id、user_id 和身份验证类型 -> 阅读 references/config.md

[必须] CLI User-Agent — 每次调用 aliyun CLI 命令时都必须包含 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search

示例：

aliyun pds get-user --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search
aliyun pds list-my-drives --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search
aliyun pds upload-file --drive-id <id> --local-path <path> --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search

参考资料

参考文档	路径
CLI 安装指南	references/cli-installation-guide.md
RAM 权限策略	references/ram-policies.md

错误处理

1. 如果文件搜索失败，请阅读 references/search-file.md，并严格遵循其中记录的流程重新执行文件搜索。