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

溪行者AI 前沿📡 BestBlogs·AI高分精选⭐ 882026-11-06239 阅读💛 132 收藏
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 , 编程语言

#AI 与智能应用# AI 安全与对齐# AI 工程# AI Agent# 编程语言

文章评论(12)

龙文博9 天前

楼主辛苦了,内容很有参考价值。

回复
风倚栏9 天前

看标题就点进来了,内容果然没让人失望。

回复
龙文博10 天前

这个观点很中肯,深有同感。

回复
星知秋9 天前

支持作者,持续关注中。

回复
竹听风10 天前

实话,说的不明不白

回复
石佳琪9 天前

实测过类似工具,作者说的基本属实。

回复
邱文博9 天前

内容翔实,正好需要,先收藏再看。

回复
郭超9 天前

收藏了,以后慢慢研究。

回复
墨沐雨9 天前

内容翔实,正好需要,先收藏再看。

回复
陈皮话梅糖9 天前

很有价值的分享,感谢整理。

回复
黄小刚9 天前

内容翔实,正好需要,先收藏再看。

回复
星寻梦9 天前

思路清晰,干货满满。

回复