OxyGent 文档

OxyGent 是一个开源的 Python 多智能体系统框架。它将 LLM、智能体（Agent）、工具（Tool）和流程（Flow）统一为模块化组件，通过名称引用组装在一起，帮助你快速构建、运行和迭代基于智能体的应用。

---

为什么选择 OxyGent？

• 内置智能体循环 — 自动处理工具调用、响应解析和多轮推理
• Python 原生 — 以 Python 对象定义智能体、工具和流程，无需 DSL 或配置文件
• 10+ 智能体类型 — ChatAgent、ReActAgent、WorkflowAgent、ParallelAgent、PlanAndSolveAgent、RAGAgent 等
• MCP 协议支持 — 连接任意 MCP 工具服务器（Stdio、SSE、Streamable），同时支持原生 Python 工具
• 多智能体编排 — 层级调度、并行执行、混合智能体、分布式系统
• A2A 互操作 — 内置 Agent-to-Agent 协议，支持跨框架通信（LangChain、LangGraph、AgentScope）
• Web UI + API — FastAPI 服务器 + SSE 流式传输 + 内置聊天界面 + 可视化调试
• 生产级工具 — 链路追踪、对话历史、动态提示词管理、SFT 训练数据生成

---

Hello World

import asyncio, os
from oxygent import MAS, oxy

oxy_space = [
    oxy.HttpLLM(
        name="default_llm",
        api_key=os.getenv("DEFAULT_LLM_API_KEY"),
        base_url=os.getenv("DEFAULT_LLM_BASE_URL"),
        model_name=os.getenv("DEFAULT_LLM_MODEL_NAME"),
    ),
    oxy.ChatAgent(
        name="assistant",
        is_master=True,
        llm_model="default_llm",
    ),
]

async def main():
    async with MAS(oxy_space=oxy_space) as mas:
        result = await mas.chat_with_agent(payload={"query": "你好！"})
        print(result.output)

if __name__ == "__main__":
    asyncio.run(main())

---

选择你的路径

你的目标	从这里开始
5 分钟构建第一个智能体	快速上手
了解核心概念与术语	概念总览
了解架构和类层次结构	架构总览
给智能体添加工具（Python 函数）	注册本地工具
使用 MCP 协议工具	MCP 开源工具
构建多智能体系统	多智能体系统
并行运行智能体	并行调用
部署为 Web 服务	Web API
跨进程连接智能体	分布式系统
与 LangChain / LangGraph 互操作	A2A 协议
生成 SFT 训练数据	训练数据

---

文档分区

分区	说明
教程	从安装到高级功能的逐步指南
API 参考	详细的类与方法文档
示例	87 个可运行的示例脚本，按功能分类
FAQ	常见问题解答