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

チュートリアル: 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.

ご自身で行う場合は、ターミナルで同じコマンドを実行してください:

Bash
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

はい

はい

新しいバージョンを入手するには、もう一度downloadしてください

定期的に使用するスキル

スキーマをライブでロードする

はい

No

最新の公開バージョンを読み込みます

頻繁に変更される一連のスキル

手法

セッション間で永続化されます

オフラインで動作します

アップデートを取得する

どのようなタスクにベストなのか

単一セッションのスキルを読み込む

No

No

現在のバージョンをロードします

単一タスク

スキルをdownload

はい

はい

新しいバージョンを入手するには、もう一度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.

または、コマンドを自分でランします:

Bash
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.

または、コマンドを自分でランします:

Bash
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>) を起動または再起動します。このコマンドは、エージェントがモデルにサインインする方法を変更します。

次のステップ​