LightAgent 是一个超轻量、开源的 Python 智能体框架，号称小体积、大潜力。它用于构建兼容 OpenAI 的智能体，内置工具、记忆、护栏、追踪、生命周期钩子、多智能体协作与工作流等功能。框架原生支持 Skills，可将可复用能力与持久记忆、工具调用和思维树推理组合起来。它无需 LangChain 与 LlamaIndex，核心保持小巧、模块化、完全开源，并通过针对性依赖完成模型提供商、MCP、记忆与追踪集成。
主要能力：
- 轻量高效：极简设计，快速部署，适合多种应用场景。
- 记忆支持：支持为每个用户自定义长期记忆，原生支持 mem0 记忆模块，在对话中自动管理用户个性化记忆。
- 自主学习：每个智能体具备自主学习能力，有权限的管理员可管理各智能体。
- 工具集成：支持自定义工具与 MCP 工具集成，可灵活扩展。
- 复杂目标：内置带反思的思维树（ToT）模块，支持复杂任务分解与多步推理。
- 多智能体协作：比 Swarm 更易实现多智能体协作，内置 LightSwarm 进行意图识别与任务委派。
- 工作流编排：LightFlow 将智能体串联为具有显式依赖的确定性多步工作流，支持步骤输出传递、重试、检查点运行记录、恢复/重跑、审批节点、回退智能体和可追踪执行。
- 共享记忆原型：SharedMemoryPool 提供追加优先的内存共享记忆，带有来源元数据、作用域检索，并兼容 MemoryPolicy 结果，用于多智能体实验。
- 独立执行：任务与工具调用可自主完成，无需人工干预。
- 多模型支持：兼容 OpenAI、OpenRouter、智谱 ChatGLM、百川、阶跃星辰、DeepSeek、Qwen、vLLM、llama.cpp 等 OpenAI 兼容端点。
- 流式 API：支持 OpenAI 流式格式 API 服务输出，可与主流聊天框架无缝集成。
- 追踪观测：可选的 trace=True 运行追踪记录结构化运行生命周期、模型请求摘要、工具调用、工具结果和错误，且不改变默认字符串返回值。
- 评估工具：LightEvaluator 可运行确定性的智能体或 LightFlow 回归用例，覆盖输出、工具选择、策略事件、恢复、延迟、用量与估算成本。
- 人工审核：HumanApprovalHook、持久审核存储和 LightFlow 审批检查点支持批准、拒绝、参数编辑、人工响应、批量操作与追踪反馈，用于高影响操作。
- 运行时钩子：有序的 hooks=[...] 中间件可观察、替换或阻止运行、模型、工具、记忆与 LightFlow 步骤阶段，并在追踪事件中记录钩子决策。
- 事件溯源运行时：可选的持久 Sessions、重放、检查点、分叉、异步入口、作用域 Capability Providers、统一 Policy、Inbox、Goals、Budgets、Jobs、子智能体、上下文压缩和 SQLite FTS5 检索。
- 动态验证 DAG：可选的 LightDAG 持久化运行时图变更，并发执行独立 Worker，在制品发布前要求应用自有验证，并通过租约与 fencing 安全恢复。
- 护栏模板：可复用的输入/工具/输出护栏模板，帮助阻止隐私数据、要求敏感工具确认、校验高风险参数并脱敏输出。
- 工具生成器：提供 API 文档给工具生成器即可自动创建专属工具。
- 智能体自学习：每个智能体拥有自己的场景记忆能力，并能从用户对话中自学习。
- 自适应工具机制：支持添加无限数量工具，让大模型先从成千上万工具中选择候选工具集，在提交上下文前过滤无关工具，显著降低 token 消耗。
- 智能体协作通信：智能体之间可共享信息与传递消息，实现复杂信息通信与任务协作。
使用方式：安装最新版 LightAgent；可选通过 pip 安装 Mem0 包，或在托管平台使用 Mem0。默认调用路径保持简单，可增量添加生产控制。支持自定义工具、运行时工具、ToolRegistry、ToolLoader、AsyncToolDispatcher 与 MCP 工具集成。
安全默认值：自 v0.10.1 起，任意 Python 执行工具默认不注册；模型与调度器调用中会阻止旧版 execute_python_code、execute_python_file 和 execute_python_code_stream，即使 enable_unsafe_python=True 或注册了 SandboxProvider。受信任的应用代码可在自身隔离控制下直接调用它们。智能体代码执行应使用自定义沙箱支持的工具。
适用场景：需要快速搭建可扩展智能体应用的开发者，包括多智能体协作、确定性多步工作流、工具调用与记忆管理、MCP 集成、流式聊天接口对接，以及需要追踪、评估、人工审核与安全护栏的生产场景。
限制：具体收费、价格、平台支持细节暂未提供。v1.0 稳定性提案、支持的 Python 版本、公开导入与兼容性承诺见公开 API 与兼容性清单。
