AI 自动化经营 · LightAIP · frontend-intro-v5

1. 页面概览

「AI 自动化经营」是 AIP 管理后台的对话式自动化配置中心（源码 action/web/src/views/AutomationConsole.vue），对标 Palantir AIP Agent Studio + Automate。页面左侧为资产/状态面板（自动化工作流卡片 + 立即运行、自动化活动摘要、执行历史 tool_call/tool_result 卡片序列），右侧为 Automation Copilot 对话面板（公共组件 CopilotChat.vue，SSE 流式渲染、会话管理与 AI 可用能力清单）。用户用自然语言描述经营自动化需求（如「每天 8 点检查库存，低于阈值自动补货并通知我」），AI 通过工具调用自动完成自动化工作流的创建、启停、查询并执行。

一句话总结：对话即配置，AI 把自然语言自动化为可运行的自动化工作流并立即执行。

2. 访问入口

路由与菜单：/admin/automation，路由名 AutomationConsole；位于 AIP 管理后台左侧边栏「AI 自动化经营」。
认证与权限：/admin 父路由 requiresAdmin，须管理员登录；SSE 请求显式带 aip_token Bearer，未登录时前端静默提示不发起请求。
端口与 API 前缀：AIP 18080，aipClient baseURL /aip-api/v1；SSE 直连 /aip-api/v1/automation/chat（fetch + ReadableStream，因 EventSource 无法携带 Authorization 头）。

3. 界面布局

┌ 左 30% 资产面板                 ┌ 右 70%: Automation Copilot ┐
│ 自动化工作流: 卡片列表 [刷新][新建]│ 头部: AI 自动化经营 + [新建会话]│
│   卡片: 名称/状态/触发器/工作流#   │       历史会话下拉 + [设置]     │
│   描述/ [立即运行][编辑][启停][删除]│ AI 可用能力（N 项）折叠面板      │
│ 自动化活动: 最近6条工具调用摘要    │ 消息列表（流式 markdown + 工具  │
│ 执行历史: tool_call/result 卡片   │   调用卡片）                    │
│   （右上角「设置」可开关）         │ 输入区: textarea + [发送]      │
└──────────────────────────────────└──────────────────────────────┘

各板块职责：自动化工作流展示 AI 已创建的自动化并可一键运行；自动化活动是最近 6 条工具调用摘要；执行历史为当前会话完整工具调用/结果序列；右侧 Copilot 承担对话、工具调用与会话管理。

4. 交互元素

控件	位置	含义与作用
「立即运行」	自动化卡片	对卡片对应工作流同步执行（复用 `POST /workflows/:id/run`，超时 120 秒）
「新建」	自动化工作流标题	打开表单弹窗新建自动化（`POST /automation/automations`，创建即发布，需管理员）
「编辑」	自动化卡片	拉详情回填表单（`GET /automation/automations/:id`）后保存（`PUT`，仅草稿可改；已发布需先停用）
「启用」/「停用」	自动化卡片	启用=发布（`POST .../enable`）、停用=取消发布（`POST .../disable`），按当前状态二选一展示
「删除」	自动化卡片	二次确认后删除（`DELETE /automation/automations/:id`，后端先取消发布再删，不可恢复）
能力说明条	自动化工作流标题下方	说明支持表单式新建 / 编辑 / 启用 / 停用 / 删除（REST `/automation/automations`，写操作需管理员），也可继续用右侧 Copilot 对话由 AI 完成；并提示已发布需先停用才能编辑（2026-09-14 更新）
「刷新」	自动化工作流标题	重拉自动化列表（对话结束 turn-complete 后也会自动刷新）
「新建会话」	Copilot 头部	清空当前对话，开始新会话
历史会话下拉	Copilot 头部	切换历史会话（`GET /automation/sessions`），加载消息与工具卡片
「设置」	Copilot 头部	「展示工具调用及结果」（localStorage `copilot_show_tools`，联动左侧执行历史）、发送方式 Enter / Ctrl+Enter（`copilot_send_mode`）
输入框 + 「发送」	对话底部	描述自动化需求，按发送方式设置以 Enter 或 Ctrl+Enter 发送
示例引导 chips	空对话区	一键填入示例需求（库存检查补货 / 订单已付款补货 / 每周一经营周报）

5. 后端关联

端点（AIP 18080）：

