Ingot Chat

Ingot Chat 是工程师使用 Ingot 的主要入口：它帮助人们查询已保存的生产数据、检查数据质量并定位周期数据问题。Ingot 是制造数据采集与工艺分析平台；Chat 是平台中的对话和调查工作台。它以只读方式访问生产记录并保留现场设备状态。

能力

• 理解自然语言问题以及当前资产或周期当前页面信息；
• 生成受控的结构化查询计划；
• 调用 check_data_quality 检查事件完整性、生产信息缺失、事件新鲜度和可用范围；
• 调用 get_cycle_trace 按 correlationId 返回排序后的周期事件链；
• 流式展示计划、只读工具活动、回答、注意事项和相关记录；
• 保存当前用户 可见的对话历史，并支持取消和 SSE 续读。

当前可用工具为 check_data_quality 与 get_cycle_trace。

综合分析：有界多 Agent 协作

日常问题使用 standard 模式。对于需要多角度审查的复杂问题，可以显式启用 deep 综合分析模式。

• 工艺角色审查周期、状态变化和参数差异；
• 质量角色审查检测结果、样本范围和质量关联；
• 复核角色主动寻找数据缺口、混杂因素和替代解释；
• 三个角色只读取本次已验证的工具结果，不能自行访问数据库、网络或设备；
• 默认最多 3 轮、9 次发言，硬上限为 5 轮、15 次；第一轮至少两名角色成功，才会给出可能原因；
• 输出包含支持和不支持该判断的数据和注意事项，只能称为可能原因，不能确认根因或因果关系。

这不是无约束群聊。它是一个有固定角色、轮次、可查看的数据范围和终止条件的只读调查流程；工程师始终负责最终判断。

执行流程

用户问题与当前页面信息
  → 意图和时间范围解析
  → 权限、工具与数据范围校验
  → 只读数据工具
  → 数字、单位和结果与原始记录核对
  → 回答、注意事项与数据引用

模型负责理解问题和组织语言；确定性代码负责数据查询、权限、范围限制、工具执行和结果与原始记录核对。Chat 使用受控数据工具，不生成 SQL、Flux 或脚本。

生产启用

生产 Compose 默认关闭 Chat。启用时同时配置模型、模型密钥和平台用户数据范围：

export INGOT_CHAT_ENABLED=true
export INGOT_CHAT_PROVIDER=OpenAI
export INGOT_CHAT_FAST_MODEL="<fast-model>"
export INGOT_CHAT_REASONING_MODEL="<reasoning-model>"
export OPENAI_API_KEY="<secret>"
export INGOT_CHAT_OPERATOR_ALLOW_ALL=true
export INGOT_CHAT_ENABLE_COMBINED_ANALYSIS=true

开发环境由服务端使用本地平台身份 operator。生产部署必须接入统一认证，并按每个平台用户所需的数据范围配置访问权限。

使用

1. 打开 Platform Web，进入 Chat。
2. 输入问题，例如“这个周期发生了什么，数据是否完整？”
3. 可选择资产或周期并填写当前页面信息。
4. 查看只读工具活动、结论、注意事项和相关记录。
5. 从相关记录返回生产事件或周期数据。

HTTP API

curl -X POST http://localhost:8000/api/v1/chat/runs \
  -H "Content-Type: application/json" \
  -d '{
    "question": "这个周期发生了什么，数据是否完整？",
    "pageContext": { "kind": "cycle", "id": "CYCLE-001" },
    "mode": "combined"
  }'

开发环境由服务端使用本地 operator 身份。生产环境必须由平台统一认证中间件建立用户主体；Chat API 不接受客户端自报用户或 Chat 专用密码。

安全边界

• 只读工具白名单仅包含已注册的生产记录查询工具；
• 生产环境只信任平台认证主体，不接受 X-Ingot-User 或 Chat 专用 Bearer 密码；
• 工具继承当前用户 的数据范围；
• 禁止任意 SQL、脚本、Shell、文件系统和开放网络访问；
• 工具结果中的指令性文本按普通记录处理，不能改变系统策略；
• 回答数字必须来自工具结果，关键结论必须包含可解析相关记录；
• 数据不足、范围冲突或质量不合格时明确给出限制，不生成确定性结论；
• Chat 不修改配置、事件、检测记录或设备状态。

配置见配置说明，记录契约见生产事件规范。