ConnectOnion

ConnectOnion 是一个功能强大且简洁的 Python AI 代理框架，其构建理念是“让简单的事情保持简单，让复杂的事情成为可能”。它通过大幅减少样板代码，使开发人员能够在几分钟内而不是几天内交付功能齐全的 AI 代理。其核心概念非常直接：通过将 Markdown 提示与作为工具的 Python 函数相结合来创建 AI 代理。这种方法仅用 8 行代码就能创建一个带有计算器工具的智能助手，而在其他流行框架（如 LangChain）中，同样的功能可能需要大约 50 行代码。

如何使用ConnectOnion

ConnectOnion 的入门过程设计得非常快速和直观。
1. 安装： 首先通过 pip 安装框架：pip install connectonion。
2. 创建项目： 使用内置的 CLI 工具通过 co create my-agent 快速搭建一个新项目。该命令会自动设置项目结构，包括一个示例代理文件、用于存放 API 密钥的环境文件以及为 AI 助手准备的完整框架文档。
3. 定义组件： 在您的 Python 脚本中，定义一个提示（例如，“你是一个乐于助人的助手”）以及将用作代理工具的 Python 函数（例如，一个 `calculate` 函数）。
4. 创建代理： 使用 agent = Agent(prompt, tools=[your_function]) 来实例化代理。
5. 进行交互： 通过调用 .input() 方法来使用代理，例如 result = agent.input("42 * 17 等于多少？")。
为了实现更高效的工作流，ConnectOnion 提倡“Vibe Coding”方法，您可以将整个文档粘贴到像 Cursor 这样的 AI 编程助手中，描述您需要的代理，然后让 AI 生成完整的代码。

ConnectOnion的核心功能

• 极简语法： 将代码复杂度降低高达 85%，只需几行代码即可创建代理。
• Markdown + 函数 = 代理： 一种直观的模型，其中提示用 Markdown 编写，工具是标准的 Python 函数。
• 强大的 CLI： 一个命令行界面（co），用于快速搭建项目、管理环境，并内置了最佳实践。
• Vibe Coding： 一种快速开发方法，通过向 Cursor 等 AI 助手提供框架文档，让其编写完美的 ConnectOnion 代码。
• 内置调试功能： @xray 装饰器提供实时洞察、迭代跟踪和性能指标，让您清楚地看到代理正在做什么。
• 自动日志记录： 代理的每一次交互都会被自动记录，便于监控和审查。
• 有状态工具： 支持简单的无状态函数和复杂的、有状态的基于类的工具（例如，用于 Web 自动化的 `Browser` 类）。
• 自动模式生成： 自动将 Python 类型提示转换为与 OpenAI 兼容的函数模式，无需手动编写。

ConnectOnion的使用案例

ConnectOnion 用途广泛，可用于构建各种 AI 代理，包括：
简单任务代理： 创建用于特定任务的代理，如基本示例中所示的数学计算。
网络爬虫与研究员： 构建能够从 URL 抓取内容、提取链接并从网络收集信息的代理。CLI 包含一个 `web-research` 模板。
自动化机器人： 使用 Playwright 模板开发用于 Web 自动化的代理，该模板包含用于启动浏览器、导航页面、填写表单和截屏的预构建工具。
邮件助手： 生成能够根据特定触发器或条件发送电子邮件通知的代理。
自定义 AI 生成代理： 使用 CLI 的 AI 驱动的自定义模板功能，描述所需的代理（例如，“一个监控 GitHub 仓库新问题的代理”），CLI 将生成完整的项目。

ConnectOnion的优势特点

ConnectOnion 的主要优势在于其极致的简洁性和速度。通过抽象掉复杂性并消除样板代码，它使开发人员能够专注于其代理的核心逻辑。这大大加快了开发周期。该框架既对初学者友好（零设置复杂度），又足够强大，可用于生产就绪的应用程序。其创新的“Vibe Coding”方法利用了现代 AI 助手的力量，进一步加速了开发。内置的调试和日志记录工具为代理行为提供了专业级的可见性和控制。

定价和计划

根据提供的文档，ConnectOnion 是一个免费的开源 Python 库。它通过 `pip` 安装，文档中没有提及任何定价、计划或商业许可。用户可以立即开始构建，无需支付与框架本身相关的任何费用。

常见问题（FAQ）

ConnectOnion 是什么？

ConnectOnion 是一个用于构建 AI 代理的极简 Python 框架。其核心理念是简化开发过程，通过将 Markdown 提示与作为工具的 Python 函数相结合，以最少的样板代码创建功能强大的代理。

ConnectOnion 是免费的吗？

是的，文档表明 ConnectOnion 是一个免费的开源库。它可以直接通过 Python 包索引 (PyPI) 使用 `pip install connectonion` 进行安装，并且没有提到任何费用或付费计划。

与其他框架相比，ConnectOnion 如何减少代码量？

ConnectOnion 抽象了其他框架所需的复杂设置。它能从类型提示中自动处理模式生成，并提供一个简单的 `Agent` 类。这使得仅用 8 行代码就能创建一个功能性代理，而类似功能在 LangChain 等框架中可能需要大约 50 行代码，样板代码减少了 85%。

什么是“Vibe Coding”？

“Vibe Coding”是 ConnectOnion 提倡的一种开发工作流程。它包括将完整的框架文档提供给 AI 编程助手（如 Cursor）。然后，开发人员用自然语言描述所需的代理，AI 助手就会生成完整、正确的 ConnectOnion 代码，从而实现极快的原型设计和开发。

如何调试用 ConnectOnion 构建的代理？

ConnectOnion 包含一个名为 `@xray` 的内置调试工具。通过将此装饰器应用于您的工具函数（例如 `@xray def my_tool(...)`），您可以获得关于代理执行的详细实时洞察，包括正在调用哪个工具、用户的原始任务以及当前的迭代次数。

代理可以使用什么样的工具？

代理可以使用任何 Python 函数作为工具。ConnectOnion 还支持有状态的工具，允许您将整个类实例传递给代理。当提供类实例时，ConnectOnion 会自动发现其所有带有类型提示的公共方法，并使它们作为代理的工具可用，这对于像 Web 浏览器自动化这样的复杂任务非常理想。