statelyai/agent

解决的问题

通过将控制流逻辑从 LLM 移出到确定性状态机中，防止 AI 代理执行无效操作。这确保了代理保持可预测、可检查和可恢复，同时 LLM 仅限于从当前状态定义的合法事件集合中选择。

工作原理

Stately Agent 将模型请求和决策集成到 XState 中。状态机定义合法的转换和守卫；LLM 提出一个事件，机器决定该事件是否被允许。该系统将机器逻辑与执行环境（主机）分离，意味着相同的代理机器可以在本地使用脚本执行器进行测试，或在生产环境中使用 Vercel AI SDK 等提供者运行，而无需更改机器的定义。

适用人群

需要对代理行为进行严格控制、实现确定性工作流，并能轻松测试、可视化和持久化代理状态的 AI 代理开发者。

特色

• 确定性控制流：状态机拥有逻辑，使无效操作成为不可能。
• 模型无关：机器从不直接与模型通信，允许开发者轻松更换 LLM 提供者或执行器。
• 内置模式：包含常见代理架构（如 ReAct、反思、计划-执行、RAG）的可运行示例。
• 原生 XState 集成：利用 XState 的快照、版本控制和代理状态迁移功能。