alibabacloud-pds-multimodal-search

PDS マルチモーダル検索

このスキルドキュメント全体を注意深くお読みください

機能

• ドライブ／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 をお読みください

エージェント実行ガイドライン

• 手順は必ず順番どおりに実行してください：手順を省略したり、前の手順が完了する前に次の手順に進んだりしないでください。
• ドキュメントに従ってください：aliyun pds cli コマンドとパラメーターは、このドキュメントの指示に従ってください。コマンドを捏造しないでください。
• [必須] CLI User-Agent — aliyun CLI コマンドを実行するたびに、次を含める必要があります： --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search
• ファイル操作の前に対象スペースを特定してください：検索、アップロード、ダウンロード、分析を行う前に、ユーザーが企業スペース、チームスペース、個人スペース、またはすべてのスペースのどれを明示的に指定しているかを判断してください。
• スペースの範囲を黙って広げてはいけません：ユーザーが「企業スペース」と明示した場合は、企業スペースの drive_id のみを使用してください。ユーザーが「チームスペース」と明示した場合は、該当するチームスペースの drive_id のみを使用してください。ユーザーが「個人スペース」と明示した場合は、個人スペースの drive_id のみを使用してください。複数のスペースを横断して検索できるのは、ユーザーが範囲を限定していない場合のみです。
• 企業スペースとチームスペースは互換ではありません：どちらも list-my-group-drive で返されますが、root_group_drive は企業スペースで、items はチームスペースです。一方を他方の代わりに使用してはいけません。
• 指定されたスペースが存在しない場合は、処理を止めて説明してください：たとえば、ユーザーが企業スペースを指定したのに root_group_drive が空の場合、チームスペースで検索して代用してはいけません。

基本概念：

• ドメイン：一意の domain_id を持つ PDS インスタンスです。ドメイン間でデータは完全に分離されています
• ユーザー：ドメイン内のエンドユーザーで、user_id を持ちます
• グループ：ドメイン内のチーム組織で、企業グループとチームグループに分かれます
• ドライブ：ストレージスペースです。ユーザー（個人スペース）またはグループ（企業スペースまたはチームスペース）に属します
• ファイル：スペース内のファイルまたはフォルダーで、file_id を持ちます
• Mountapp：PDS のマウントアプリプラグインです。PDS スペースをローカルにマウントし、ユーザーが PDS スペース内のファイルに簡単にアクセスして管理できるようにします

スペース選択ルール

drive_id を選ぶ前に、次のルールを適用してください：

ユーザーの表現	使用可能なドライブの参照元	禁止されている代替
"企业空间" / "company space" / "enterprise space"	root_group_drive のみ	items 内の任意のドライブ
"团队空间" / "某个团队空间" / "team space"	items のみ	root_group_drive
"个人空间" / "我的空间" / "personal space"	list-my-drives.items のみ	グループドライブ
"网盘里" / "我的网盘" / スペースの指定なし	関連するすべてのスペース	なし

続行する前に、次の点を簡単に確認してください：

1. ユーザーは対象のスペースの種類を明示していますか？
2. 選択した drive_id は、そのスペースの種類に対応する正しいレスポンスフィールドから取得されていますか？
3. 複数のチームスペースがあり、ユーザーが「チームスペース」とだけ指定している場合、どのチームスペースか確認する必要がありますか？

いずれかの答えに確信が持てない場合は、推測しないでください。

---

インストール要件

前提条件：Aliyun CLI >= 3.3.3 が必要です

CLI のバージョンを確認します：

aliyun version  # requires >= 3.3.3

インストールされていない場合、またはバージョンが古い場合は、 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash を実行して更新するか、 インストール手順については references/cli-installation-guide.md を参照してください。

PDS プラグインのバージョンを確認します：

aliyun pds version  # requires >= 0.1.4

インストール後、必ずプラグインの自動インストールを有効にしてください：

aliyun configure set --auto-plugin-install true

次に、ローカルマシン上の既存プラグインが常に最新の状態になるよう、[MUST] aliyun plugin update を実行してください。

---

CLI の初期化（コアワークフローの前に必ず実行）

コアワークフローの開始時（CLI コマンドを実行する前）に：

[MUST] AI モードを有効にする — エージェントスキルの実行には AI モードが必要です。 CLI コマンドを実行する前に、次のコマンドを実行してください：

aliyun configure ai-mode enable
aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search"

[MUST] すべての終了時点で AI モードを無効にする — どのような理由であっても最終応答を返す前に、必ず最初に AI モードを無効にしてください。これは、ワークフローの成功、ワークフローの失敗、エラー／例外、ユーザーによるキャンセル、セッションの終了、その他 CLI コマンドが以後実行されないあらゆる状況を含む、すべての終了経路に適用されます。 AI モードはエージェントスキルの呼び出し時にのみ使用し、スキルの実行停止後も有効なままにしてはなりません。

aliyun configure ai-mode disable

---

認証の設定

前提条件：Alibaba Cloud の認証情報が設定されている必要があります

セキュリティルール：

• AK/SK の値を読み取る、出力する、または表示することは禁止です（例：echo $ALIBABA_CLOUD_ACCESS_KEY_ID は禁止されています）
• 会話またはコマンドラインで、AK/SK を直接入力するようユーザーに求めることは禁止です
• 平文の認証情報を設定するために aliyun configure set を使用することは禁止です
• 認証情報の状態を確認するために使用できるのは aliyun configure list のみです

認証情報の設定を確認します：

aliyun configure list

出力に有効なプロファイル（AK、STS、または OAuth ID）が表示されていることを確認してください。

有効な設定がない場合は、まず処理を停止してください。

1. Alibaba Cloud コンソールから認証情報を取得します
2. このセッション外で認証情報を設定します（ターミナルで aliyun configure を実行するか、環境変数を設定します）
3. 設定が完了したら、aliyun configure list を実行して確認します

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

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

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

PDS 固有の設定

PDS の操作を実行する前に、まず domain_id、user_id、および認証タイプを設定する必要があります -> references/config.md を参照してください

[MUST] CLI User-Agent — aliyun CLI コマンドを実行するたびに、--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search を含める必要があります

例：

aliyun pds get-user --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search
aliyun pds list-my-drives --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search
aliyun pds upload-file --drive-id <id> --local-path <path> --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pds-multimodal-search

参考資料

参考ドキュメント	パス
CLI インストールガイド	references/cli-installation-guide.md
RAM 権限ポリシー	references/ram-policies.md

エラー処理

1. ファイル検索に失敗した場合は、references/search-file.md を読み、記載された手順に厳密に従ってファイル検索を再実行してください。