次のような場合に使用: トークン数で課金される基礎的なAIモデル（利用量に応じて費用が発生するモデル）の照会または呼び出し、あるいはUnity Gateway（Unity AI Gatewayとも呼ぶ）サービスの作成・更新・一覧表示・照会を行う場合。これにはAIモデル提供者のサービス、MCPサービス、system.aiサービス、および3部構成のUnity Catalogサービス名（カタログ.スキーマ.サービス）が含まれます。 また、Unity Gateway上の支出予算と使用量アラートの管理、従来型のAI Gatewayからの移行にも使用します。 モデル提供エンドポイント（提供元）の権限（例えばCAN_QUERY）を持つワークロードが、3部構成のモデル名を照会する際に「アクセス拒否」エラーが発生した場合にも使用してください。これは、提供エンドポイント経由のアクセス権では、Unity Gatewayサービスへのアクセス権が得られないためです。 **注記:** モデル提供エンドポイント上の従来型AI Gatewayの設定には使用しません。その場合は databricks-model-serving を使用してください。
Use when querying or calling pay-per-token foundation models, or when creating, updating, listing, or querying Unity Gateway (also called Unity AI Gateway) services, including model provider services, MCP services, system.ai services, and three-part Unity Catalog service names (catalog.schema.service). Also use for managing spend budgets and usage alerts on Unity Gateway, and for migrating from legacy AI Gateway. Also use when a workload with Model Serving endpoint permissions (for example CAN_QUERY) gets PERMISSION_DENIED querying a three-part model name, since serving-endpoint access does not grant access to a Unity Gateway service. Not for configuring legacy AI Gateway on Model Serving endpoints; use databricks-model-serving for that.
親スキルの databricks-core を使用して、CLIの認証とプロファイル選択を行ってください。
Unity Gateway は、AIサービスへの管理された安全なアクセスを提供する Unity Catalog リソースです。CLIコマンドグループは、以前の製品名を保持しています: databricks ai-gateway --help
| リクエスト内容 | 使用するスキル |
|---|---|
| Unity Gateway モデルサービス、MCP（マルチプロトコル接続）サービス、またはモデルプロバイダーサービス | このスキルと databricks ai-gateway |
Model Serving エンドポイント上の AI Gateway 設定（put-ai-gateway を含む） |
databricks-model-serving と databricks serving-endpoints |
| Lakeflow Connect インジェスション（データ取り込み）ゲートウェイ | databricks-lakeflow-connect |
リソースが Unity Catalog セキュラブル（管理対象リソース）である場合、Unity AI Gateway を Unity Gateway の以前の名称として扱ってください。ユーザーが明示的に移行を要求しない限り、レガシー（旧式）Model Serving AI Gateway リソースを Unity Gateway リソースに変換しないでください。
Databricks CLI を使用して、リソースのライフサイクル（作成・更新・削除などの一連の段階）と権限管理を行ってください。これらの操作では REST 呼び出しや Databricks SDK を代替手段として使用しないでください。モデルおよびモデルプロバイダーサービスのクエリにはPythonクライアントが対応しています。サービスのクエリを参照してください。
Unity Gateway、Unity AI Gateway、または databricks ai-gateway への明示的なリクエストはこのスキルに属します。リクエストにモデルサービスまたはワークスペースが関係しているという理由だけで databricks-model-serving に切り替えないでください。レガシー（旧式）のエンドポイント単位の AI Gateway 操作または予約済みスループット（リソース処理能力）の宛先が Model Serving エンドポイント詳細を必要とする場合にのみそのスキルを使用してください。
CLIが最小バージョンを満たしていることを確認します:
databricks --version
コマンドと関連する操作を検査した後で、ペイロード（リクエストボディ）を作成します:
databricks ai-gateway --help
databricks ai-gateway <operation> --help
作成および更新の設定は --json を通じて渡します。プロファイルベースの認証が必要な場合は、明示的にプロファイルを指定してください:
databricks ai-gateway <operation> --json @payload.json --profile <PROFILE>
レガシー API の類似の名前から JSON フィールドを作成しないでください。ペイロードはインストール済みの CLI ヘルプおよび選択したサービスタイプの Unity Gateway ドキュメントから構築してください。
| サービスタイプ | CLI コマンド |
|---|---|
| モデルサービス | create-model-service, get-model-service, list-model-services, update-model-service, delete-model-service；モデルサービスを参照 |
| MCP サービス | create-mcp-service, get-mcp-service, list-mcp-services, update-mcp-service, delete-mcp-service；MCP サービスを参照 |
| モデルプロバイダーサービス | create-model-provider-service, get-model-provider-service, list-model-provider-services, update-model-provider-service, delete-model-provider-service；モデルプロバイダーサービスを参照 |
すでにこれらのリファレンスでカバーされているフィールドについては、公開ドキュメントを取得しないでください。リファレンスに必須フィールドがない場合、またはユーザーが明示的に最新のドキュメントを要求した場合にのみ、公式ドキュメントを参照してください。インストール済みの CLI ヘルプまたは現在のドキュメントが明示的に示していない限り、ベータ版またはプレビュー状態を割り当てないでください。
ワークスペーススコープの Model Serving エンドポイントから Unity Catalog スコープの Unity Gateway サービスに移行する場合は、references/model-serving-migration.mdを読んでください。
Use the parent databricks-core skill for CLI authentication and profile selection.
Unity Gateway provides Unity Catalog securables for governed access to AI services. The CLI
command group keeps the earlier product name: databricks ai-gateway --help.
| Request | Use |
|---|---|
| Unity Gateway model service, MCP service, or model provider service | This skill and databricks ai-gateway |
AI Gateway configuration on a Model Serving endpoint, including put-ai-gateway |
databricks-model-serving and databricks serving-endpoints |
| Lakeflow Connect ingestion gateway | databricks-lakeflow-connect |
Treat Unity AI Gateway as an earlier name for Unity Gateway when the resource is a Unity Catalog securable. Do not translate legacy Model Serving AI Gateway resources into Unity Gateway resources unless the user explicitly requests a migration.
Use the Databricks CLI for resource lifecycle and permission management. Do not substitute direct REST calls or a Databricks SDK for those operations. Python clients are supported for querying model and model provider services; read Query services.
An explicit request for Unity Gateway, Unity AI Gateway, or
databricks ai-gateway belongs to this skill. Do not switch to
databricks-model-serving merely because the request involves a model service or a
workspace. Use that skill only for a legacy per-endpoint AI Gateway operation or when a
provisioned-throughput destination requires Model Serving endpoint details.
Verify the CLI meets the minimum version:
databricks --version
Inspect the command and the relevant operation before constructing a payload:
databricks ai-gateway --help
databricks ai-gateway <operation> --help
Pass create and update configuration through --json. Use an explicit profile when
profile-based authentication is required:
databricks ai-gateway <operation> --json @payload.json --profile <PROFILE>
Do not invent JSON fields from similarly named legacy APIs. Build the payload from the installed CLI help and the Unity Gateway documentation for the selected service type.
| Service type | CLI operations |
|---|---|
| Model service | create-model-service, get-model-service, list-model-services, update-model-service, delete-model-service; read Model services |
| MCP service | create-mcp-service, get-mcp-service, list-mcp-services, update-mcp-service, delete-mcp-service; read MCP services |
| Model provider service | create-model-provider-service, get-model-provider-service, list-model-provider-services, update-model-provider-service, delete-model-provider-service; read Model provider services |
Do not fetch public documentation for fields already covered by these references. Consult the authoritative documentation only when a required field is absent from the reference or the user explicitly asks for the latest documentation. Do not assign a Beta or preview status unless the installed CLI help or current documentation explicitly does so.
When migrating from workspace-scoped Model Serving endpoints to Unity Catalog-scoped Unity Gateway services, read references/model-serving-migration.md.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。