チュートリアル: Unity Gateway スキルの検出と使用
ベータ版
この機能はベータ版です。使用するには、ワークスペース管理者は、 プレビューページ から GenieにおけるUnity Gatewayスキル を有効にする必要があります。Databricksプレビューの管理を参照してください。
コーディング エージェントをチームが Unity Catalog に公開したスキルに接続し、任意のエージェント セッションからそれらを検出して使用します。全員が同じガバナンス対象スキーマを参照するため、既存のものを再構築するのではなく、再利用します。独自のスキルを作成および公開するには、Unity Gateway スキルの作成と共有を参照してください。
スキルを1セッションで使用するか、セッションごとにディスクにdownloadするか、Databricks Skills MCPサーバーからライブで読み込んで最新の公開バージョンを取得することができます。
要件
- Unity Catalogが有効化されたDatabricksワークスペース、および ワークスペースURL(例:
https://my-company.cloud.databricks.com)。 - マシン上の Python 3.12 以降および uv (Unity Gateway CLI のインストールに使用)。
- MCP対応コーディングエージェント(MCP:モデルコンテキストプロトコルは、エージェントがサーバーに接続するために使用するオープン標準です)。
USE CATALOG、使用するスキルに対するUSE SCHEMAおよびREAD VOLUME。これらはDatabricks管理者が付与します。コマンドが権限エラーで失敗した場合は、チームのスキーマに対してこれらの権限を管理者にリクエストしてください。
Databricks スキルレジストリに接続する
Unity Gateway CLI をインストールし、それを使用してコーディングエージェントを Databricks ワークスペースのスキルレジストリに接続します。
Unity Gateway CLIはワークスペースへのサインインを行い、エージェントがスキルのリスト表示、読み込み、downloadに使用する Databricks Skills MCPサーバー (databricks-skill-registry)を登録します。
エージェントにUnity Gateway CLIをインストールおよび接続させるには、以下を実行します:
Install the :re[UG] CLI from its Git source and connect my coding agent to Databricks:
1. Run: uv tool install git+https://github.com/databricks/unity-gateway
2. Run: ug configure --agents <your-agent> --workspace https://<workspace-host>
3. Run: ug skills
Use <your-agent> = my coding agent (claude, codex, gemini, opencode, or copilot) and
<workspace-host> = my workspace URL host (for example, my-company.cloud.databricks.com).
A browser opens during step 2 for me to sign in.
If no browser can open, install the Databricks CLI, run `databricks configure --host https://<workspace-host>` to create a profile named DEFAULT, then run `ug configure --agents <your-agent> --profile DEFAULT --use-pat` in a terminal instead.
ご自身で行う場合は、ターミナルで同じコマンドを実行してください:
uv tool install git+https://github.com/databricks/unity-gateway
ug configure --agents <your-agent> --workspace https://<workspace-host>
ug skills
<your-agent> は、使用するコーディングエージェントの名前(例: claude、codex、gemini、opencode、copilot)に、<workspace-host> はワークスペース URL ホストに置き換えます。ug configure の実行中にブラウザが開き、サインインを求められます。その後、エージェントを再起動(ug <your-agent>)して、スキルレジストリ接続を読み込みます。
ブラウザを開けないヘッドレスマシンや CI で、代わりに端末で ug configure --agents <your-agent> --profile DEFAULT --use-pat をランし、既存の Databricks CLI 設定プロファイルから個人用アクセストークンでサインインします。このパスには Databricks CLI が必要です。これは インストール できます。プロファイルを作成するには、まず databricks configure --host <workspace-url> を実行します。ug CLI リファレンス を参照してください。
スキルの検出
エージェントにプレーン言語で依頼してください。databricks-skill-registry MCPサーバーは、使用権限のあるスキルのみを返します。
スキーマをリストして、その中のすべてのスキルを確認します。このページの例では acme.sql_skills を使用しています。ご自身の <catalog>.<schema> に置き換えてください。
List the Databricks skills in acme.sql_skills.
エージェントは、スキーマ内でアクセス可能なスキルをレポートします。リストが空の場合、スキーマに対する必要な権限がないか、そこにスキルが公開されていない可能性があります。スキルを公開するには、Unity Gatewayスキルの作成と共有をご覧ください。
スキルの使用
見つけたスキルの使用方法を選択します:
手法 | セッション間で永続化されます | オフラインで動作します | アップデートを取得する | どのようなタスクにベストなのか |
|---|---|---|---|---|
No | No | 現在のバージョンをロードします | 単一タスク | |
はい | はい | 新しいバージョンを入手するには、もう一度downloadしてください | 定期的に使用するスキル | |
はい | No | 最新の公開バージョンを読み込みます | 頻繁に変更される一連のスキル |
1 つのセッションに対してスキルを読み込む
このセッションのみでスキルを使用するには、エージェントに名前を指定してスキルを使用するように依頼します。
Use acme.sql_skills.databricks-sql-guide to review this query.
エージェントはスキルを使用するための手順と、そのタスクに必要なサポートファイルを読み取ります。
download a skill
すべてのセッションでスキルを利用できるようにするには、ローカルのスキルフォルダーにdownloadしてください。
エージェントに質問する:
Download acme.sql_skills.databricks-sql-guide with the :re[UG] CLI so I have it every session:
run ug skills add --names acme.sql_skills.databricks-sql-guide.
または、コマンドを自分でランします:
ug skills add --names acme.sql_skills.databricks-sql-guide # one skill
ug skills add --names acme.sql_skills.databricks-sql-guide,acme.sql_skills.dbt-conventions # several skills
ug skills add --location acme.sql_skills # a whole schema
--names では、完全修飾された <catalog>.<schema>.<name> スキルのコンマ区切りリストを指定します。代わりに、スキーマ内のすべてのスキルを download するには、その <catalog>.<schema> を --location に渡します。
その後、エージェントを再起動します(ug <your-agent>)。downloadしたスキルはローカルスキルフォルダ(.claude/skills/ および .agents/skills/)に保存され、セッションごとに読み込まれます。downloadしたスキルをテストするには、次のように尋ねます。
Using our SQL guide skill, write a query on samples.nyctaxi.trips for average fare by trip distance.
samples.nyctaxi.trips すべてのワークスペースに存在するため、セットアップなしで機能します。
downloadしたスキルは、特定の時点でのコピーです。downloadをもう一度するか、スキーマをライブでロードして最新版を取得してください。
スキーマをライブでロード
Databricks Skills MCPサーバーをスキーマにスコープ設定することで、エージェントは必要に応じてそのスキルを読み取ることができます。
エージェントに質問する:
Load the skills in acme.sql_skills live so I always get the latest version:
run ug skills add --location acme.sql_skills --via mcp.
または、コマンドを自分でランします:
ug skills add --location acme.sql_skills --via mcp
その後、エージェントを再起動して(ug <your-agent>)、スキーマに接続するようにします。スキルの説明に一致するタスクがあると、エージェントは必要に応じてそのスキルを読み込めます。新しいバージョンを公開すると、その接続上の全員がすぐに利用できます。これは、中央チームがGitから同期を維持しているスキーマとの相性がよいです。
ライブ読み込みは、一度にスキーマ全体に対して機能します。単一のスキルに範囲を限定することはできません。スキーマ全体を読み込まずに1つのスキルだけを使用するには、代わりに1つのセッションとして読み込みます。
サポートされているエージェントの場合、Unity Gateway CLI が接続を構成し、ライブスキルを自動的にロードします。他のエージェントでは、有効にする必要がある独自の「常にロード(always load)」(または同等の)設定が公開されている場合があります。
リファレンス
Unity Gateway CLI はオープンソースです。完全かつ最新のコマンドリファレンスについては、Unity Gateway CLI リポジトリを参照してください。このチュートリアルで使用するコマンドは、上記のステップ内にインラインで表示されます。
Skills MCPサーバーのサポートされるインターフェイスとクライアントの互換性については、MCPによるスキルへのアクセスを参照してください。
トラブルシューティング
- エージェントは
ug configure回のランの後に動作を停止します。 エージェント (ug <your-agent>) を起動または再起動します。このコマンドは、エージェントがモデルにサインインする方法を変更します。
次のステップ
- このチュートリアルの背景にある概念については、Unity Gatewayでのスキルサポートを参照してください。
- 独自のスキルを公開するには、Unity Gatewayスキルの作成と共有を行ってください。
- スキルの管理:スキルを読み取りおよび共有できるユーザーを制御する権限を設定します。