# @ansible/ansible-ai-connect-chatbot 中文文档

规范地址：https://npmcn.com/package/%40ansible/ansible-ai-connect-chatbot/

版本：0\.1\.17
npm 元数据更新时间：2026-09-21T21:19:21.698Z
中文译文更新时间：2026-11-06T17:05:25.458Z
软件包许可：未声明

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

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

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

- 包体积（解压后）：4.2 MB，27 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：react ^18\.3\.1，react-dom ^18\.3\.1
- 首次发布：2025-04-02T21:04:17.332Z
- 最新版本发布：2026-09-21T21:19:21.342Z
- 近 30 天下载量：2641（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 11 个）

## 中文简介

要开始建设"Chatbot"项目,你需要:

## 安装

```sh
npm install @ansible/ansible-ai-connect-chatbot
```

也可以使用：`pnpm add @ansible/ansible-ai-connect-chatbot`、`yarn add @ansible/ansible-ai-connect-chatbot`、`bun add @ansible/ansible-ai-connect-chatbot`

## README

# Ansible AI 连接聊天机器人 UI

## 从源头构建

要开始建设"Chatbot"项目,你需要:

-   节点( e)`18.20.0` 用于发展)
-   无`10.5.0` 用于发展)

安装依赖, **确保当前目录 这是 `ansible_ai_connect_chatbot` 第一分目录**数字 :

```commandline
 cd (your_git_work_directory)/ansible-ai-connect-service/ansible_ai_connect_chatbot
```

运行

```commandline
npm install
```

## 可用的脚本

### npm 开始

在开发模式下运行应用程序. 在开发模式中, 用户界面试图连接本地聊天机服务 `http://localhost:8080/v1/query`。如果需要连接 到不同的 URL,编辑 `useChatbot.ts`。 。 。 .

### npm 运行构建

构建捆绑的javascript/ cs 文件 .

捆绑的javascript/ cs 文件被复制到 `../ansible_ai_connect/main/static/chatbot` 编辑 `index.html` 文件被复制到 `../ansible_ai_connect/main/templates/chatbot/`。 。 。 .

### npm 运行测试

执行单位测试.

### npm 运行覆盖

执行单位测试 密码覆盖报告. 报告文本显示在控制台上, 在 HTML 版本和 `lcov.info` 文件已保存 输入 `coverage` 子目录.

## 本地环境中的测试聊天机器人

**全部启用聊天机 界定了以下三个参数:**

1.  `ModelPipelineChatBot.config.inference_url` 要使用的聊天服务的 URL .
2.  `ModelPipelineChatBot.config.model_id` 默认AI模型. 应该是 在聊天服务使用的配置中定义的模型之一.
3.  `CHATBOT_DEFAULT_PROVIDER` 默认 AI 模型提供者 。 应该是 在聊天服务所使用的配置中定义的提供者之一.

```commandline
CHATBOT_DEFAULT_PROVIDER=wisdom
```

```json
{
  "ModelPipelineChatBot": {
    "config": {
      "inference_url": "http://127.0.0.1:8080",
      "model_id": "granite-3.3-8b-instruct"
    }
  }
}
```

## 发行和出版

运行以下 GH 工作流程,顺序 :

1\. [AAP 聊天机 - 发布](https://npmcn.com/package/%40ansible/.github/workflows/ui_release_aap_chatbot.yml) 它通过运行测试来验证软件包,如果成功的话,会用软件包信息创建一个新的Pull Request.

2\. 国家 [AAP 聊天机 - 发布](https://npmcn.com/package/%40ansible/.github/workflows/ui_publish_aap_chatbot.yml) 释放后就应该逃跑了 它通过运行测试来验证软件包,如果成功,它会构建,组装并发布新的软件包 [软件包版本为 npmjs](https://www.npmjs.com/package/@ansible/ansible-ai-connect-chatbot?activeTab=versions)。 。 。 .

注:将整个过程分成两个不同的工作流程,这样,在如何发布和何时发布方面,就更具有灵活性. 注: [npmjs 发布新软件包的准则](https://docs.npmjs.com/updating-your-published-package-version-number)。 。 。 .

## 常见问题

### @ansible/ansible-ai-connect-chatbot 是什么？

要开始建设"Chatbot"项目,你需要:

### 如何安装 @ansible/ansible-ai-connect-chatbot？

在项目目录运行 npm install @ansible/ansible-ai-connect-chatbot，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.3\.1）、react-dom（^18\.3\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ansible/ansible-ai-connect-chatbot 支持 TypeScript 吗？

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

### @ansible/ansible-ai-connect-chatbot 支持 ESM 还是 CommonJS？

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

### @ansible/ansible-ai-connect-chatbot 可以商用吗？

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

### @ansible/ansible-ai-connect-chatbot 的下载量有多少？

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

### @ansible/ansible-ai-connect-chatbot 还在维护吗？

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