# Lattice：AI代理工作流的运维平台，实现跨会话协调与自动化 > 一个自托管的MCP服务器，为AI代理提供跨会话的持久化协调、任务管理、事件总线和可观测性，支持35个工具，零代码改动即可集成到Claude Code、Cursor等客户端。 - 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm) - 发布时间: 2026-04-09T23:41:36.000Z - 最近活动: 2026-04-09T23:45:21.051Z - 热度: 167.9 - 关键词: AI agent, MCP, workflow, coordination, persistence, automation, observability, Claude Code, Cursor, self-hosted, SQLite, PostgreSQL - 页面链接: https://www.zingnex.cn/forum/thread/lattice-ai - Canonical: https://www.zingnex.cn/forum/thread/lattice-ai - Markdown 来源: ingested_event --- # Lattice：AI代理工作流的运维平台，实现跨会话协调与自动化\n\n## 项目概述\n\n在AI代理（AI Agent）生态快速发展的今天，一个核心问题始终困扰着开发者和用户：代理在单次会话中表现出色，但会话结束后一切记忆和状态都随之消失。如何让AI代理具备真正的"持久记忆"和"协调能力"？\n\nLattice项目正是为解决这一问题而生。它是一个自托管的MCP（Model Context Protocol）服务器，专为AI代理工作流提供运维基础设施——包括自动化、持久化协调和可观测性。最重要的是，它实现了"零代理代码改动"的集成体验。\n\n## 核心定位：代理做不到的事情，Lattice来做\n\nLattice的核心理念可以用一句话概括："大多数AI工具定义了代理如何运行，而Lattice定义了代理如何协调。"\n\n当前市面上的AI工具主要关注单个代理在单次会话内的表现，而Lattice关注的是代理之间、会话之间的协调问题。它填补了AI代理生态中的一个关键空白：运维层面的基础设施。\n\n## 解决的五大核心问题\n\nLattice针对AI代理在实际应用中遇到的五大痛点提供了系统性的解决方案：\n\n### 1. 代理跨会话遗忘\n\n传统AI代理在会话结束后会丢失所有上下文。Lattice通过共享知识库解决这个问题，支持全文搜索（FTS5 trigram搜索）和标签系统，让代理能够在不同会话间保持记忆连续性。\n\n### 2. 无法分配工作任务\n\n多代理协作时，如何分配任务是个难题。Lattice提供了任务协调机制，支持"先声明再工作"（claim-before-work）模式、DAG（有向无环图）依赖关系管理，以及优先级设置（P0-P3）。\n\n### 3. 代理间无法通信\n\nLattice内置事件总线和直接消息系统，支持广播（broadcast）和交接（handoff）两种通信模式，让多个代理能够像团队协作一样相互沟通。\n\n### 4. 重复的手动编排\n\n通过"Playbook"（剧本）功能，Lattice允许用户定义可重用的任务模板，只需一个命令即可运行复杂的自动化流程，无需每次都手动编排。\n\n### 5. 缺乏可观测性\n\nLattice提供审计日志、分析统计和实时仪表板，让用户能够清楚地了解代理做了什么、什么时候做的、结果如何。\n\n## 技术架构与核心特性\n\nLattice采用TypeScript和Hono框架构建，技术栈简洁而现代：\n\n### MCP原生设计\n\nLattice最大的差异化优势在于其MCP原生架构。任何支持MCP协议的客户端——Claude Code、Cursor、或者自定义代理——都可以零代码改动地接入Lattice。这意味着用户不需要修改现有的代理代码，只需在配置文件中添加Lattice服务器即可。\n\n### 框架无关\n\n与LangChain、CrewAI等特定框架不同，Lattice不绑定任何代理框架。这种设计让它能够与各种工具链共存，而不是强迫用户选择特定的技术栈。\n\n### 自托管与可扩展\n\nLattice默认使用SQLite（支持WAL模式），当需要扩展时可以无缝切换到PostgreSQL。整个系统没有外部依赖，单个二进制文件即可运行，非常适合自托管场景。\n\n### 35个工具，一个服务器\n\nLattice在一个进程中集成了35个MCP工具，涵盖知识管理、任务协调、消息传递、定时任务、Webhook等多个领域。这种集成度让用户无需部署多个服务即可获得完整功能。\n\n## 核心功能详解\n\n### 知识管理（Knowledge）\n\n- **save_context**：持久化保存到共享知识库，自动进行全文索引和标签管理\n- **get_context**：支持全文搜索和标签过滤的知识检索\n- **save_artifact**：存储类型化文件（HTML、JSON、代码、Markdown），最大支持1MB\n- **get_artifact/list_artifacts**：工件检索和列表\n\n### 任务协调（Tasks）\n\n- **create_task**：创建带有DAG依赖、优先级（P0-P3）和分配的工作项\n- **update_task**：乐观锁机制的状态转换\n- **list_tasks/get_task**：任务过滤和详情查询\n- **get_task_graph**：DAG可视化（节点+边）\n\n### 事件与消息（Events & Messaging）\n\n- **broadcast**：推送事件（支持LEARNING、BROADCAST、ERROR、ESCALATION、TASK_UPDATE等类型）\n- **get_updates**：基于游标的事件轮询\n- **wait_for_event**：长轮询等待匹配事件（最长60秒）\n- **send_message/get_messages**：代理间直接消息传递\n\n### 自动化（Automation）\n\n- **define_playbook**：可重用的任务模板，支持依赖关系配置\n- **run_playbook**：实例化剧本，支持{{vars.KEY}}变量替换\n- **define_schedule/list_schedules/delete_schedule**：基于Cron的剧本执行调度\n- **list_workflow_runs/get_workflow_run**：剧本执行跟踪\n\n### 代理管理（Agent Management）\n\n- **register_agent**：代理注册，支持能力声明\n- **list_agents**：按能力或状态查找代理\n- **heartbeat**：维护在线状态\n\n### 可观测性（Observability）\n\n- **get_analytics**：时间窗口聚合的团队统计\n- **export_workspace_data**：完整的团队快照（敏感信息已脱敏）\n\n## 分层工具暴露策略\n\nLattice提供了精细的工具分层策略，让用户可以根据需求逐步启用功能：\n\n| 层级 | 工具数 | 功能 | 与内置工具重叠？ |\n|------|--------|------|------------------|\n| automation | 11 | Playbook、定时任务、Webhook、工作流执行 | 否 |\n| persist | 10 | 任务（DAG）、共享上下文（FTS5）、工件 | 表面重叠（会话vs持久化） |\n| coordinate | 8 | 事件总线、代理消息、代理注册 | 表面重叠（会话vs持久化） |\n| observe | 6 | 分析、配置、数据导出 | 否 |\n\n这种设计让用户可以从零重叠的automation层开始，在需要时逐步添加其他层级，避免决策疲劳。\n\n## 部署与使用\n\nLattice的部署非常简单，支持Docker和源码两种方式：\n\n```bash\n# Docker方式（推荐）\ngit clone https://github.com/pswai/lattice.git && cd lattice\nADMIN_KEY=your-secret docker compose up -d --build\n\n# 或从源码运行\nnpm install && npm run build\nADMIN_KEY=your-secret node dist/index.js\n```\n\n配置完成后，在.mcp.json中添加Lattice服务器：\n\n```json\n{\n \"mcpServers\": {\n \"lattice\": {\n \"type\": \"http\",\n \"url\": \"http://localhost:3000/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer YOUR_API_KEY\",\n \"X-Agent-ID\": \"my-agent\"\n }\n }\n }\n}\n```\n\n代理即可立即开始使用协调功能：\n\n```\nsave_context(key: \"project-goals\", value: \"Building a REST API for...\", tags: [\"planning\"])\ncreate_task(description: \"Implement user endpoints\", priority: \"P1\")\nbroadcast(event_type: \"LEARNING\", message: \"Found that we need JWT auth\")\n```\n\n## 与现有方案的对比\n\n| 特性 | Lattice | Claude Code内置 | CrewAI/LangGraph | Mem0/Zep |\n|------|---------|-----------------|------------------|----------|\n| 定位 | 协调基础设施 | 会话本地工具 | 代理框架 | 记忆平台 |\n| 持久化 | 跨会话 | 仅会话内 | 框架管理 | 云/自托管 |\n| 知识搜索 | FTS5 + 标签 | 平级MEMORY.md | 无 | 向量/图搜索 |\n| 任务协调 | DAG依赖、先声明后工作 | 会话本地列表 | 基于角色 | 无 |\n| 自动化 | Playbook、Cron、Webhook | 无 | 工作流定义 | 无 |\n| 兼容性 | 任何MCP客户端 | 仅Claude Code | 仅自有SDK | SDK集成 |\n| 自托管 | 单二进制、SQLite | N/A | 各异 | 各异 |\n\n## 适用场景\n\nLattice适用于从个人开发者到企业团队的多种场景：\n\n- **个人开发者**：跨会话的持久化上下文，使用Playbook实现自动化管道\n- **小团队**：共享的代理大脑，通过Webhook实现GitHub到代理的自动化\n- **企业**：合规审计跟踪，多团队发布协调（带DAG依赖）\n\n## 安全与运维特性\n\nLattice内置了企业级的安全和运维特性：\n\n- API密钥认证，支持读/写/管理三种权限范围\n- 每个密钥的速率限制\n- 敏感信息扫描，阻止凭证进入共享状态\n- SSRF防护，保护出站Webhook\n- 可配置保留期的审计日志\n- Prometheus指标端点\n\n## 结语\n\nLattice代表了AI代理基础设施演进的一个重要方向：从关注单个代理的能力，转向关注代理之间的协调与运维。\n\n在AI代理从"玩具"走向"生产工具"的过程中，像Lattice这样的协调平台将扮演越来越重要的角色。它不仅解决了代理跨会话遗忘的痛点，更为多代理协作、自动化编排和可观测性提供了完整的基础设施。\n\n对于正在构建AI代理应用的开发者和团队来说，Lattice提供了一个值得认真考虑的选择——特别是对于那些希望保持技术栈灵活性、需要自托管方案、或者已经在使用MCP兼容工具的用户。