# @ax-llm/ax-ai-aws-bedrock 中文文档

规范地址：https://npmcn.com/package/%40ax-llm/ax-ai-aws-bedrock/

版本：25\.4\.9
npm 元数据更新时间：2026-11-06T20:39:42.199Z
中文译文更新时间：2026-11-07T16:14:05.917Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40ax-llm/ax-ai-aws-bedrock
原文对照：https://npmcn.com/package/%40ax-llm/ax-ai-aws-bedrock/?lang=original
项目主页：https://github.com/ax-llm/ax#readme
源码仓库：https://github.com/ax-llm/ax

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

- 包体积（解压后）：245 kB，8 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2025-10-19T08:37:46.814Z
- 最新版本发布：2026-11-06T20:39:41.894Z
- 近 30 天下载量：5171（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：222（近 12 个月 217 个）

## 中文简介

AWS Bedrock 为 AX 提供设备 - 支持 Claude, GPT OSS 和 Titan Embed 模型

## 安装

```sh
npm install @ax-llm/ax-ai-aws-bedrock
```

也可以使用：`pnpm add @ax-llm/ax-ai-aws-bedrock`、`yarn add @ax-llm/ax-ai-aws-bedrock`、`bun add @ax-llm/ax-ai-aws-bedrock`

## README

# AWS 轴的贝德洛克提供者

Ax 使用 AWS SDK 的原生亚马逊 Bedrock 集成 `Converse`, (中文(简体) ), `ConverseStream`还有泰坦嵌入API. 分道扬镳 `@ax-llm/ax` 仍然没有 AWS SDK 依赖性.

## 特征

-   Claude,GPT-6,和GPT OSS聊天模式,外加Titan Embed V2
-   本地流,取消和输出前区域故障
-   Claude工具的使用和工具成果往返旅行
-   Claude 图像和文档输入,包括内置基础64和 `s3://` 文档
-   5分钟和1小时经核实的Bedrock快速卡塞检查站
-   预算和适应性的克洛德思维,包括签名的推理往返旅行
-   具体模式的本地结构产出和服务层次
-   托肯,缓存-托肯, 请求ID, 完成理由, 和应用级映射

能力因型号而异. 使用 `ai.getFeatures(model)` 要求生效之前 特性; 不支持的能力被故意不公布.

## 安装

```bash
npm install @ax-llm/ax @ax-llm/ax-ai-aws-bedrock
```

贝德洛克软件包安装 `@aws-sdk/client-bedrock-runtime` 作为自己的 运行时间依赖。 应用程序不需要单独添加 SDK .

## 认证

客户端使用标准的AWS SDK认证链. 配置证书 通过您的环境,共享 AWS 配置,工作量角色,或者另一个 SDK - 支持证书来源.

## 快开始

```typescript
import {
  AxAIBedrock,
  AxAIBedrockModel,
} from '@ax-llm/ax-ai-aws-bedrock';

const ai = new AxAIBedrock({
  region: process.env.AWS_REGION ?? 'us-east-2',
  fallbackRegions: ['us-west-2', 'us-east-1'],
  config: {
    model: AxAIBedrockModel.ClaudeSonnet5,
    maxTokens: 4096,
  },
});

const response = await ai.chat({
  chatPrompt: [{ role: 'user', content: 'What is Amazon Bedrock?' }],
});

if (response instanceof ReadableStream) {
  throw new Error('Expected a non-streaming response.');
}

console.log(response.results[0]?.content);
```

## 水流、工具、缓存和思考

```typescript
const weatherTool = {
  name: 'weather',
  description: 'Read the current weather for a city',
  parameters: {
    type: 'object',
    properties: {
      city: { type: 'string', description: 'City name' },
    },
    required: ['city'],
  },
} as const;

const stream = await ai.chat(
  {
    chatPrompt: [
      { role: 'system', content: 'Use tools for live facts.', cache: true },
      { role: 'user', content: 'What is the weather in Vancouver?' },
    ],
    functions: [weatherTool],
  },
  {
    stream: true,
    contextCache: { ttlSeconds: 3600 },
    thinkingTokenBudget: 'medium',
  }
);
```

缓存检查站可以设置在系统消息,内容块,消息,以及 函数与 `cache: true`贝德罗克每个检查站最多接受四个检查站 ; 提供者在发送前验证该合并限制.

Claude Sonnet 5 和 Opus 5.5 总是采用适应性思维,所以 `thinkingTokenBudget: 'none'` 被拒绝 对于这些模型。 克洛德·奥普斯5号 允许适应性思维被禁用. Opus 5.5 还拒绝强制工具 选择和选择 `output_config.format` 在 Conversion 上,因此其结构化输出使用 页:1 `json_object` 模式.

在GPT-6 Sol、Luna和Astra上, `thinkingTokenBudget` 设定推理工作: `minimal` 地图到 `low`, (中文(简体) ), `highest` 改为 `max`,以及 `none` 关闭推理. Astra不能关闭推理,所以 `'none'` 在申请被驳回之前 发送。 这些模型不接受 `temperature` 或者说 `topP`因此,提供者 离开他们的请求.

## 原生图像和文档输入

```typescript
const response = await ai.chat({
  chatPrompt: [
    {
      role: 'user',
      content: [
        { type: 'text', text: 'Compare these inputs.' },
        { type: 'image', image: imageBase64, mimeType: 'image/png' },
        {
          type: 'file',
          fileUri: 's3://my-bucket/policy.pdf',
          filename: 'policy.pdf',
          mimeType: 'application/pdf',
        },
      ],
    },
  ],
});
```

支持的文档格式有 CSV, DOC, DOCX, HTML, Markdown, PDF, TXT, XLS, (原始内容存档于2018-09-26). and XLSX. 图像格式为GIF,JPEG,PNG,和WebP.

## 模型

目前克洛德·埃努姆成员包括索内5,奥普斯5.5,奥普斯5,奥普斯4.8, Sonnet 4.6, Haiku 4.5, Opus 4.5, Sonnet 4 并保留了 3.x相容性 模特们 OpenAI GPT-6 Sol、Luna和Astra使用它们 `us.` 跨区域 推论简介和支持工具、图像输入和本地或函数 标准级结构输出。 像GPT OSS 120B和20B一样,它们都是 发送给 `gptRegion` (默认) `us-west-2`)然后 `gptFallbackRegions` (默认) `us-east-1`泰坦嵌入V2仍然可用.

## 核查

从寄存器根 :

```bash
npm test --workspace=@ax-llm/ax-ai-aws-bedrock
```

## 常见问题

### @ax-llm/ax-ai-aws-bedrock 是什么？

AWS Bedrock 为 AX 提供设备 - 支持 Claude, GPT OSS 和 Titan Embed 模型

### 如何安装 @ax-llm/ax-ai-aws-bedrock？

在项目目录运行 npm install @ax-llm/ax-ai-aws-bedrock，或使用 pnpm add / yarn add / bun add。

### @ax-llm/ax-ai-aws-bedrock 支持 TypeScript 吗？

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

### @ax-llm/ax-ai-aws-bedrock 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @ax-llm/ax-ai-aws-bedrock 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ax-llm/ax-ai-aws-bedrock 可以商用吗？

@ax-llm/ax-ai-aws-bedrock 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @ax-llm/ax-ai-aws-bedrock 的下载量有多少？

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

### @ax-llm/ax-ai-aws-bedrock 还在维护吗？

最新版本 25\.4\.9 发布于 2026/11/07（1 天前）；至今共发布 222 个版本，其中过去 12 个月发布了 217 个；首次发布于 2025/10/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。