メインコンテンツまでスキップ

CLI とエージェント連携のクイックスタート

このガイドでは、Zilliz CLI とエージェント連携をローカルでセットアップする方法を説明します。セットアップ後は、エージェントを使って自然言語で Zilliz Cloud を操作したり、CLI をターミナル、スクリプト、CI ワークフローで直接使用したりできます。

インストール​

開始する前に、以下を用意してください。

Claude Code Plugin をインストールする​

Claude Code から直接 Zilliz Cloud を操作したい場合は、Claude Code Plugin を使用してください。

1

Claude Code を実行します

bash
> claude
2

プラグインマーケットプレイスを開きます

bash
/plugin
3

Zilliz Plugin を見つけてインストールします

Discover タブに移動し、zilliz を検索します。zilliz プラグインを選択してインストールします。

TqS3b4z7Ho9xcXxHJaIc7HTZn1e

4

クイックスタートウィザードを実行します。ウィザードは、CLI のインストール、認証、クラスター接続、最初の操作を案内します。

plaintext
/zilliz:quickstart

一般的なエージェントフレームワーク向けに Zilliz Skill をインストールする​

Codex、Gemini CLI、Cursor、またはその他の Skill 対応エージェントなどのコーディングエージェントがエージェントスキルをサポートしている場合は、以下のように Zilliz Skill をインストールします。

bash
npx skills add zilliztech/zilliz-skill

このコマンドを実行すると、対象のエージェントフレームワークとインストール範囲を選択するよう求められます。

Zilliz CLI をインストールする​

Zilliz CLI は、Plugin と Skill が使用する基本のコマンドラインツールです。

1

Zilliz CLI をインストールします。

bash
curl -fsSL https://zilliz.com/cli/install.sh | bash

インストールを確認します。

bash
zilliz --version
2

認証します。

Zilliz Cloud アカウントで認証します。

bash
zilliz login

これにより、認証用のブラウザが開きます。ログイン後、認証情報はローカルに保存されます。

CLI、Plugin、または Skill を使うタイミング​

これらのツールは、次のような場合に使用します。

  • ローカル環境から手動で開発およびテストする場合

  • 再現可能なワークフローのために自動操作スクリプトを作成する場合

  • エージェントが Vector Database または Vector Lakebase サービスを自動的に呼び出せるようにする場合

ツール比較​

Claude Code Plugin、Zilliz Skill、Zilliz CLI は、同じ主要な機能をカバーすることを想定しています。機能範囲ではなく、ワークフローに基づいて選択してください。

Claude Code PluginZilliz SkillZilliz CLI
最適な用途Claude Code の自然言語ワークフローSkill 対応コーディングエージェントターミナル利用、スクリプト、CI
セットアップ/zilliz:quickstartnpx skills add zilliztech/zilliz-skillインストールスクリプト + zilliz login
自然言語はいはいいいえ
自動化エージェント支援エージェント支援スクリプト優先
構造化出力エージェントが読めるレスポンスエージェントが読めるレスポンススクリプト向けの --output json

サポートされる機能​

次の表では、CLI、Plugin、Skill の機能について説明します。

領域実行できること
クラスター作成、削除、一時停止、再開、変更
コレクションカスタムスキーマで作成、ロード、リリース、名前変更、削除
ベクトル検索、クエリ、挿入、アップサート、削除、ハイブリッド検索
インデックス作成（AUTOINDEX）、一覧表示、説明表示、削除
データベース作成、一覧表示、説明表示、削除
ユーザーとロールRBAC セットアップ、権限管理
バックアップ作成、復元、エクスポート、ポリシー管理
インポートS3/GCS/Azure Blob Storage からの一括データインポート
パーティション作成、ロード、リリース、管理
モニタリングクラスターのステータス、コレクション統計、ロード状態
プロジェクトプロジェクトとリージョンの管理
請求利用状況クエリ、請求書

エージェントに依頼できること​

インストール後は、タスクをそのまま記述してください。エージェントはそのリクエストを対応する Zilliz CLI コマンドに変換するはずです。以下の例は、自然言語のリクエストが、エージェントが実行することを想定される CLI コマンドにどのように対応するかを示しています。

  • 自分のクラスターを一覧表示し、現在アクティブなものを示してください。

    想定される CLI コマンド:

    bash
    zilliz cluster list
    zilliz context current

  • 768 次元のベクトルフィールドを持つ product embeddings 用のコレクションを作成してください。

    想定される CLI コマンド:

    bash
    zilliz collection create --name product_embeddings --dimension 768

  • S3 から自分のコレクションにデータをインポートし、インポートジョブのステータスを確認してください。

    想定される CLI コマンド:

    bash
    zilliz import start --cluster-id <cluster-id> --collection product_embeddings --body '{"files": [["s3://bucket/path/data.json"]]}'

  • 本番クラスターのバックアップを作成してください。

    想定される CLI コマンド:

    bash
    zilliz backup create --cluster-id <cluster-id>

  • メタデータフィルターを使って自分のコレクションを検索し、上位 10 件の結果を返してください。

    想定される CLI コマンド:

    bash
    zilliz vector search --collection product_embeddings --data '[[0.1, 0.2, 0.3]]' --filter 'age > 20' --limit 10 --output-fields '["name", "age"]'

  • analytics コレクションに読み取り専用アクセスを持つロールを作成してください。

    想定される CLI コマンド:

    bash
    zilliz role create --role analytics_readonly
    zilliz role grant-privilege --role analytics_readonly --object-type Collection --object-name analytics --privilege Search
    zilliz role grant-privilege --role analytics_readonly --object-type Collection --object-name analytics --privilege Query
Ctrl I