databricks-unity-gateway

Unity Gateway

使用父级 databricks-core 技能处理 CLI 身份验证和配置文件选择。

Unity Gateway 提供 Unity Catalog 可保护对象，用于受管控地访问 AI 服务。CLI 命令组保留了早期产品名称：databricks ai-gateway --help。

选择正确的 Gateway

请求	使用
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 资源。

CLI 工作流

使用 Databricks CLI 管理资源生命周期和权限。不要用直接 REST 调用或 Databricks SDK 替代这些操作。支持使用 Python 客户端查询模型服务和模型提供商服务；请阅读查询服务。

明确要求使用 Unity Gateway、Unity AI Gateway 或 databricks ai-gateway 的请求属于此技能。不要仅因为请求涉及模型服务或工作区，就切换到 databricks-model-serving。只有在处理旧版的单端点 AI Gateway 操作，或预配吞吐量目标需要 Model Serving 端点详情时，才使用该技能。

1. 确认 CLI 满足最低版本要求：

   databricks --version
   

2. 在构造负载之前，检查命令和相关操作：

   databricks ai-gateway --help
   databricks ai-gateway <operation> --help
   

3. 通过 --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；请阅读模型提供商服务

查询和权限

• 在编写调用模型或模型提供方服务的 Python 代码之前，请阅读 references/querying.md。
• 在检查、授予或撤销 Unity Gateway 访问权限之前，请阅读 references/permissions.md。
• 在执行任何模型服务操作之前，请阅读 references/model-services.md。其中包含当前的资源名称约定、JSON 负载字段、必需输入门槛和生命周期命令。
• 在执行任何 MCP 服务操作之前，请阅读 references/mcp-services.md，了解对应的 MCP 专属规范。
• 在执行任何模型提供方服务操作之前，请阅读 references/model-provider-services.md。
• 在为 Unity Gateway 用量设置支出预算或支出提醒之前，请阅读 references/budgets.md。
• 在执行任何账户范围的操作（将账户组用作授权主体、账户预算）之前，请阅读 references/account-access.md。

对于这些参考资料已涵盖的字段，不要查阅公开文档。只有在参考资料中缺少必需字段，或用户明确要求查看最新文档时，才查阅权威文档。除非已安装的 CLI 帮助信息或当前文档明确说明，否则不要将功能标记为 Beta 或预览版。

从 Model Serving 迁移到 Unity Gateway

从工作区范围的 Model Serving 端点迁移到 Unity Catalog 范围的 Unity Gateway 服务时，请阅读 references/model-serving-migration.md。

权威文档

• Unity Gateway 概览
• Unity Gateway 发行说明
• Unity Gateway 开发者文档
• 模型服务 API 参考
• MCP 服务 API 参考
• 模型提供方服务 API 参考
• 查询模型服务
• Open Responses 规范
• Databricks 上的 Open Responses 提供方行为
• 查询模型提供方服务
• 模型服务要求和授权
• 模型提供方服务治理
• 路由和回退
• 速率限制
• 注册外部 MCP 服务