メインコンテンツまでスキップ
に最終更新

Genie Code CLI

備考

ベータ版

この機能は Betaです。初期リリースであるため、機能、コマンド、インターフェイスは頻繁に変更されます。

Genie Code CLIは、ターミナルでローカルに実行されるコーディングエージェントであり、DatabricksでのデータおよびAI作業向けに調整されています。他のターミナルコーディングエージェントと同様に動作しますが、Databricksを理解し、データ、パイプライン、モデル、アプリと自然に連携するように事前設定されています。

Genie Code CLIはお使いの機械上で実行されるため、ローカルファイルの読み取りと編集、コマンドの実行、およびユーザーに代わってDatabricksへのアクセスを行うことができます。これは、データの検出やそれに関する質問への回答を行うために、 などのコマンドdatabricks genie を含む Databricks CLIdatabricks genie ask を使用します。ベータ版の間、モデルへのアクセスはUnity Gatewayを通じて提供および管理されるため、独自のモデルサブスクリプションを持ち込む必要はありません。

要件​

Genie Code CLIはユーザー自身のIDで実行されるため、ユーザーのDatabricks権限で許可されているデータとオペレーションにのみアクセスできます。

インストールとセットアップ​

  1. まだインストールしていない場合は、Databricks CLI（バージョン 1.0.0 以降）を個別にインストールしてください。Databricks CLI のインストールまたは更新を参照してください。

  2. オペレーティングシステムのコマンドを使用して Genie Code CLI をインストールします。

Bash
curl -fsSL https://github.com/databricks/genie-code-cli/releases/latest/download/install.sh | bash

  1. インストールの確認：

    Bash
    genie --version

  2. プロジェクトディレクトリに移動し、Genie Code CLIを起動します。

    Bash
    cd my-project
    genie

  3. プロンプトが表示されたら、Databricks CLIプロファイルを選択するか、プロファイルが構成されていない場合は認証します。「Databricks CLIの認証」を参照してください。Genie Code CLIは、このプロファイルを使用してUnity Gatewayを介してモデルにアクセスします。他のDatabricks CLIプロファイルを使用して、別のワークスペースで作業したり、Databricks以外の環境で作業したりすることもできます。

  4. ディレクトリのコンテンツが信頼できることを確認してから、プロンプト入力を起動してください。

Genie Code CLI でできること​

Genie Code CLIは、ローカルファイルと直接連携し、Genieを通じてUnity Catalogデータを検知・クエリーし、ターミナルでの1つの会話からDatabricksアセットを構築およびデプロイできます。例えば：

  • 取り込みとガバナンス : "これらの月次売上 CSV をクリーンアップし、Unity Catalog に読み込んで、期間ごとの地域別収益を表示してください。"
  • データを探索する : "どのカタログに顧客の離脱データがあり、前四半期の主なドライバーは何でしたか？"
  • パイプラインの拡張 : "注文パイプラインにシルバーの refunds テーブルを追加し、過去 90 日間をバックフィルする。"
  • モデルをトレーニングする、サービングする ：「Databricks上でこのトレーニングスクリプトをランし、モデルをサービングEndpointの背後に配置します」
  • アプリの構築とリリース : "customers テーブル用のローカルアプリのプロトタイプを構築し、Databricks アプリとしてデプロイします。"

Genie Code CLIとワークスペースのGenie Codeの違い​

Genie Code CLI は、ローカルのターミナルベースの作業用に構築された個別のエクスペリエンスです。独自ツール、スキル、指示があり、現時点では Databricks ワークスペース内の Genie Code とそれらを共有しません。また、ワークスペース UI で利用可能なすべての機能がまだ含まれているわけではありません。

ファイル、スクリプト、プロトタイプをローカルで操作する場合は、ターミナルネイティブのコンパニオンとして Genie Code CLI を使用します。より高度で完全な機能を備えたエクスペリエンスを利用するには、ワークスペースで引き続き Genie Code を使用してください。

スキルと MCP サーバーをセットアップする​

スキル、MCPサーバー、プロジェクトの指示を使用してGenie Code CLIを拡張できます。すでにClaude CodeまたはCursorを使用している場合は、Genie Code CLIで/importを実行すると、それらから設定をインポートできます。

スキルを追加​

Genie Code CLIはDatabricksエージェントスキルとともにあらかじめインストールされており、エージェントはジョブ、パイプライン、モデル、アプリなどのDatabricksデータおよびリソースをより効果的に操作できます。これらのスキルは~/.genie/skills/.system/にあります。

独自のスキルを追加するには、標準の エージェントスキル形式 の SKILL.md ファイルを含むフォルダを作成し、 ~/.genie/skills/ に保存します。チームとスキルを共有するには、リポジトリの .agents/skills/ に保存してください。Genie Code CLIは、作業ディレクトリの親フォルダやリポジトリのルートなど、他のローカルフォルダからスキルを読み込むこともできます。

Genie Code CLIにスキルを作成するように依頼したり、既存のスキルを他のコーディングエージェントから変換するように依頼することもできます。

Genie Code CLIはローカルフォルダからのみスキルを読み込みます。.assistant/skills/のスキルなど、Databricksワークスペースからスキルを使用するには、それらのフォルダのいずれかにdownloadします。

MCPサーバーに接続する​

genie mcp addを使用して、DatabricksでホストされていないMCPサーバーを含む任意のMCPサーバーにGenie Code CLIを接続します。

リモートMCPサーバーを接続するには、そのURLと、そのアクセストークンを含む環境変数の名前を渡します：

Bash
genie mcp add <server-name> --url <server-url> --bearer-token-env-var <env-var-name>

マシン上で実行されるMCPサーバーに接続するには、それを起動するコマンドを渡します。

