🧅 ConnectOnion

一个简洁、优雅且支持生产环境的开源 AI Agent 框架

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

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

🎯 践行我们的哲学

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

from connectonion import Agent

agent = Agent(name="assistant")
agent.input("Hello!")  # 这样就完成了！

第 2 步：添加你的工具

def search(query: str) -> str:
    """搜索信息。"""
    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 的聊天界面，该 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

可复用的工作流，具备自动权限范围控制：

# 示例代码预留

openonion/connectonion