舰队基地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飞行员能力,包括命令上下文/透视和紧凑的创建-命令预览流.

安装

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

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 并自动加载,当没有索引时,所以没有互联网接入的事例仍然有文档.

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和调度切换,注释,以及明确的创建/取消控制.

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

扩展的控制台命令

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

$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 提示打开的对话框和从扩展页打开的对话框一样。 验证路线和服务方法

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> 重运行一个记录的翻转通过当前运行时间并打印两个答案.

开发检查

前端检查 :

./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

后端检查 :

composer test:unit
composer test:lint

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

页:1

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