# @dbx-tools/model-protocol 中文文档

规范地址：https://npmcn.com/package/%40dbx-tools/model-protocol/

版本：0\.9\.206
npm 元数据更新时间：2026-11-10T19:20:00.167Z
中文译文更新时间：2026-11-11T17:51:42.741Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dbx-tools/model-protocol
原文对照：https://npmcn.com/package/%40dbx-tools/model-protocol/?lang=original
项目主页：https://github.com/reggie-db/dbx-tools#readme
源码仓库：https://github.com/reggie-db/dbx-tools

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：219 kB，19 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：8 个
- 首次发布：2026-10-10T15:01:50.627Z
- 最新版本发布：2026-11-10T19:19:59.813Z
- 近 30 天下载量：8011（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：71（近 12 个月 71 个）

## 中文简介

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

## 安装

```sh
npm install @dbx-tools/model-protocol
```

也可以使用：`pnpm add @dbx-tools/model-protocol`、`yarn add @dbx-tools/model-protocol`、`bun add @dbx-tools/model-protocol`

## README

# @dbx-tools/ 模范- protocol

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

## 启动 Databricks 模型

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

```ts
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-工具/共享型号](https://npmcn.com/package/shared/model) 财务报告和审定财务报表 [@dbx-tools/shared-model-gateway (英语)](https://npmcn.com/package/shared/model-gateway)。 。 。 .

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

## 翻译网关请求

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

```ts
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 是什么？

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 和提交记录判断。