Freeact：轻量级代码 Agent 框架

通用的 AI agent，通过统一的执行接口以代码动作的形式行动。

Freeact 是一个轻量级的通用 agent，在 ipybox 提供的有状态执行环境中通过代码动作进行操作。一个统一的执行接口允许代码动作包含 Python 代码、shell 命令和程序化 MCP 工具调用的任意组合，这些都在一次 LLM 推理过程中生成。

对于程序化 MCP 工具调用（"代码模式"），freeact 根据 MCP 服务器架构生成类型化的 Python API。agent 在执行前检查生成的 API，并根据可用的类型信息在代码动作中组合它们。成功的代码动作可以保存为可重用工具，将 agent 的经验捕获为可执行知识，可选择与 agent 技能结合。

Freeact 通过 agentic 和语义搜索支持工具发现，只将与任务相关的工具信息加载到上下文窗口。它可以对代码动作、shell 命令和程序化工具调用（来自主 agent 和子 agent）强制执行应用级别的批准。Freeact 在本地计算机上运行，可作为 CLI 工具和 Python SDK 使用。

支持的模型：Freeact 支持任何与 Pydantic AI 兼容的模型。参见配置模型以获取提供商配置和示例。

1）Freeact 也支持通过 JSON 工具调用进行 MCP 服务器集成，但推荐的方法是程序化工具调用。