alibabacloud-pds-multimodal-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

PDS 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
    aliyun pds
    commands should include
    --user-agent AlibabaCloud-Agent-Skills
    parameter to help server identify request source, track usage, and troubleshoot issues.
  • 必须按顺序执行步骤:不得跳过任何步骤,前序步骤未完成时不得进入下一步。
  • 必须遵循文档要求:阿里云 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.1
Verify CLI version:
bash
aliyun version  # requires >= 3.3.1
Verify PDS plugin version:
bash
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:
bash
aliyun configure set --auto-plugin-install true

前置条件:要求 Aliyun CLI 版本 >= 3.3.1
验证 CLI 版本:
bash
aliyun version  # requires >= 3.3.1
验证 PDS 插件版本:
bash
aliyun pds version  # requires >= 0.1.4
若不满足版本要求,请参考
references/cli-installation-guide.md
进行安装或升级。
安装完成后,必须开启插件自动安装功能:
bash
aliyun configure set --auto-plugin-install true

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:
bash
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
  2. Configure credentials outside this session (run
    aliyun configure
    in terminal or set environment variables)
  3. Run
    aliyun configure list
    to verify after configuration is complete
bash
undefined
前置条件:必须配置阿里云凭证
安全规则:
  • 禁止读取、输出或打印 AK/SK 值(例如禁止执行
    echo $ALIBABA_CLOUD_ACCESS_KEY_ID
  • 禁止要求用户在对话或命令行中直接输入 AK/SK
  • 禁止使用
    aliyun configure set
    设置明文凭证
  • 仅允许使用
    aliyun configure list
    检查凭证状态
检查凭证配置:
bash
aliyun configure list
确认输出显示有效的配置文件(AK、STS 或 OAuth 身份)。
如果不存在有效配置,请先停止操作。
  1. 阿里云控制台获取凭证
  2. 在本次会话外配置凭证(在终端执行
    aliyun configure
    或设置环境变量)
  3. 配置完成后执行
    aliyun configure list
    验证
bash
undefined

Install 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
undefined
pip3 install requests
undefined

PDS-Specific Configuration

PDS 专属配置

Before executing any PDS operations, you must first configure domain_id, user_id, and authentication type -> read
references/config.md
Recommended parameter: All
aliyun pds
commands should include
--user-agent AlibabaCloud-Agent-Skills
parameter
Examples:
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 <id> --local-path <path> --user-agent AlibabaCloud-Agent-Skills
执行任何 PDS 操作前,必须先配置 domain_id、user_id 以及认证类型 → 请阅读
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 <id> --local-path <path> --user-agent AlibabaCloud-Agent-Skills

References

参考文档

Reference DocumentPath
CLI Installation Guidereferences/cli-installation-guide.md
RAM Permission Policiesreferences/ram-policies.md
参考文档路径
CLI 安装指南references/cli-installation-guide.md
RAM 权限策略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.
  1. 如果文件搜索失败,请阅读
    references/search-file.md
    ,严格遵循文档流程重新执行文件搜索。