PDS Multimodal Search
Please read this entire skill document carefully
Features
- - For getting drive/drive_id, querying enterprise space, team space, personal space -> read INLINECODE0
- For uploading local files to enterprise space, team space, personal space → read INLINECODE1
- For downloading files from enterprise space, team space, personal space to local → read INLINECODE2
- For searching or finding files → read INLINECODE3
- For document/audio/video analysis, quick view, summarization on cloud drive → read INLINECODE4
- For image search, similar image search, image-text hybrid retrieval → read INLINECODE5
Agent Execution Guidelines
- - Must execute steps in order: Do not skip any step, do not proceed to the next step before the previous one is completed.
- Must follow documentation: The aliyun pds cli commands and parameters must follow this document's guidance, do not fabricate commands.
- Recommended parameter: All
aliyun pds commands should include --user-agent AlibabaCloud-Agent-Skills parameter to help server identify request source, track usage, and troubleshoot issues.
Core Concepts:
- - Domain: PDS instance with a unique domainid, data is completely isolated between domains
- User: End user under a domain, has userid
- Group: Team organization under a domain, divided into enterprise group and team group
- Drive: Storage space, can belong to a user (personal space) or team (team/enterprise space)
- File: File or folder under a space, has file_id
- Mountapp: PDS mount app plugin, used to mount PDS space to local, allowing users to access and manage files in PDS space conveniently
Installation Requirements
Prerequisites: Requires Aliyun CLI >= 3.3.1
Verify CLI version:
> aliyun version # requires >= 3.3.1
>
Verify PDS plugin version:
> aliyun pds version # requires >= 0.1.4
>
If version requirements are not met, refer to references/cli-installation-guide.md for installation or upgrade.
After installation, must enable auto plugin installation:
CODEBLOCK2
Authentication Configuration
Prerequisites: Alibaba Cloud credentials must be configured
Security Rules:
- - Forbidden to read, output, or print AK/SK values (e.g.,
echo $ALIBABA_CLOUD_ACCESS_KEY_ID is forbidden) - Forbidden to ask users to input AK/SK directly in conversation or command line
- Forbidden to use
aliyun configure set to set plaintext credentials - Only allowed to use
aliyun configure list to check credential status
Check credential configuration:
> aliyun configure list
>
Confirm the output shows a valid profile (AK, STS, or OAuth identity).
If no valid configuration exists, stop first.
- 1. Obtain credentials from Alibaba Cloud Console
- Configure credentials outside this session (run
aliyun configure in terminal or set environment variables) - Run
aliyun configure list to verify after configuration is complete
CODEBLOCK4
PDS-Specific Configuration
Before executing any PDS operations, you must first configure domainid, userid, and authentication type -> read INLINECODE14
Recommended parameter: All aliyun pds commands should include --user-agent AlibabaCloud-Agent-Skills parameter
Examples:
CODEBLOCK5
References
references/ram-policies.md |
Error Handling
- 1. If file search fails, please read
references/search-file.md and strictly follow the documented process to re-execute file search.
PDS 多模态搜索
请仔细阅读整个技能文档
功能特性
- - 获取空间/空间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
代理执行指南
- - 必须按顺序执行步骤:不要跳过任何步骤,在前一步完成之前不要进入下一步。
- 必须遵循文档:阿里云PDS CLI命令和参数必须遵循本文档的指导,不要编造命令。
- 推荐参数:所有 aliyun pds 命令应包含 --user-agent AlibabaCloud-Agent-Skills 参数,以帮助服务器识别请求来源、跟踪使用情况和排查问题。
核心概念:
- - 域:具有唯一domainid的PDS实例,不同域之间的数据完全隔离
- 用户:域下的最终用户,具有userid
- 组:域下的团队组织,分为企业组和团队组
- 空间:存储空间,可以属于用户(个人空间)或团队(团队/企业空间)
- 文件:空间下的文件或文件夹,具有file_id
- 挂载应用:PDS挂载应用插件,用于将PDS空间挂载到本地,方便用户访问和管理PDS空间中的文件
安装要求
前提条件:需要阿里云CLI >= 3.3.1
验证CLI版本:
bash
aliyun version # 需要 >= 3.3.1
验证PDS插件版本:
bash
aliyun pds version # 需要 >= 0.1.4
如果版本要求不满足,请参考 references/cli-installation-guide.md 进行安装或升级。
安装后,必须启用自动插件安装:
bash
aliyun configure set --auto-plugin-install true
认证配置
前提条件:必须配置阿里云凭证
安全规则:
- - 禁止读取、输出或打印AK/SK值(例如,禁止使用 echo $ALIBABACLOUDACCESSKEYID)
- 禁止要求用户在对话或命令行中直接输入AK/SK
- 禁止使用 aliyun configure set 设置明文凭证
- 仅允许使用 aliyun configure list 检查凭证状态
检查凭证配置:
bash
aliyun configure list
确认输出显示有效的配置文件(AK、STS或OAuth身份)。
如果没有有效配置,请先停止。
- 1. 从阿里云控制台获取凭证
- 在此会话之外配置凭证(在终端中运行 aliyun configure 或设置环境变量)
- 配置完成后运行 aliyun configure list 进行验证
bash
安装阿里云CLI(如果未安装)
curl -fsSL --max-time 10 https://aliyuncli.alicdn.com/install.sh | bash
aliyun version # 确认 >= 3.3.1
启用自动插件安装
aliyun configure set --auto-plugin-install true
安装Python依赖(用于分片上传脚本)
pip3 install requests
PDS特定配置
在执行任何PDS操作之前,必须先配置domainid、userid和认证类型 → 阅读 references/config.md
推荐参数:所有 aliyun pds 命令应包含 --user-agent AlibabaCloud-Agent-Skills 参数
示例:
bash
aliyun pds get-user --user-agent AlibabaCloud-Agent-Skills
aliyun pds list-my-drives --user-agent AlibabaCloud-Agent-Skills
aliyun pds upload-file --drive-id --local-path --user-agent AlibabaCloud-Agent-Skills
参考文档
references/ram-policies.md |
错误处理
- 1. 如果文件搜索失败,请阅读 references/search-file.md 并严格按照文档流程重新执行文件搜索。