🧅 ConnectOnion

一个简洁、优雅且适用于生产环境的开源 AI Agent 框架

📚 文档 • 💬 Discord • ⭐ 给我们点赞

---

🌟 设计哲学：“让简单的事情保持简单，让复杂的事情成为可能”

这是驱动 ConnectOnion 每一个设计决策的核心准则。

🎯 践行我们的哲学

第 1 步：简单 —— 创建并使用

from connectonion import Agent

agent = Agent(name="assistant")
agent.input("Hello!")  # 就这么简单！

第 2 步：添加你的工具

def search(query: str) -> str:
    """Search for information."""
    return f"Results for {query}"

agent = Agent(name="assistant", tools=[search])
agent.input("Search for Python tutorials")

第 3 步：调试你的 Agent

agent = Agent(name="assistant", tools=[search])
agent.auto_debug()  # 交互式调试会话

第 4 步：生产环境就绪

agent = Agent(
    name="production",
    model="gpt-5",                    # 使用最新模型
    tools=[search, analyze, execute], # 将函数作为工具使用
    system_prompt=company_prompt,     # 自定义行为
    max_iterations=10,                # 安全控制
    trust="prompt"                    # 支持多 Agent 协作
)
agent.input("Complex production task")

第 5 步：多 Agent —— 支持远程调用

from connectonion import host
host(agent)  # HTTP 服务 + P2P 中继 - 其他 Agent 现在可以发现并调用该 Agent

✨ 为什么选择 ConnectOnion？

大多数框架只提供调用 LLM 的方式，而 ConnectOnion 为你提供了一切周边支持——你只需编写 Prompt 和工具。

内置 AI 编程助手

co ai   # 打开与 AI 的聊天界面，它深度理解 ConnectOnion

co ai 是一个使用 ConnectOnion 构建的 AI 编码助手。因为它对框架了如指掌，所以能编写出可运行的 Agent 代码。它是完全开源的——你可以查看、修改并构建属于你自己的助手。

内置前后端 —— 只需编写 Prompt 和工具

传统开发路径：编写 Agent 逻辑 → 构建 FastAPI 后端 → 构建 React 前端 → 连接 API → 部署。

ConnectOnion 开发路径：编写 Prompt 和工具 → 部署。

• 后端：框架自动处理 API 层
• 前端：chat.openonion.ai —— 开箱即用的聊天界面
• 全部开源且可定制，无需从零开始

开箱即用的工具生态系统

导入即可使用——无需编写 Schema，无需连接接口：

from connectonion import bash, Shell                                    # 命令执行
from connectonion.useful_tools import FileTools                         # 文件系统（带有安全追踪）
from connectonion.useful_tools.browser_tools import BrowserAutomation   # 自然语言浏览器自动化

from connectonion import Gmail, Outlook              # 电子邮件
from connectonion import GoogleCalendar              # 日历
from connectonion import Memory                      # 持久化记忆
from connectonion import TodoList                    # 任务追踪

需要自定义？将源码复制到你的项目中：

co copy Gmail     # 将 Gmail 工具的源代码复制到你的项目中以便修改

内置批准系统

危险操作（如 bash 命令、文件删除）会自动触发批准流程——无需你自己编写权限逻辑。

from connectonion.useful_plugins import tool_approval, shell_approval

agent = Agent("assistant", tools=[bash], plugins=[shell_approval])
# Shell 命令现在在执行前需要获得批准

基于插件架构：你可以关闭它、自定义它，或者完全替换它。

技能系统 —— 自动发现，兼容 Claude Code

可复用的工作流，带有自动化的权限范围限定：

# 示例代码