方法	路径	用途
POST	`/automation/chat`	AI 对话 SSE 流式（token / tool_call / tool_result / done 事件），body `{message, session_id?}`
GET	`/automation/sessions`	会话列表（分页，按更新时间倒序）
GET	`/automation/sessions/:id`	会话详情（含消息历史，解析 tool_calls_json 为工具卡片）
GET	`/automation/tools`	工具定义清单（AI 可用能力）
GET	`/automation/automations`	自动化工作流列表（兼容 `{items}`/`{automations}`/直接数组）
GET	`/automation/automations/:id`	自动化详情（definition/trigger_config 已解析为对象，编辑表单回填）
POST	`/automation/automations`	表单式新建（创建即发布），需管理员
PUT	`/automation/automations/:id`	编辑（仅草稿可改），需管理员
DELETE	`/automation/automations/:id`	删除（先取消发布再删），需管理员
POST	`/automation/automations/:id/enable`	启用（发布），需管理员
POST	`/automation/automations/:id/disable`	停用（取消发布），需管理员
POST	`/workflows/:id/run`	立即运行，body `{params:{}}`

关键机制

表单式 CRUD 已接入（2026-09-14）：automation.Handler.RegisterRoutes(protected, admin) 在读/对话（protected 组）之外，把自动化写操作挂 admin 管理组（对齐 /workflows 定义写操作策略）：POST /automation/automations、PUT|DELETE /automation/automations/:id、POST /automation/automations/:id/enable|disable，GET /automation/automations/:id 供编辑表单回填。写端点复用 AI 工具层服务实现（tools.go 的 createAutomationFromParams / setAutomationEnabled / removeAutomation），与 create_automation / enable_automation 等工具同一套校验与状态流转语义；编辑走 workflow.Service.Update（仅草稿可改、version 自增、name 不可改）。列表端点响应形状保持 {code,items} 不变。
已发布需先停用再编辑：工作流引擎仅允许 draft 状态修改/删除，因此卡片上的「编辑/删除」对已发布自动化需先点「停用」；编辑弹窗对已发布项显式提示并禁用保存按钮。
SSE 事件流：chat 端点按行解析 event:/data: 帧，事件类型 token（追加流式文本）、tool_call（推入调用卡片）、tool_result（关联到同名最近调用并标注成功/失败）、done（结束并刷新会话）；非流式返回时走 JSON 兜底解析。
工具目录约 16 项：create_automation / list_automations / get_automation / enable_automation / disable_automation / run_automation_now、query_objects / execute_action / list_change_events，以及跨产品 get_api_usage_/call_ 工具（Foundry / Apollo / Gotham / AIP）。
一轮对话结束（done 或非流式兜底）后前端刷新会话列表与自动化列表；左侧执行历史由 CopilotChat 以 tool-activities 事件拉平上报。

6. 权限与安全

路由级：/admin 父路由 requiresAdmin，非管理员被守卫重定向。
接口级：automation 的对话与读端点挂 protected 登录组，均需 JWT；自动化写端点（POST/PUT/DELETE /automation/automations[/:id] 与 /enable、/disable）挂 admin 管理组，非管理员返回 403。SSE 请求显式带 Authorization: Bearer <aip_token>。
展示安全：AI 回复先 marked 渲染再经 DOMPurify 清洗后注入；未登录（无 aip_token）时不发起请求，避免 401 重定向到登录页打断其它产品会话。

7. 常见问题与排错

现象：对话发送后无响应或提示「[未登录]」。原因：localStorage 无 aip_token。处理：先登录 AIP 平台再使用；确认当前登录态有效。
现象：左侧「自动化工作流」为空且提示后端可能未就绪。原因：GET /automation/automations 失败或返回空。处理：确认 AIP 18080 服务在运行、已登录管理员；点「刷新」重试。
现象：流式文本不出现、只有工具卡片。原因：SSE 帧解析失败或后端返回非流式 JSON。处理：在浏览器 Network 确认 automation/chat 返回 text/event-stream；若为 JSON 则走非流式兜底，属兼容路径。
现象：左侧「执行历史」空白。原因：右上角「设置」中「展示工具调用及结果」被关闭（copilot_show_tools 为 0）。处理：打开设置勾选该选项，左侧与对话内卡片即恢复。

8. 已知缺陷与边界

项目	说明
未登录行为	仅提示不请求，不自动跳转登录（避免在 Swift 等独立登录产品页被拦截器重定向）
表单式新建/编辑已补齐（2026-09-14 关闭）	后端已提供 `GET\|POST\|PUT\|DELETE /automation/automations[/:id]` 与 `POST /automation/automations/:id/enable\|disable`（写操作挂 admin 组），前端左侧面板已接入「新建」弹窗与卡片上的「编辑/启用/停用/删除」，原「后端无 CRUD 端点」常驻边界说明条已移除（改为能力说明）
编辑节点编排用 JSON 文本	节点 DAG（nodes/edges）以 JSON 文本域编辑而非可视化编排器，属已知体验边界；标准模板场景留空即可自动生成
静默置空	会话/工具接口失败时静默置空，无显式报错；AI 可用能力清单依赖 `/automation/tools` 返回
执行历史范围	仅覆盖当前会话内消息（切换会话后清空），非全局执行记录