✨ 通用智能代理框架 · NexAU v0.4.0 发布

构建下一代智能代理
从今天开始

NexAU 是一个模块化的 AI Agent 框架,提供灵活的工具系统、多 LLM 提供商支持、
子代理协作架构和可观测性追踪,让你轻松构建生产级智能代理应用。

+20
内置工具:文件操作、搜索、Shell、Web 等
多 LLM
支持 OpenAI、Anthropic、兼容 API 等
可观测
Langfuse 追踪,全面监控执行过程
⚡ 快速
Python 3.12+,高性能异步架构

🎯 核心功能

NexAU 提供一系列开箱即用的强大功能

🔧

模块化工具系统

工具的定义与实现解耦,支持 YAML 定义工具,支持 Claude Skills, 内置文件操作、Web 搜索、Shell 执行等 20+ 工具。

🧠

多 LLM 提供商

原生支持 OpenAI / Anthropic / Azure,兼容所有 OpenAI Chat Completions API 的提供商, 事件流式处理。

🏗️

主从代理架构

支持主代理 + 子代理协作模式,代理之间可以互相调用、传递上下文, 适用于复杂任务分解。

📊

可观测性追踪

集成 Langfuse 追踪,实时监控 prompt、工具调用、子代理进展, 支持 Pydantic model 输出解析。

🔄

灵活的运输层

支持 HTTP (FastAPI)、WebSocket、gRPC、Stdio 等多种传输协议, 轻松集成到任意后端系统。

🔌

MCP 集成

支持 Model Context Protocol,可与外部工具无缝集成, 支持技能系统(Skills),兼容 Claude Skills 格式。

🚀 快速开始

5 分钟创建一个智能代码代理

1. 安装 NexAU

使用 pip (推荐) 或 uv 安装框架:

pip install nexau

或从 GitHub Release 安装最新版本:

pip install git+https://github.com/nex-agi/NexAU.git@v0.4.0

2. 配置 LLM

创建 .env 文件,配置你的 LLM 提供商:

LLM_MODEL="gpt-4o" LLM_BASE_URL="https://api.openai.com/v1" LLM_API_KEY="sk-..."

3. 创建 Agent 配置

使用 YAML 定义你的代理配置:

# code_agent.yaml name: code_agent max_context_tokens: 100000 system_prompt: "你是一个专业开发者助手。" llm_config: model: "{{ LLM_MODEL }}" base_url: "{{ LLM_BASE_URL }}" api_key: "{{ LLM_API_KEY }}" api_type: "openai_chat_completion"

4. 运行代理

使用 CLI 一键启动:

./run-agent code_agent.yaml

或使用 Python API 创建并在代码中调用:

from nexau import Agent, AgentConfig agent = Agent(config=AgentConfig( name="my_agent", max_context_tokens=100000, system_prompt="你是代码代理", llm_config=LLMConfig( model="gpt-4o", base_url="https://api.openai.com/v1", api_key="sk-...", ), )) print(agent.run("帮我写一个 Python 脚本"))

🏗️ 架构概览

模块化设计,易于扩展和维护

NexAU 核心架构

📝 Prompts (System Prompt) 🧠 LLM (多提供商) 🔧 Tools (模块化工具)
📦 Executor (执行器) 🔄 Middlewares (中间件) 🔎 Tracer (追踪器) 📡 Transport (传输层)

🧩 工具系统

1

YAML 定义

工具接口通过 YAML 定义,清晰简洁

2

绑定实现

同一工具可以有多个实现绑定

3

自动集成

工具自动注入到 Agent 上下文

🧠 LLM 聚合器

1

多提供商

原生支持 OpenAI / Anthropic / Azure

2

流式处理

支持 SSE 事件流,实时处理响应

3

结构化输出

支持 Pydantic model 输出解析

💡 使用场景

NexAU 适用于多种智能代理应用场景

💻

代码生成代理

推荐使用 code_agent 示例,支持全栈开发辅助, 内置文件操作、搜索、代码生成等功能。

🔍

深度研究代理

使用 deep_research 示例,支持多级搜索、 信息验证和完整的文档生成。

🤖

多代理协作

使用 nexau_building_team 示例, 多个专家代理协作完成复杂任务。

🔗

MCP 工具集成

使用 mcp 示例,集成外部 MCP 服务, 扩展代理能力。

🎭

通用 AI 助手

自定义 Agent 配置,构建任何类型的智能应用, 从客服到数据分析。

🛠️

API 服务代理

通过 HTTP Transport 将 Agent 部署为 API 服务, 使用 FastAPI 轻松发布。

查看更多示例代码 →

⚙️ 环境变量配置

完整的环境变量参考

变量名 类型 说明
LLM_MODEL string LLM 模型名称,如 "gpt-4o"
LLM_BASE_URL string LLM API 基础 URL
LLM_API_KEY string LLM API 密钥 (⚠️ 敏感信息,不要提交到 Git)
LANGFUSE_SECRET_KEY string Langfuse 追踪密钥 (可选)
LANGFUSE_PUBLIC_KEY string Langfuse 公钥 (可选)
LANGFUSE_HOST string Langfuse 服务器地址 (可选)
SERPER_API_KEY string Serper.dev API 密钥 (Web 搜索需要)
💡 提示: LLM_API_KEY 是敏感密钥,请通过环境变量或密钥管理服务传入,不要硬编码到代码中。

🚀 准备好构建你的智能代理了吗?

查看完整文档,了解如何快速构建和运行 AI Agent 应用

Star on GitHub 📝 报告 Issues