Bash
genie mcp add <server-name> -- <command> <args>

Databricks上のマネージドMCPサーバー（Genie One MCPサーバーなど）に接続するには：

  1. Databricks アクセストークンを環境変数に格納します。

    Bash
    export DATABRICKS_MCP_TOKEN=$(databricks auth token --profile <profile-name> | jq -r .access_token)

  2. MCPサーバーを追加し、環境変数の名前を渡します。ワークスペースURLに ?o=<workspace-id> などのワークスペースIDが含まれている場合は、MCPサーバーURLの末尾に追加してください。

    Bash
    genie mcp add genie_one \
      --url "https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp" \
      --bearer-token-env-var DATABRICKS_MCP_TOKEN

  3. 同じターミナルで、Genie Code CLIを起動します。

    Bash
    genie

  4. /mcpをランして、サーバーが接続されていることを確認します。

プロジェクトの指示を追加​

コーディング規約、カタログ名やスキーマ名、テストの実行方法など、プロジェクトのすべての会話に適用される指示をGenie Code CLIに与えるには、プロジェクトディレクトリのルートに AGENTS.md ファイルを追加します。Genie Code CLIは、そのディレクトリで起動したときにこのファイルを読み取ります。

課金​

Genie Code CLI の使用量は、Unity Gateway を通じてモデルを直接使用する場合と同様に請求され、Unity Gateway の使用量に表示されます。Genie の価格では課金されません。

支出を管理するために、ワークスペース管理者はUnity Gatewayの予算を設定できます。「Unity Gatewayの予算の管理」を参照してください。

よくある質問​

独自のコーディングエージェントを使用する場合、代わりにGenie Code CLIをいつ使用する必要がありますか？​

例えば、Genie OneなどのDatabricksエージェントスキル と DatabricksマネージドMCPサーバー を使用するようにそのエージェントを既に構成している場合は、ug CLI で別のコーディングエージェントを使用してください。ug claude

セットアップされていない場合、またはDatabricksでより適切に動作するようにDatabricksがエージェントハーネスに適用する追加の調整が必要な場合は、Genie Code CLIを使用します。

Genie Code CLIは他のコーディングエージェントとどう違いますか？​

Genie Code CLIは他のターミナル用コーディングエージェントと同様に動作しますが、次の点が異なります：

  • Databricks用に事前設定 ：Databricksスキルが含まれており、Databricks CLIとGenieを使用してデータを検出およびクエリーし、データとAIの作業用の指示で調整されています。これらを自分でインストールまたは構成する必要はありません。
  • 個別のモデルサブスクリプションは不要 ：モデルへのアクセスはUnity Gatewayを通じて提供および管理され、使用料金はDatabricksアカウントに請求されます。
  • ワークスペースの運用はDatabricksによって管理されます ：Databricksワークスペースでの操作はDatabricks IDで実行されるため、Unity Catalogの権限が適用されます。ファイル編集やマシン上でのコマンド実行など、ローカル操作はDatabricksによって管理されません。

代わりに Databricks で別のコーディング エージェントを使用する場合は、「コーディング エージェントを起動する」を参照してください。

Genie Code CLIはどのオペレーティングシステムをサポートしていますか？​

Genie Code CLIは、macOS、Linux、Windowsをサポートしています。インストールとセットアップを参照してください。

IDEでGenie Code CLIを使用できますか？​

はい。Visual Studio Code、Cursor、IntelliJ IDEAなどのIDEの統合ターミナルからGenie Code CLIを起動できます。Genie Code CLIは、それを起動したディレクトリ内のファイルで動作します。

以前の会話を再開するにはどうすればよいですか？​

genieをランするたびに、Genie Code CLIは新しい会話を起動します。以前の会話を再開するには、次のいずれかの操作を行います。

  • genie resume：リストから会話を選択します。
  • genie resume --last: 直近の会話を再開します。
  • /resume: Genie Code CLIの実行中にリストから会話を選択します。

Genie Code CLIを更新するにはどうすればよいですか？​

Genie Code CLIは起動時に新しいバージョンを確認し、更新を促します。手動で更新するには、genie updateをランするか、お使いのオペレーティングシステム用のインストールコマンドをランし直します。

管理者はGenie Code CLIをどのように管理しますか？​

管理者は、他のコーディングエージェントと同じように、Unity Gatewayを通じてGenie Code CLIを管理します。Genie Code CLIの使用量はUnity Gatewayの使用量に表示され、Unity Gatewayの予算が適用されます。コーディングエージェントの設定およびUnity Gatewayの予算管理を参照してください。

制限事項​

  • モデルの選択は Databricks によって管理されます。特定のモデルを選択することはできません。ベータ版の間、Genie Code CLI は GPT 5.6 を使用します。この選択は他の Genie サーフェスとは異なる場合があり、時間の経過とともに変更される可能性があります。
  • Genie Code CLIはGenieの使用量には請求されず、Genieの予算の影響も受けません。支出を管理するには、Unityゲートウェイの予算を設定します。「Unityゲートウェイの予算を管理する」を参照してください。
  • Genie Code CLI は、OAuth マシン間 (M2M) 認証のみをサポートしています。
  • Genie Code CLIは、SSHトンネルセッションをサポートしていません。Genie Code CLIを使用するには、ローカルマシンで実行します。
  • Genie Code CLIはローカルフォルダからのみスキルを読み込みます。ワークスペースやUnity Catalogからスキルや指示を読み込むことはありません。
  • Databricks上のMCPサーバーをアクセストークンで接続した場合、トークンの有効期限が切れるとMCP呼び出しは401エラーで失敗します。再接続するには、Genie Code CLIを終了し、環境変数を新しいトークンに設定して、genieを実行します。
このページの見出し