我们一直认为，企业级智能体最缺的不是「更聪明的模型」，而是「更可靠的编排」。今天，我们把生产环境验证过的编排框架开源，把状态管理、工具注册与多轮纠错沉淀为标准 SDK。
一、为什么要自己做框架
通用框架上手快，但进入生产后往往面临三个问题：一是状态不透明，Agent 执行到哪一步、为什么失败，难以追踪；二是工具权限难控，所有 Agent 共享一套工具权限，安全边界模糊；三是评测困难，缺少统一的执行日志，无法沉淀评测集。
我们的目标是：让「跑一个智能体」像「调一个函数」一样可预期。因此框架内置了确定性优先的三大件：状态机、工具注册表、执行日志。
二、核心概念
状态机（State Machine）。每个 Agent 会话被建模为有限状态机：PENDING → RUNNING → WAITING_TOOL → COMPLETED / FAILED。超时与重试策略在状态层统一处理，避免逻辑散落在业务代码里。
工具注册表（Tool Registry）。工具通过装饰器注册，附带描述、参数校验与权限标记。框架在每次调用前做白名单校验，并自动记录入参出参，便于审计与复现。
执行日志（Execution Log）。每一步都产出结构化日志：模型调用、工具调用、token 消耗、耗时。这些日志可以直接灌入评测集，用于版本回归。
三、一段示例
下面是最小可用的定义方式：注册一个「查询天气」工具，然后创建一个使用它的 Agent。框架会负责对话循环、工具解析与错误重试，开发者只写业务逻辑。
四、开源计划
框架将在 GitHub 开源，包含完整文档、示例与评测工具。我们欢迎社区把它接入更多场景，也欢迎提出新的状态机模式与工具编排方式。开源不是终点，而是把工程纪律交还给社区的起点。
如果你在评估企业智能体架构，或者想了解框架与现有系统的集成方式，欢迎联系我们，我们很乐意聊聊。