alibabacloud-pds-multimodal-search
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChinesePDS Multimodal Search
PDS 多模态搜索
Please read this entire skill document carefully
请仔细阅读完整的技能文档
Features
功能特性
- For getting drive/drive_id, querying enterprise space, team space, personal space -> read
references/drive.md - For uploading local files to enterprise space, team space, personal space → read
references/upload-file.md - For downloading files from enterprise space, team space, personal space to local → read
references/download-file.md - For searching or finding files → read
references/search-file.md - For document/audio/video analysis, quick view, summarization on cloud drive → read
references/multianalysis-file.md - For image search, similar image search, image-text hybrid retrieval → read
references/visual-similar-search.md
- 如需获取 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 Execution Guidelines
Agent 执行规范
- 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 commands should include
aliyun pdsparameter to help server identify request source, track usage, and troubleshoot issues.--user-agent AlibabaCloud-Agent-Skills
- 必须按顺序执行步骤:不得跳过任何步骤,前序步骤未完成时不得进入下一步。
- 必须遵循文档要求:阿里云 PDS CLI 命令及参数必须严格遵循本文档指引,不得虚构命令。
- 推荐参数:所有 命令都应包含
aliyun pds参数,便于服务端识别请求来源、追踪使用情况及排查问题。--user-agent AlibabaCloud-Agent-Skills
Core Concepts:
核心概念:
- Domain: PDS instance with a unique domain_id, data is completely isolated between domains
- User: End user under a domain, has user_id
- 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
- Domain:拥有唯一 domain_id 的 PDS 实例,不同 Domain 之间的数据完全隔离
- User:Domain 下的终端用户,拥有 user_id
- Group:Domain 下的团队组织,分为企业组和团队组
- Drive:存储空间,可以归属于用户(个人空间)或团队(团队/企业空间)
- File:空间下的文件或文件夹,拥有 file_id
- Mountapp:PDS 挂载应用插件,用于将 PDS 空间挂载到本地,方便用户访问和管理 PDS 空间内的文件
Installation Requirements
安装要求
Prerequisites: Requires Aliyun CLI >= 3.3.1Verify CLI version:bashaliyun version # requires >= 3.3.1Verify PDS plugin version:bashaliyun pds version # requires >= 0.1.4If version requirements are not met, refer tofor installation or upgrade.references/cli-installation-guide.mdAfter installation, must enable auto plugin installation:bashaliyun configure set --auto-plugin-install true
前置条件:要求 Aliyun CLI 版本 >= 3.3.1验证 CLI 版本:bashaliyun version # requires >= 3.3.1验证 PDS 插件版本:bashaliyun pds version # requires >= 0.1.4若不满足版本要求,请参考进行安装或升级。references/cli-installation-guide.md安装完成后,必须开启插件自动安装功能:bashaliyun configure set --auto-plugin-install true
Authentication Configuration
认证配置
Prerequisites: Alibaba Cloud credentials must be configuredSecurity Rules:
- Forbidden to read, output, or print AK/SK values (e.g.,
is forbidden)echo $ALIBABA_CLOUD_ACCESS_KEY_ID- Forbidden to ask users to input AK/SK directly in conversation or command line
- Forbidden to use
to set plaintext credentialsaliyun configure set- Only allowed to use
to check credential statusaliyun configure listCheck credential configuration:bashaliyun configure listConfirm the output shows a valid profile (AK, STS, or OAuth identity).If no valid configuration exists, stop first.
- Obtain credentials from Alibaba Cloud Console
- Configure credentials outside this session (run
in terminal or set environment variables)aliyun configure- Run
to verify after configuration is completealiyun configure list
bash
undefined前置条件:必须配置阿里云凭证安全规则:
- 禁止读取、输出或打印 AK/SK 值(例如禁止执行
)echo $ALIBABA_CLOUD_ACCESS_KEY_ID- 禁止要求用户在对话或命令行中直接输入 AK/SK
- 禁止使用
设置明文凭证aliyun configure set- 仅允许使用
检查凭证状态aliyun configure list检查凭证配置:bashaliyun configure list确认输出显示有效的配置文件(AK、STS 或 OAuth 身份)。如果不存在有效配置,请先停止操作。
- 从阿里云控制台获取凭证
- 在本次会话外配置凭证(在终端执行
或设置环境变量)aliyun configure- 配置完成后执行
验证aliyun configure list
bash
undefinedInstall Aliyun CLI (if not installed)
Install Aliyun CLI (if not installed)
curl -fsSL --max-time 10 https://aliyuncli.alicdn.com/install.sh | bash
aliyun version # confirm >= 3.3.1
curl -fsSL --max-time 10 https://aliyuncli.alicdn.com/install.sh | bash
aliyun version # confirm >= 3.3.1
Enable auto plugin installation
Enable auto plugin installation
aliyun configure set --auto-plugin-install true
aliyun configure set --auto-plugin-install true
Install Python dependencies (for multipart upload script)
Install Python dependencies (for multipart upload script)
pip3 install requests
undefinedpip3 install requests
undefinedPDS-Specific Configuration
PDS 专属配置
Before executing any PDS operations, you must first configure domain_id, user_id, and authentication type -> read
references/config.mdRecommended parameter: Allcommands should includealiyun pdsparameter--user-agent AlibabaCloud-Agent-SkillsExamples:bashaliyun pds get-user --user-agent AlibabaCloud-Agent-Skills aliyun pds list-my-drives --user-agent AlibabaCloud-Agent-Skills aliyun pds upload-file --drive-id <id> --local-path <path> --user-agent AlibabaCloud-Agent-Skills
执行任何 PDS 操作前,必须先配置 domain_id、user_id 以及认证类型 → 请阅读
references/config.md推荐参数:所有命令都应包含aliyun pds参数--user-agent AlibabaCloud-Agent-Skills示例:bashaliyun pds get-user --user-agent AlibabaCloud-Agent-Skills aliyun pds list-my-drives --user-agent AlibabaCloud-Agent-Skills aliyun pds upload-file --drive-id <id> --local-path <path> --user-agent AlibabaCloud-Agent-Skills
References
参考文档
| Reference Document | Path |
|---|---|
| CLI Installation Guide | references/cli-installation-guide.md |
| RAM Permission Policies | references/ram-policies.md |
| 参考文档 | 路径 |
|---|---|
| CLI 安装指南 | references/cli-installation-guide.md |
| RAM 权限策略 | references/ram-policies.md |
Error Handling
错误处理
- If file search fails, please read and strictly follow the documented process to re-execute file search.
references/search-file.md
- 如果文件搜索失败,请阅读 ,严格遵循文档流程重新执行文件搜索。
references/search-file.md