GitHub - salahmakboul/call4agents:防止 AI 智能体在崩溃后重复执行操作:已批准的工具调用最多执行一次。Python 库,无依赖。支持 LangGraph、Pydantic AI、OpenAI Agents SDK、MCP 和原生 Python。

📌 One-Sentence Summary
Call4Agents 是一个 Python 库,可确保已批准的工具调用只执行一次,防止 AI 智能体在崩溃后重复执行操作,并支持 LangGraph、Pydantic AI、OpenAI Agents SDK、MCP 和原生 Python。
📝 Summary
Call4Agents 是一个 Python 库,旨在确保已批准的工具调用只执行一次,让 AI 智能体的操作即使在崩溃、超时或恢复运行后也能安全重试。该库会在本地 SQLite 数据库中记录意图和结果,防止支付、发送邮件或写入数据库等操作重复执行。它提供用于定义仅执行一次操作的装饰器、将审批决定绑定到确切函数参数的审批机制、用于撤销操作的功能,以及适用于外部 API 的幂等键。该工具支持 LangGraph、Pydantic AI、OpenAI Agents SDK 和 MCP 等多种 AI 智能体框架,并为每种框架提供适配器。它针对 Linux、macOS 和 Windows 上的 Python 3.10-3.13 进行了全面测试,还提供用于测试、审计和管理智能体运行的 CLI 命令。
💡 Main Points
防止在崩溃、超时或恢复运行后重复执行操作
该库会在 SQLite 数据库中记录意图和结果,确保支付或发送邮件等操作只执行一次。如果发生崩溃,系统可以安全恢复,而不会重复执行已批准的操作。
提供将审批决定绑定到确切函数参数的机制
对 pay(10, alice) 的批准不能用于执行 pay(9999, mallory)。每项批准都是限定于特定运行的 HMAC,可防止从批准到执行期间篡改参数。
通过专用适配器支持多种 AI 智能体框架
Call4Agents 为 LangGraph、Pydantic AI、OpenAI Agents SDK 和 MCP 提供适配器,让开发者只需少量修改代码,就能将仅执行一次的机制集成到现有智能体架构中。
提供在崩溃后撤销操作的功能
开发者可以为每项操作注册撤销函数;c4a.undo() 会按运行时间从新到旧的顺序撤销操作,且每项撤销也只会执行一次。这样即使系统发生故障,也能安全回滚操作。
提供全面的 CLI 工具,用于测试、审计和管理智能体运行
crashtest、incident、quickstart、audit 和 diff 等命令可帮助开发者在崩溃条件下测试智能体、验证完整性、比较运行结果,并导出带签名的审计记录。
💬 Key Quotes
Call4Agents 让 Python 智能体的操作可以安全重试。你可以将它添加到现有智能体中:LangGraph、Pydantic AI、OpenAI Agents SDK、MCP 服务器,或原生 Python。它不会取代其中任何一个。
发生崩溃、重试或恢复运行时,不会重复发送同一封邮件或进行同一笔支付。
对 pay(10, alice) 的「同意」不能用于执行 pay(9999, mallory)。一次「同意」只适用于一项操作,之后的「拒绝」也会得到执行。
整个工具包的状态都保存在一个本地 SQLite 文件中,我们称之为运行记录。记录只会追加,绝不会修改或删除。
每项批准只能用于一次操作。之后的拒绝会使其失效。
📊 Article Meta
AI Screening: 88
Source: Hacker News - Newest: "AI Agent"
Author: iuogh71
Category: 人工智能
Language: 英文
Read Time: 17 min
Word Count: 4133
Tags:
AI 与智能应用 , AI 安全与对齐 , AI 工程 , AI Agent , 编程语言
楼主辛苦了,内容很有参考价值。
看标题就点进来了,内容果然没让人失望。
这个观点很中肯,深有同感。
支持作者,持续关注中。
实话,说的不明不白
实测过类似工具,作者说的基本属实。
内容翔实,正好需要,先收藏再看。
收藏了,以后慢慢研究。
内容翔实,正好需要,先收藏再看。
很有价值的分享,感谢整理。
内容翔实,正好需要,先收藏再看。
思路清晰,干货满满。