Zilliz Gemini CLI Extension
Gemini CLI 用の Zilliz Cloud 拡張機能は、Zilliz Cloud の操作を IDE に直接もたらす自然言語インターフェースです。CLI コマンドを暗記したり Web コンソールに切り替えたりすることなく、実行したい内容を自然言語で記述するだけで、プラグインが処理します。
できること
-
自然言語のリクエストを
zilliz-cliコマンドに変換します -
クラスター、データベース、コレクション、パーティション、インデックス、ベクトル、インポート、バックアップ、users/roles, 監視、プロジェクト、請求など、Zilliz Cloud の主要な操作をすべてカバーします
-
呼び出し時に実際の
--help出力を埋め込むため、アシスタントは常に最新のフラグ情報を参照できます -
破壊的な操作の前には、ユーザーによる明示的な確認を必須とします
事前準備
- Gemini CLI がインストールされていること。
セットアップ手順
gemini extensions install https://github.com/zilliztech/gemini-cli-extension
または、このリポジトリ をローカルにクローンしてから、次のコマンドを実行することもできます。
gemini extensions link /path/to/gemini-cli-extension
初期セットアップ
インストール後、クイックスタートウィザードを実行します。
/zilliz:setup
ウィザードでは、以下の手順に沿って設定を進めます。
Zilliz CLI をインストールします。
このプラグインには Zilliz CLI が必要です。未インストールの場合は、以下を実行してください。
- macOS / Linux
- Windows
curl -fsSL https://zilliz.com/cli/install.sh | bash
irm https://zilliz.com/cli/install.ps1 | iex
インストールを確認します。
zilliz --version
認証します。
Zilliz Cloud アカウントを使用して認証を行います。
zilliz auth login
ブラウザが起動し、認証が行われます。ログイン後、認証情報はローカルに保存されます。
クラスターに接続します。
デフォルトのクラスター接続を構成します。
zilliz context set --cluster-id <your-cluster-id>
または、プラグインを利用して、利用可能なクラスターから選択することもできます。
動作確認
簡単なコマンドでプラグインをテストします。
You: "List my clusters"
プラグインによって、Zilliz Cloud のクラスターが表示されるはずです。
トラブルシューティング
-
プラグインに「CLI not found」と表示される
対処法: Zilliz CLI をインストールしてください。
- macOS / Linux
- Windows
bashcurl -fsSL https://zilliz.com/cli/install.sh | bashbashirm https://zilliz.com/cli/install.ps1 | iex -
認証に失敗する
対処法:
-
インターネット接続を確認してください。
-
Zilliz Cloud アカウントが有効であることを確認してください。
-
ログアウトしてから、もう一度ログインを試してください。
bashzilliz logoutzilliz login -
-
「No クラスター configured」
対処法: デフォルトのクラスターを設定します。
bashzilliz context set --cluster-id <cluster-id>
次のステップ
Zilliz Claude Code Plugin と Zilliz Gemini CLI Extension はどちらも、基盤となる Zilliz CLI を共有しています。プロンプトの書き方を学ぶには、Zilliz Claude Code Plugin の機能 および Zilliz Claude Code Plugin の例 を参照してください。