PDS (Cloud Drive)

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

• For mount app, install mount app, uninstall mount app, stop mount app → read

  references/mountapp.md

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 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

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

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

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

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

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

PDS-Specific Configuration

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

References

Error Handling

1. If file search fails, please read

   references/search-file.md

   and strictly follow the documented process to re-execute file search.