架构总览
RTC Agent 的架构由三部分组成：浏览器 / 前端（虚拟文件系统 + Web Component）、RTC Agent Server（Agent 引擎 + 上下文管理 + 实时通信）、LLM Provider（AI 推理）。
Function 注册表：开发者通过
agentConfig或defineRegistry注册的 Function 元数据（名称、参数 Schema、描述），以 Markdown 文件形式存储在虚拟文件系统的/functions/目录中。Agent 引擎通过读取这些文件了解可用的业务能力。详见 Skill 系统。
核心设计原则
Section titled “核心设计原则”| 原则 | 实现方式 | 用户价值 |
|---|---|---|
| 🔐 隐私优先 | 文件操作在前端执行，数据存于 IndexedDB | 敏感数据不上传服务器 |
| 🧩 文件系统即接口 | AI 通过 ls/read/write/grep 操作业务 | 开发者只需维护 Function 文档 |
| ⚡ 实时同步 | Centrifuge 双频道推送 | 用户全程可见 AI 的每一步 |
| ♻️ 弹性恢复 | Redis Checkpoint + 100% 送达保证 | 断网、重启无感知 |
为什么选择”文件系统即接口”？ LLM 天然理解文件操作（
ls、cat、grep），无需学习自定义 API。开发者只需为每个 Function 写一份 Markdown 文档，Agent 就能自动发现并组合调用——相比传统 RPC 注册方式，集成成本更低，可观测性更高。
请求处理流程
Section titled “请求处理流程”| 层 | 技术 | 用途 |
|---|---|---|
| 后端 | Go 1.27 | 主服务语言 |
| 数据库 | PostgreSQL + GORM | 持久化存储 |
| 缓存 | Redis | Checkpoint、流式缓冲、Pub/Sub |
| 实时通信 | Centrifuge WebSocket | 双向推送 |
| AI 框架 | Anthropic SDK + Eino | Agent 引擎 |
| 前端 | Lit Web Components | 组件化 UI |
| 可观测 | OpenTelemetry + Jaeger + Prometheus | 追踪 + 指标 |
- 前端架构 — Web Components 组件体系、状态管理、窗口系统
- 后端架构 — Go 服务分层、Agent 引擎、上下文管理
- Remote Tool Calling — 了解核心协议的工作机制
- 协议总览 — 了解通信协议的完整定义