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

CLI とエージェント統合のクイックスタート

Zilliz CLI と、ローカルのワークフローに合ったエージェント統合をインストールします。Zilliz は、Claude Code と OpenAI Codex 向けの Zilliz Plugin、スキル互換エージェント向けの Zilliz Skill、およびターミナルや自動化ワークフローで直接使用できる Zilliz CLI を通じて、エージェント統合をサポートしています。

セットアップが完了すると、エージェントに Zilliz Cloud の直接操作を依頼したり、スクリプトやターミナルで CLI を使用したりできます。

インストール​

開始する前に、以下を満たしていることを確認してください。

OpenAI Codex 向け Zilliz Plugin のインストール​

OpenAI Codex から直接 Zilliz Cloud を操作する場合は、Zilliz Plugin を使用します。

1

マーケットプレイスを追加します。

plaintext
codex plugin marketplace add zilliztech/zilliz-plugin
2

Codex で /plugins を開き、マーケットプレイスから zilliz をインストールします。

次のように codex-marketplace を使用して直接インストールすることもできます。

plaintext
npx codex-marketplace add zilliztech/zilliz-plugin --plugins

Claude Code 向け Zilliz Plugin のインストール​

Claude Code から直接 Zilliz Cloud を操作する場合は、Zilliz 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 などのコーディングエージェント、またはその他のスキル互換エージェントがエージェントスキルをサポートしている場合は、次のように 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 の使い分け​

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

  • ローカル環境で手動による開発とテストを行う場合。

  • 反復可能なワークフロー向けの自動化運用スクリプトを作成する場合。

  • エージェントがベクトルデータベースまたは ベクトル Lakebase サービスを自動的に呼び出せるようにする場合。

ツールの比較​

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

OpenAI Codex pluginClaude Code PluginZilliz SkillZilliz CLI
最適な用途Codex の自然言語ワークフローClaude Code の自然言語ワークフロースキル互換のコーディングエージェントターミナルでの利用、スクリプト、および CI
セットアップquickstart スキルによるガイド付きセットアップ/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 次元のベクトルフィールドを持つ、商品埋め込み用のコレクションを作成してください。

    想定される 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