databricks-unity-gateway
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.
How do I install this agent skill?
npx skills add https://github.com/databricks/databricks-agent-skills --skill databricks-unity-gatewayIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a comprehensive management interface for Databricks Unity Gateway services using the Databricks CLI and Python. It correctly scopes its operations to the Databricks environment and includes robust security guidance for handling sensitive information, such as using environment variables and temporary files with restricted permissions.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Unity Gateway
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.
Choose the Correct Gateway
| 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.
CLI Workflow
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 Types
| 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 |
Querying and permissions
- Before writing Python that invokes a model or model provider service, read references/querying.md.
- Before checking, granting, or revoking Unity Gateway access, read references/permissions.md.
- Before any model-service operation, read references/model-services.md. It contains the current resource-name conventions, JSON payload fields, required-input gate, and lifecycle commands.
- Before any MCP-service operation, read references/mcp-services.md for the equivalent MCP-specific contract.
- Before any model-provider-service operation, read references/model-provider-services.md.
- Before setting up a spend budget or spend alert on Unity Gateway usage, read references/budgets.md.
- Before any account-scoped operation (account groups as grant principals, account budgets), read references/account-access.md.
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.
Migration from Model Serving to Unity Gateway
When migrating from workspace-scoped Model Serving endpoints to Unity Catalog-scoped Unity Gateway services, read references/model-serving-migration.md.
Authoritative Documentation
- Unity Gateway overview
- Unity Gateway release notes
- Unity Gateway developer documentation
- Model service API reference
- MCP service API reference
- Model provider service API reference
- Query model services
- Open Responses specification
- Open Responses provider behavior on Databricks
- Query model provider services
- Model service requirements and grants
- Model provider service governance
- Routing and fallbacks
- Rate limits
- Register an external MCP server
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/databricks/databricks-agent-skills/databricks-unity-gateway">View databricks-unity-gateway on skillZs</a>