Genie Code CLI
Genie Code CLIは、ターミナルでローカルに実行されるコーディングエージェントであり、DatabricksでのデータおよびAI作業向けに調整されています。他のターミナルコーディングエージェントと同様に動作しますが、Databricksを理解し、データ、パイプライン、モデル、アプリと自然に連携するように事前設定されています。
Genie Code CLIはマシン上でランされるため、ローカルファイルを読み取ったり編集したり、コマンドをランしたり、ユーザーに代わってDatabricksにアクセスしたりできます。データを見つけて質問に回答するために、databricks genie ask を含む Databricks CLI、databricks genie コマンドを使用します。Genie Code CLIはDatabricksが提供するモデルを使用するため、独自のモデルサブスクリプションを用意する必要はありません。アクセスと予算の管理は、Genie Codeの場合と同じ方法で行います。「請求と予算」を参照してください。
要件
- Genie Code CLIが利用可能なリージョンのDatabricksワークスペース。モデルと機能の可用性はリージョンによって異なります。リージョンの可用性を参照してください。
- パートナーが提供する AI 機能がアカウントとワークスペースの両方で有効になっていること。パートナーが提供する AI 機能をご覧ください。
- ワークスペースでUnity Catalog有効化されていること。 Unity Catalog のワークスペースを有効にする方法をご覧ください。
- 個別にインストールされた、バージョン 1.0.0 以降の Databricks CLI。Genie Code CLI はこれを使用して認証を行い、
databricks genieコマンドを実行します。Databricks CLI のインストールまたは更新を参照してください。
Genie Code CLIはユーザー自身のIDで実行されるため、ユーザーのDatabricks権限で許可されているデータとオペレーションにのみアクセスできます。
インストールとセットアップ
-
まだインストールしていない場合は、Databricks CLI(バージョン 1.0.0 以降)を個別にインストールしてください。Databricks CLI のインストールまたは更新を参照してください。
-
オペレーティングシステムのコマンドを使用して Genie Code CLI をインストールします。
- Linux or macOS
- Windows
curl -fsSL https://github.com/databricks/genie-code-cli/releases/latest/download/install.sh | bash
PowerShellで次をランします:
powershell -ExecutionPolicy Bypass -c "irm https://github.com/databricks/genie-code-cli/releases/latest/download/install.ps1 | iex"
-
インストールの確認:
Bashgenie --version -
プロジェクトディレクトリに移動し、Genie Code CLIを起動します。
Bashcd my-projectgenie -
プロンプトが表示されたら、Databricks CLI プロファイルを選択するか、設定していない場合は認証を行います。Databricks CLI の認証を参照してください。Genie Code CLI は、モデルアクセスと課金のためにこのプロファイルを使用します。他のワークスペースで作業したり、完全にDatabricksの外部で作業したりするには、他のDatabricks CLIプロファイルを引き続き使用できます。
-
ディレクトリのコンテンツが信頼できることを確認してから、プロンプト入力を起動してください。
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と、そのアクセストークンを含む環境変数の名前を渡します:
genie mcp add <server-name> --url <server-url> --bearer-token-env-var <env-var-name>
マシン上で実行されるMCPサーバーに接続するには、それを起動するコマンドを渡します。
genie mcp add <server-name> -- <command> <args>
Databricks上のマネージドMCPサーバー(Genie One MCPサーバーなど)に接続するには:
-
Databricks アクセストークンを環境変数に格納します。
Bashexport DATABRICKS_MCP_TOKEN=$(databricks auth token --profile <profile-name> | jq -r .access_token) -
MCPサーバーを追加し、環境変数の名前を渡します。ワークスペースURLに
?o=<workspace-id>などのワークスペースIDが含まれている場合は、MCPサーバーURLの末尾に追加してください。Bashgenie mcp add genie_one \--url "https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp" \--bearer-token-env-var DATABRICKS_MCP_TOKEN -
同じターミナルで、Genie Code CLIを起動します。
Bashgenie -
/mcpをランして、サーバーが接続されていることを確認します。
プロジェクトの指示を追加
コーディング規約、カタログ名やスキーマ名、テストの実行方法など、プロジェクトのすべての会話に適用される指示をGenie Code CLIに与えるには、プロジェクトディレクトリのルートに AGENTS.md ファイルを追加します。Genie Code CLIは、そのディレクトリで起動したときにこのファイルを読み取ります。
リージョン別の提供状況
Genie Code CLI は指定サービスです。その可用性は、ワークスペースのリージョンおよび 「指定サービスでワークスペース地域内でのデータ処理を強制する」 設定によって異なります。クロスジオ処理は、コンプライアンス セキュリティ プロファイルが有効になっていない米国と EU 以外のGeoのワークスペースに対して、defaultによって有効になります。クロスジオ処理が無効になっている場合、ワークスペースで Genie Code CLI を使用できない可能性があります。各 Geo での可用性については、「各 Geo での指定サービスの利用可能状況」を参照してください。
Genie Code CLIは、Genie従量課金制が利用できないリージョン(Azure West Central USおよびQatar Central、AWS Asia Pacific (Jakarta)、および政府リージョン)では利用できません。
ウェブ検索
Web検索には追加の要件があります:
- ウェブ検索の要件は、Genie CodeおよびGenie Oneでのウェブ検索 プレビューを含め、 Genie Codeでのウェブ検索 と同じです。
- Genie Codeのウェブ検索とは異なり、Genie Code CLIのウェブ検索はコンプライアンス セキュリティ プロファイルが有効になっているワークスペースでは使用できません。
ウェブ検索を利用できない場合でも、Genie Code CLIはcurlなどのシェルコマンドを実行してインターネットにアクセスできます。
課金とバジェット
Genie Code CLIはGenie Codeと同じ方法で課金され、Genieの従量課金制の価格設定が適用されます。これは、各ユーザーがGenie製品に対して受け取る無料の月間使用量を共有します。Genie Code CLIの使用状況は、Unity Gatewayを通じて追跡されます。
Genie Code CLIの予算とコスト管理は、他のGenie製品と一緒に管理され、Genie Code CLIの使用量は同じGenie予算にカウントされます。「Genieの予算とコスト管理」を参照してください。
Genie Code CLIの使用は、usage_metadata.genie.surfaceがGENIE_CODE_CLIに設定されたsystem.billing.usageシステムテーブルに表示されます。Genieコストの監視と理解をご覧ください。
最新の価格と無料利用可能量については、Databricks の価格ページをご覧ください。
よくある質問
独自のコーディングエージェントを使用する場合、代わりに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の作業用の指示で調整されています。これらを自分でインストールまたは構成する必要はありません。
- 個別のモデルサブスクリプションは不要 : Genie Code CLIはDatabricksが提供するモデルを使用し、使用料はGenie Codeと同じように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をどのように管理しますか?
Genie Code CLI の使用は Unity Gateway を通じて追跡され、管理者は他の Genie 製品と並行して予算を管理します。Genieの予算とコスト管理を参照してください。
制限事項
- Genie Code CLIは、
databricks auth loginで作成されたDatabricks CLIプロファイルを使用するOAuth ユーザーマシン間 (U2M) 認証のみをサポートします。OAuth マシン間 (M2M) 認証と個人用アクセストークンはサポートされていません。 - Genie Code CLIは、SSHトンネルセッションをサポートしていません。Genie Code CLIを使用するには、ローカルマシンで実行します。
- Genie Code CLIはローカルフォルダからのみスキルを読み込みます。ワークスペースやUnity Catalogからスキルや指示を読み込むことはありません。
- Databricks上のMCPサーバーをアクセストークンで接続した場合、トークンの有効期限が切れるとMCP呼び出しは
401エラーで失敗します。再接続するには、Genie Code CLIを終了し、環境変数を新しいトークンに設定して、genieを実行します。