@cat-factory/provider-bedrock

中文文档
0.7.579发布于 2026/11/06TypeScriptES Module构建来源已验证近 30 天下载 6568

Opt-in AWS Bedrock模型注册 代理建筑局的AI提供外观. 混合到复合模型中以添加 bedrock 供养.

中文使用文档
文档目录7 节
  1. 为什么这是它自己的包
  2. 扶持它
  3. 节点/ 本地外观: 通过 env
  4. Cloudflare 工人外观:通过 registerModelRegistry
  5. 如何解决模式
  6. 配置( E) BedrockResolverOptions (中文(简体) )
  7. 相关

@ cat- factory/ productor- bedrok (英语)

选入 AWS 贝德洛克 cat-factory 的 AI 供给外观的模型解析器:让一个 部署通过 Amazon Bedrock 与(或代替) 内置直接 卖家.

为什么这是它自己的包

Bedrock支持在AWS Bedrock SDK(英语:@ai-sdk/amazon-bedrock + 键 ai)),为重 和任何没有使用贝德洛克的部署无关 保存在单独的选入中 软件包是指核心包和Cloudflare Worker Base Register 注册时不受SDK的限制: 只是一个假象,实际上电线 贝德洛克支付它。 提供单一供应商 (单位:千美元)bedrock改为a CompositeModelProvider 通过中性 ModelResolver 编号 : ProviderRegistry 从 @cat-factory/agents;没有模式分辨率逻辑重复.

扶持它

该套件输出两个助手:

  • bedrockResolver(opts) − a 个 ModelResolver 联 合 国 bedrock 供养.
  • bedrockRegistry(opts) − a 个 ProviderRegistry (单位:千美元){ bedrock: resolver }准备混入.

节点/ 本地外观: 通过 env

节点外接线自动接通 何时 BEDROCK_REGION 设定 (见 createNodeModelProviderResolver 内 backend/runtimes/node/src/modelProvider.ts; 其附录 bedrockRegistry(...) 至复合材料的额外登记册:

// ONE pair of readers, shared with the model catalog's `bedrock` capability: see below.
const bedrockRegion = bedrockRegionFromEnv(env)
if (bedrockRegion) {
  const supportedModels = bedrockAllowListFromEnv(env)
  extraRegistries.push(
    bedrockRegistry({
      region: bedrockRegion,
      accessKeyId: env.AWS_ACCESS_KEY_ID,
      secretAccessKey: env.AWS_SECRET_ACCESS_KEY,
      sessionToken: env.AWS_SESSION_TOKEN,
      ...(supportedModels ? { supportedModels: [...supportedModels] } : {}),
    }),
  )
}

因此,一个节点/局部部署只选择使用内嵌: BEDROCK_REGION (使能所需), 选项 AWS_ACCESS_KEY_ID 编号 : AWS_SECRET_ACCESS_KEY 编号 : AWS_SESSION_TOKEN (将使用 环境 AWS 证书链;实例角色, ~/.aws页:1 BEDROCK_MODELS (复合-分离的允许列表).

BEDROCK_MODELS 履行双重义务这就是为什么它被解析 bedrockAllowListFromEnv (单位:千美元)@cat-factory/server)而不是内含:同值变为 此解析器的允许列表 ProviderCapabilities.bedrockModels,以决定是否 分类模型 bedrock 口味在取取器中可以选择. 分开解析, 拾取者 可以提供这个解析器的识别码 细节 : model-support.md 第8条。 。 。 .

Cloudflare 工人外观:通过 registerModelRegistry

没有SDK的工人基地注册船;启动时部署混合了Bedrock 通过安装级模型提供者扩展点(见 backend/runtimes/cloudflare/src/infrastructure/ai/registries.ts:

import { registerModelRegistry } from '@cat-factory/worker'
import { bedrockRegistry } from '@cat-factory/provider-bedrock'

registerModelRegistry((env) => bedrockRegistry({ region: env.BEDROCK_REGION }))

登记是全过程的,由每个人阅读 buildContainer(env) 打电话,所以提供者 到达所有路径( HTTP 请求、 持久工作流程驱动程序、 和 cron 扫描器) 一个入口。 工厂收到运行时间 env因此,全权证书/区域来自 部署的配置.

登记也是在这个外观上解锁取物口味的. 工人读 BEDROCK_REGION 编号 : BEDROCK_MODELS 但只授予能力 (a) 已登记登记处能够实际服务 bedrock (单位:千美元)bedrockModelsCapability 内 ai/registries.ts: 仅凭env vars并不能证明这个包裹是混合的,并且提供 他们的口味会把排 在拾取器中 其调度失败。 设置但未注册的日志 a 警告名称已丢失 registerModelRegistry 电话.

如何解决模式

解析器向前 ref.model 给贝德罗克供应商的createAmazonBedrock(...)) (中文(简体) ). 一个模型是 由Bedrock模型id(例如:. anthropic.claude-3-5-sonnet-20240620-v1:0) (中文(简体) ). 何时 supportedModels 设置, 解决允许列表外的任意丢弃 Unsupported Bedrock model: <id> 在前面,因此一个配置错误的模型在清晰的情况下迅速失效 信件而不是深 AWS SDK 错误。 奥米 supportedModels 以转发任何模式标识.

配置( E)BedrockResolverOptions(中文(简体) )

选项目的
regionAWS区域,例如:. us-east-1。 。 。 .
accessKeyId明确 AWS 访问密钥; 不使用默认 AWS 证书链 .
secretAccessKey明确 AWS 密钥.
sessionToken明确AWS会话代号(临时全权证书).
baseURL覆盖 Bedrock 基础 URL(例如 VPC 端点).
supportedModels允许列表 Bedrock 型号 ids; 解决其外所抛出的任何问题. 允许任何.

猫因子选入的一部分 AWS 堆栈 并行 @cat-factory/provider-s3 (blob存储)和 @cat-factory/eks (跑者+环境后端). 每个都是 独立并登记在自己的接缝中:只将您使用的混合.

版本与发布记录

@cat-factory/provider-bedrock 共发布 554 个版本,首次发布于 2026/06/24;过去 12 个月发布了 554 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.7.579latest2026/11/062 天前
0.7.5782026/11/045 天前
0.7.5772026/11/045 天前
0.7.5762026/11/045 天前
0.7.5752026/11/045 天前
0.7.5742026/11/045 天前

关于 @cat-factory/provider-bedrock 的常见问题

@cat-factory/provider-bedrock 是什么?

Opt-in AWS Bedrock模型注册 代理建筑局的AI提供外观. 混合到复合模型中以添加 bedrock 供养.

如何安装 @cat-factory/provider-bedrock?

在项目目录运行 npm install @cat-factory/provider-bedrock,或使用 pnpm add / yarn add / bun add。

@cat-factory/provider-bedrock 支持 TypeScript 吗?

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

@cat-factory/provider-bedrock 支持 ESM 还是 CommonJS?

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

@cat-factory/provider-bedrock 可以商用吗?

@cat-factory/provider-bedrock 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@cat-factory/provider-bedrock 的下载量有多少?

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

@cat-factory/provider-bedrock 还在维护吗?

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