次のような場合に使用: ユーザーが Zilliz Cloud CLI(コマンドラインツール)とクラスター環境(複数のコンピュータを統合した仮想的な実行環境)を初めてセットアップ、インストール、認証、または設定する場合。
Use when the user wants to set up, install, authenticate, or configure the Zilliz Cloud CLI and cluster context for the first time (one-shot onboarding).
ユーザーを Zilliz Cloud CLI のセットアップ全体通してガイドします。以下の手順を順番に実行してください:
すでにインストール済みか確認:
zilliz --version
未インストール、またはアップグレードが必要な場合:
curl -fsSL https://raw.githubusercontent.com/zilliztech/zilliz-cli/master/install.sh | bash
インストールの確認:
zilliz --version
すでにログイン済みか確認:
zilliz auth status
未ログインの場合は、ユーザー自身のターミナルを開いて、以下のいずれかを実行するよう案内してください:
zilliz login — OAuth 認証のためブラウザが開き、全機能にアクセス可能。zilliz login --api-key — API Key の入力を求めるプロンプトが表示され、ブラウザ不要。zilliz configure — API Key の入力を求めるプロンプトが表示され、よりシンプルなセットアップ方法。.zshrc / .bashrc に export ZILLIZ_API_KEY=<key> を追加。重要: これらのコマンドはインタラクティブな入力を必要とするため、agent 内では実行できません。ユーザーに API Key をチャットに貼り付けるよう求めないでください。
ユーザーがログイン完了を確認したら、以下で検証してください:
zilliz auth status
利用可能なクラスターを一覧表示:
zilliz cluster list
クラスターが存在しない場合は、作成を提案:
zilliz project list
zilliz cluster regions
zilliz cluster create --type serverless --name <name> --project-id <id> --region <region>
データ操作に使用するアクティブなクラスターを設定:
zilliz context set --cluster-id <selected-cluster-id>
すべてが正常に機能していることを確認:
zilliz context current
zilliz collection list
クラスター ID、エンドポイント、データベースを表示しながら、セットアップ結果をユーザーに報告してください。
Guide the user through the complete Zilliz Cloud CLI setup. Follow these steps in order:
Check if already installed:
zilliz --version
If not installed or needs upgrading:
curl -fsSL https://raw.githubusercontent.com/zilliztech/zilliz-cli/master/install.sh | bash
Verify:
zilliz --version
Check if already logged in:
zilliz auth status
If not logged in, instruct the user to open their own terminal and run one of:
zilliz login — opens browser for OAuth, full feature access.zilliz login --api-key — prompts for API key, no browser needed.zilliz configure — prompts for API key, simpler setup.export ZILLIZ_API_KEY=<key> to .zshrc / .bashrc.IMPORTANT: These commands require interactive input and cannot run inside the agent. Do NOT ask the user to paste API keys into the chat.
Wait for the user to confirm login is complete, then verify:
zilliz auth status
List available clusters:
zilliz cluster list
If no clusters exist, offer to create one:
zilliz project list
zilliz cluster regions
zilliz cluster create --type serverless --name <name> --project-id <id> --region <region>
Set the active cluster for data operations:
zilliz context set --cluster-id <selected-cluster-id>
Confirm everything works:
zilliz context current
zilliz collection list
Report the setup result to the user, showing their cluster ID, endpoint, and database.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。