OxyGent 示例文档

May 15, 2026 · View on GitHub

本目录包含所有 OxyGent 示例脚本的文档,按功能领域分类组织。每个子目录涵盖框架的一个特定方面,所有示例均为可直接运行的独立脚本。


推荐入门

如果你是 OxyGent 新用户,建议先从以下三个示例开始:

示例你将学到
单智能体最简 ChatAgent,自定义提示词与钩子
ReAct 智能体带反思机制的 ReActAgent 与工具调用
层级多智能体主从 Agent 架构与任务分发

分类目录

分类示例数说明
Agent 示例14Agent 类型、协作模式与回调钩子
高级功能9高级功能:RAG、SFT 数据生成、技能召回、评测
后端服务14Web 服务模式、SSE 流式、异步聊天、批处理
A2A 协议20Agent-to-Agent 协议:服务端、客户端、流式、多智能体
工具4工具类型:FunctionTool、HttpTool 与工具检索
LLM4LLM 集成:HttpLLM、OpenAILLM、LocalLLM、MockLLM
流程编排2流程编排:Reflexion 与 MathReflexion
Bank 工具4BankTool / BankClient:基于 HTTP 的远程工具服务
MCP 工具3MCP 协议工具集成(Stdio、SSE、Streamable)
分布式3基于 SSEOxyGent 的分布式多智能体系统
电商场景5电商领域:商品搜索、订单追踪、客服
动态提示词2热加载提示词管理与动态 Agent 更新
FH 工具集1FunctionHub 工具集合
应用示例1完整应用示例
其他1其他示例

快速开始

  1. 安装 OxyGent 及其依赖(参见主 README)。
  2. .env 文件中设置所需的环境变量:
    DEFAULT_LLM_API_KEY=your_api_key
    DEFAULT_LLM_BASE_URL=your_base_url
    DEFAULT_LLM_MODEL_NAME=your_model_name
    
  3. 直接运行任意示例:
    python -m examples.agents.demo_single_agent