介绍

chatCore 是一个无框架约束的智能体开发核心库，目前支持以下后端智能体框架：

• LangGraph - 使用 LangGraph 开发的智能体
• AgentOS v3.0 - AgentOS v3.0 版本的后端智能体

前端组件支持

智能体工具 UI 及常用组件已封装为 Vue 3 组件库，便于快速集成和使用。

未来规划：

• 兼容 Nuxt.js 和 Next.js 等主流框架
• 这些框架在近两年的智能体前端开发生态中表现优异，拥有丰富的社区插件资源
• 可满足不同场景下的多样化需求

能力按需使用

使用场景说明

SCP 插件使用场景：

• 适用于智能体在聊天过程中不需要返回 form-page 格式工具输出结果的场景

chatCore 核心能力：

• 除上述特殊场景外，可直接使用 chatCore（@pt/chat-core）的核心能力
• 完全满足智能体的聊天交互需求

功能特性

✅ 已实现功能

1. 工具调用 - 支持内置工具和第三方工具的调用
2. 普通问答 - 基础对话交互能力
3. 基于知识库问答 - 支持知识库检索和问答能力

🚧 开发中功能

以下功能正在开发或规划中：

1. 中断机制（Human in the Loop） - 智能体执行中断控制（Pause, approve, edit, retry, or escalate mid flow without losing state.）
2. 生成式 UI - 动态生成用户界面
3. 数据共享 - 智能体与 UI 层的数据共享机制
   • 通过 STATE_DELTA 事件使用 JSON Patch 传输增量更新
   • 相比完整快照更节省带宽，只发送实际改变的部分
4. 预测状态更新 - 智能预测和状态管理
5. 子图支持 - 复杂智能体子图功能

追踪与监控

架构概览

你的应用 + OpenTelemetry SDK
    ↓
OpenTelemetry Collector（可选）
    ↓
后端存储 + 可视化工具（SigNoz）

推荐方案：SigNoz

为什么选择 SigNoz？

• 开箱即用 - 集成了存储、查询、可视化 UI 于一体
• 现代化界面 - 类似 Datadog/Honeycomb 的用户体验
• 完整的可观测性 - 支持 Traces、Metrics、Logs 三位一体
• 原生支持 OpenTelemetry - 无缝集成，无需额外配置
• 部署简单 - Docker Compose 一键部署

技术架构

应用 + OpenTelemetry SDK
    ↓
SigNoz Collector
    ↓
ClickHouse (数据存储) + SigNoz UI (可视化界面)

优势与劣势

✅ 优势：

• 单一解决方案，维护成本低
• UI 友好直观，学习曲线平缓
• 社区活跃，文档完善
• 支持告警和自定义仪表板
• 资源占用合理，性能优异

⚠️ 注意事项：

• 相对年轻的项目，生态成熟度不如 Jaeger
• 企业级特性仍在持续完善中