# @fleetbase/ai-engine 中文文档

规范地址：https://npmcn.com/package/%40fleetbase/ai-engine/

版本：0\.0\.5
npm 元数据更新时间：2026-09-22T11:42:58.541Z
中文译文更新时间：2026-11-14T22:45:03.729Z
软件包许可：AGPL-3\.0-or-later

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

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

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

- 包体积（解压后）：1.5 MB，196 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>= 18
- 运行依赖：16 个
- peer 依赖：ember-engines ^0\.9\.0
- 首次发布：2026-07-01T07:58:13.316Z
- 最新版本发布：2026-09-22T11:42:58.368Z
- 近 30 天下载量：2423（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

机队基地AI业务副驾驶和任务自动化模块

## 安装

```sh
npm install @fleetbase/ai-engine
```

也可以使用：`pnpm add @fleetbase/ai-engine`、`yarn add @fleetbase/ai-engine`、`bun add @fleetbase/ai-engine`

## README

# 舰队基地AI

[![Coverage](https://codecov.io/gh/fleetbase/ai/branch/main/graph/badge.svg)](https://codecov.io/gh/fleetbase/ai)

Fleetbase AI是Fleetbase的操作副驾驶和任务自动化模块. 它为Fleetbase控制台增加了一个全球AI提示,将每个AI转弯记录为可审计的任务,并给予Fleetbase扩展一个能曝光安全AI可读上下文和可预览动作的能力框架.

这个扩展与Fleetbase CLI并用脚手架,包含Ember引擎和Laravel后端软件包,用于 `fleetbase/ai`。 。 。 .

## 当前状况

本单元正在积极开发。 目前版本包括:

-   从头盘打开一个全球浮动舰队基地AI提示.
-   与历史,续作相接,结束相接,并软删除支持相接.
-   使Fleet Base AI能够使用的全系统管理配置,并选择一个提供者/模型.
-   OpenAI, Claude, 和本地预览提供者支持.
-   持久性 `ai_tasks`, (中文(简体) ), `ai_task_steps`,以及 `ai_sessions` 记录.
-   标记下响应渲染,包括列表,链接,内含代码,以及简单的表格.
-   附件上传AI回合的引用 .
-   模块注册读取/文本能力和预览/应用行动的能力登记册.
-   机队-Ops飞行员能力,包括命令上下文/透视和紧凑的创建-命令预览流.

## 安装

如任何舰队基地扩展包一样安装此扩展 :

```bash
flb install fleetbase/ai --path /path/to/fleetbase
```

这个 `--path` 值应该指向包含两者的 Fleetbase 实例目录 `console/` 财务报告和审定财务报表 `api/`。 。 。 .

为在舰队基地工作空间内进行当地开发,确保控制台工作空间包括: `@fleetbase/ai-engine`,然后在前端修改后重建控制台资产.

## 管理员配置

舰队基地AI由管理员在全系统配置. 提供商的钥匙不是每个公司储存的.

在控制台管理员设置中:

1.  打开 **AI > 提供者设置**。 。 。 .
2.  启用舰队基地AI.
3.  选择一个提供者.
4.  从后端支持的模型列表中选择默认模型.
5.  输入选定提供者的提供者证书.
6.  保存并测试提供者.

支助提供者:

-   **本地预览**: 用于开发和UI测试的本地非网络占位符提供者.
-   **开放AI**:反应API集成.
-   **克劳德**: Anthropic Messages API集成. 星洲网.

基础URL作为高级设置处理并默认为犬科提供者API终点.

## 控制台体验

启用后,Fleetbase AI在Fleetbase控制台头上注册了紧凑的魔法需要托盘按钮. 同样的提示可以通过配置的键盘快捷键在全球打开.

提示支持:

-   持续开会,而不是丢弃一次性提示.
-   多行扩展输入.
-   用户和AI在笔录中翻出.
-   带有删除控件的会话历史 .
-   已上传文件引用, 用于未来特定能力解析 .
-   动作预览卡,如Fleet-Ops创建-顺序预览(每个回答几个).
-   AI提供的控制台动作的确认卡,例如打开一页或创建对话框.
-   缩略图对答案的上下反馈 .

关闭提示只隐藏它。 聊天会话持续到用户开始新聊天,结束当前聊天,或从历史中删除会话.

## 如何确定答案的依据

在OpenAI或Claude启用后,每个提示作为工具调用的对话运行. 该模型在回答之前先查找信息, 而不是依赖内存 :

-   **文档**数字 : `search_docs` 财务报告和审定财务报表 `read_doc` (fleetbase.io/docs)。 答案会链接他们使用的页面.
-   **公司数据**数字 : `count_records`, (中文(简体) ), `group_count`,以及 `list_records` 查询允许的列表资源扩展注册,范围为组织及用户权限. 无效的过滤器返回错误而不是被忽略 .
-   **控制台动作**数字 : `find_console_commands` 财务报告和审定财务报表 `propose_console_command` 提供打开一页或一对话框(例如IAM QQ用户QQ创建用户). 用户看到确认卡,在确认前什么都不会运行;服务器此时重新检查权限.
-   **扩展工具**:模块添加自己的,例如Fleet-Ops记录搜索和订单草稿.

每个工具调用都被记录为任务步骤. 关机 **用工具查找答案** 在提供者设置中,返回到旧的单请求模式.

### 谁知道

只有用户 `type` 实值 `admin` 是系统管理员。 其他所有人,包括组织"管理员"角色,都作为组织用户来回答:关于系统设置的文档页面和章节,服务证书,环境变量,以及自我托管在服务器上被过滤出,管理员控制台的动作从不提供,系统即时告诉模型将这些需要提交系统管理员.

### 文件索引

文件从舰队基地.io sitemap编成 `ai_knowledge_documents` 财务报告和审定财务报表 `ai_knowledge_chunks` (MySQL全文搜索),每周刷新,并被观众贴上标签(MySQL)`server/config/ai.php` → `knowledge.docs`) (中文(简体) ). 一艘快艇进入 `server/resources/ai-knowledge` 并自动加载,当没有索引时,所以没有互联网接入的事例仍然有文档.

```bash
php artisan ai:sync-docs                     # crawl fleetbase.io/docs
php artisan ai:sync-docs --snapshot          # load the packaged snapshot
php artisan ai:sync-docs --write-snapshot=server/resources/ai-knowledge/docs-snapshot.json.gz
```

系统管理员可以检查索引并触发同步 **行政 AI 配置 知识库**。 。 。 .

## 能力框架

Fleetbase AI不给予供应商任意数据库访问权限. 模块通过注册能力明确暴露AI功能.

能力可以提供:

-   读取/文本数据作为提示 .
-   只预览动作 .
-   确认应用动作 .
-   允许元数据.
-   模块特定UI预览组件.

Fleet-Ops是第一个使用这个框架的试验模块. 它的初始能力是有意保守的:读取/报告上下文和预览-肯定-应用动作,而不是沉默的突变.

## 机队-操作飞行员

舰队-Ops飞行员目前侧重于有用的业务工作流程:

-   回答有关命令和业务资源的问题.
-   提出有限度的见解和简单的报告.
-   返回 Docs/ 为 Fleet-Ops 工作流程提供的帮助上下文 .
-   由自然语言提示预览Fleet-Ops命令创建.

创建命令动作使用为AI快取设计的专用紧凑预览组件. 预览可以显示取取/放行细节,小路由预览,驱动/车辆分配字段,POD和调度切换,注释,以及明确的创建/取消控制.

在用户确认预览之前,命令不会被创建.

## 扩展的控制台命令

扩展注册控制台从服务供应商获取的行动。 定义是平面数组,所以扩展不需要依赖于此软件包的类:

```php
$this->callAfterResolving(\Fleetbase\Ai\Support\Commands\AiCommandRegistry::class, function ($commands) {
    $commands->registerMany([[
        'id'          => 'my-extension.widgets.create',
        'label'       => 'Create widget',
        'breadcrumb'  => 'My Extension › Widgets',
        'description' => 'Open the new widget form.',
        'steps'       => [
            ['type' => 'navigate', 'route' => 'console.my-extension.widgets.index'],
            ['type' => 'service', 'engine' => '@vendor/my-extension-engine', 'service' => 'widget-actions', 'method' => 'modal.create'],
        ],
        'permissions' => ['my-extension create widget'],
    ]]);
});
```

`service` 步骤在引擎的资源动作服务上调用一个方法,所以从 AI 提示打开的对话框和从扩展页打开的对话框一样。 验证路线和服务方法

```bash
node scripts/verify-ai-commands.mjs --console ../../console --packages ..
```

## 日志、反馈和评价

-   用户以拇指上下按答. 评分可过滤于 **管理 — AI 配置 — 任务和聊天日志**,与已退化的答案(能力失败)和断接答案相配合.
-   日志视图完整显示每个对话:每个即时和回答,每个即时和回答,每个步骤包括每个工具调用的论点和结果以及准确的系统即时和发送到模型的信息. 它要求 `ai view audit logs` 允许.
-   从管理员视图导出日志, 或使用 `php artisan ai:export-logs --from=2026-09-01 --format=jsonl`导出使用与日志视图相同的过滤器,包含用户内容,需要 `ai view audit logs`,并记录在访问日志中.
-   `php artisan ai:eval` 运行黄金大小写 `server/resources/ai-eval/cases.json` (从真实的谈话中抽取)对已配置的提供者,报告通过率. 它呼叫提供者,所以它要求确认;使用 `--model` 比较模型.
-   `php artisan ai:replay <task-uuid>` 重运行一个记录的翻转通过当前运行时间并打印两个答案.

## 开发检查

前端检查 :

```bash
./node_modules/.bin/eslint addon/services/ai.js addon/components/ai-prompt.js
./node_modules/.bin/ember-template-lint addon/components/ai-prompt.hbs
./node_modules/.bin/stylelint addon/styles/ai-engine.css
```

后端检查 :

```bash
composer test:unit
composer test:lint
```

本地模板- lint 配置可能打印 `Invalid rule configuration found: no-down-event-binding` ,同时仍然成功退出.

## 页:1

-   计费和SaaS计量是有意在本单元之外进行的.
-   托肯用法作为提供者遥测保留.
-   会话删除是软删除;任务和步骤记录保留以备审计.
-   用户界面副本应使用 `Fleet-Ops` 用于操作模块名称.

## 常见问题

### @fleetbase/ai-engine 是什么？

机队基地AI业务副驾驶和任务自动化模块

### 如何安装 @fleetbase/ai-engine？

在项目目录运行 npm install @fleetbase/ai-engine，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：ember-engines（^0\.9\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fleetbase/ai-engine 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fleetbase\_\_ai-engine 是否存在。

### @fleetbase/ai-engine 需要什么版本的 Node\.js？

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

### @fleetbase/ai-engine 可以商用吗？

@fleetbase/ai-engine 使用 AGPL-3\.0-or-later 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @fleetbase/ai-engine 的下载量有多少？

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

### @fleetbase/ai-engine 还在维护吗？

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