alibabacloud-pds-intelligent-workspace（阿里巴巴云 PDS 智能工作区）

PDS (Cloud Drive)

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
• For mount app, install mount app, uninstall mount app, stop mount app → read references/mountapp.md
• For image editing, image processing → read references/image-editing.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](https://ram.console.aliyun.com/manage/ak) 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

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

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.