@dbx-tools/model-protocol

中文文档
0.9.206发布于 2026/11/11Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 8011

Vercel AI SDK 供应商和用于服务 Databricks 的模型协议转换

中文使用文档
文档目录3 节
  1. 启动 Databricks 模型
  2. 翻译网关请求
  3. 议定书的覆盖范围和限制

@dbx-tools/ 模范- protocol

构建用于 Databricks 端点和翻译的 Vercel AI SDK ProverV4 模型 支持的示范协议之间的网关流量 .

启动 Databricks 模型

解析端点协议后构造 AI SDK 模式并更新 当前请求的认证信头 :

import { createDatabricksLanguageModel } from "@dbx-tools/model-protocol/provider";
import { generateText } from "ai";

const model = createDatabricksLanguageModel({
  host: process.env.DATABRICKS_HOST!,
  modelId: "databricks-gpt-5-6-sol",
  protocol: "responses",
  headers: { authorization: `Bearer ${process.env.DATABRICKS_TOKEN}` },
});

const result = await generateText({ model, prompt: "Summarize the incident." });
console.log(result.text);

当节点服务需要时使用此软件包 :

  • 为 Databricks 聊天补全构建一个请求扫描的 AI SDK 模型, 反应,或Anthropic消息.
  • 将 OpenAI 或 Anthropic 网关消息翻译为 AI SDK 消息.
  • 正常的 Databricks Chat 完成请求和响应线形.

示范发现和能力政策仍在实施 @dbx-tools/model。 。 。 . 浏览器安全模式和网关合同仍在 @dbx-工具/共享型号 财务报告和审定财务报表 @dbx-tools/shared-model-gateway (英语)。 。 。 .

使用 chat, (中文(简体) ), responses,或 anthropic 根据模型自主协议 选择。 聊天服务商通过一个 供应商-当地 fetch不补丁 globalThis.fetch。 。 。 .

翻译网关请求

将 OpenAI 或 Anthropic 请求解码为 AI SDK 消息并编码 完成生成返回呼叫者协议 :

import { decodeGatewayRequest } from "@dbx-tools/model-protocol/gateway-decode";
import { encodeGatewayResponse } from "@dbx-tools/model-protocol/gateway-encode";
import { createDatabricksLanguageModel } from "@dbx-tools/model-protocol/provider";
import { generateText } from "ai";

const protocol = "openai-chat" as const;
const decoded = decodeGatewayRequest(protocol, {
  messages: [{ role: "user", content: "Hello" }],
});
const model = createDatabricksLanguageModel({
  host: process.env.DATABRICKS_HOST!,
  modelId: "databricks-gpt-5-6-sol",
  protocol: "responses",
  headers: { authorization: `Bearer ${process.env.DATABRICKS_TOKEN}` },
});
const generated = await generateText({ model, ...decoded });

const response = encodeGatewayResponse(protocol, "databricks-gpt-5-6-sol", {
  text: generated.text,
  toolCalls: generated.toolCalls,
  usage: generated.usage,
  finishReason: generated.finishReason,
});

使用 encodeGatewayStream() 而不是在转发时 streamText().fullStream。 。 。 . 解码器和编码器共享工具调用、推理、使用和完成理由 处理 Mastra 和模型网关之间.

议定书的覆盖范围和限制

提供方支持 Databricks 聊天补全,响应,以及 Anthropic Messages. (原始内容存档于2018-09-27). 网关解码器和编码器支持 OpenAI Chat 用于缓冲和 流出文本和函数工具流量。 模式网关发送嵌入 直接且不通过这个包来翻译它们.

Fallback 翻译保存了文本,函数工具,工具结果,推理 事件、象征性使用和结束原因。 它不执行状态 反应特征,例如: previous_response_id, (中文(简体) ), store: true,或 background: true。 。 。 .

Chat 提供者的请求范围获取删除不支持的字段, 应用 GPT 5.6 工具调用推理相容性,条纹提供者推理块 无法重放,在工具结果后修复助手预填,以及 平整数组值响应内容,同时保留返回思维为 AI SDK推理事件. 它不会改变 globalThis.fetch。 。 。 .

版本与发布记录

@dbx-tools/model-protocol 共发布 71 个版本,首次发布于 2026/10/10;过去 12 个月发布了 71 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.9.206latest2026/11/11今天
0.9.2052026/11/111 天前
0.9.2032026/11/074 天前
0.9.2022026/11/065 天前
0.9.2012026/11/056 天前
0.9.2002026/11/056 天前

关于 @dbx-tools/model-protocol 的常见问题

@dbx-tools/model-protocol 是什么?

Vercel AI SDK 供应商和用于服务 Databricks 的模型协议转换

如何安装 @dbx-tools/model-protocol?

在项目目录运行 npm install @dbx-tools/model-protocol,或使用 pnpm add / yarn add / bun add。

@dbx-tools/model-protocol 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dbx-tools/model-protocol 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@dbx-tools/model-protocol 可以商用吗?

@dbx-tools/model-protocol 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@dbx-tools/model-protocol 的下载量有多少?

根据 npm 官方下载统计,@dbx-tools/model-protocol 在 2026/10/12 – 2026/11/10 这 30 天内被下载 8,011 次,日均约 267 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dbx-tools/model-protocol 还在维护吗?

最新版本 0.9.206 发布于 2026/11/11(今天);至今共发布 71 个版本,其中过去 12 个月发布了 71 个;首次发布于 2026/10/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。