AuC：面向开发者的AI智能体编程框架完全指南，10分钟看懂asyncio单智能体ReAct核心-北京尧图网络

【免费下载链接】AuCAgents-ufy-Core项目地址https://gitcode.com/gh_mirrors/auc/AuC点击查看免费下载AuCAgents-ufy-Core是一个基于 asyncio 的 PythonAI智能体编程框架用可插拔的ReAct 循环推理—行动驱动大模型自主调用工具内置 L1/L2/L3 工具权限分级与 AI 二次授权机制。本文面向新手带你 10 分钟看懂它的 asyncio 单智能体核心并完成安装上手。什么是 AuC单智能体核心框架定位 AuC 是 ufy 智能体体系中的「执行面核心」只做一件事保证一个 Agent 能完成一轮可终止的「推理—行动」循环。它不内置多智能体编排、RAG 或向量检索而是通过清晰的端口Port接口把记忆、上下文切片、审批网关交给外部组件扩展。这种「最小核心端口隔离」的设计让它既能独立运行自带 CLI/Web 双端也能与 AuM 元框架协同。核心设计原则详见 docs/design-philosophy.md架构总览见 docs/architecture.md。为什么选 AuC核心特性一览能力说明ReAct 循环流式推理、并行工具调用、上下文压缩、检查点回滚多模型适配OpenAI Chat Completions、Anthropic Messages、DeepSeek 兼容网关工具权限分级L1 只读 / L2 沙盒写 / L3 二次授权危险命令自动升级双端交互终端 REPL斜杠命令、Plan/自治模式 Web UISSE 流式对话IM 审批Telegram / QQ 高危操作二次授权卡片可观测事件流EventBus 结构化事件便于日志、调试与流式展示项目要求 Python ≥ 3.11MIT 许可PyPI 包名为ufy-auc依赖声明见 pyproject.toml。快速上手AuC 安装与配置三步走第 1 步安装框架pip install ufy-auc # 仅核心 pip install ufy-auc[chat] # 终端对话日常推荐 pip install ufy-auc[web] # 网页 UI也可以从源码安装git clone https://gitcode.com/gh_mirrors/auc/AuC cd AuC pip install -e .[chat]第 2 步配置大模型auc config init # 生成 ~/.Au/AuC/settings.json export DEEPSEEK_API_KEYsk-... # 或 OPENAI_API_KEY / ANTHROPIC_API_KEY auc config show配置格式为 JSONClaude Code 风格支持 OpenAI / Anthropic / DeepSeek 多端点以及auto智能路由按成本/质量/延迟策略选型详见 docs/model-config.md。第 3 步发起对话auc chat 你好 # 单轮提问 auc chat # 进入交互 REPL/help /plan /autonomy auc web --sandbox ./my-project # 启动 Web UI10分钟看懂 asyncio 单智能体 ReAct 核心ReAct 循环三步闭环ReAct Reason推理 Act行动。AuC 的默认循环 ReActLoop 每一步只做三件事组合上下文→ 把系统提示、记忆召回、当前消息窗口拼成messages调用模型→ 流式请求 LLM拿到最终文本或tool_calls执行工具 / 收尾→ 有工具调用则并行执行并把结果写回消息窗口没有工具调用且有文本输出则本轮doneTrueRun 结束。AgentLoopRunnerasyncio 驱动的主循环真正驱动循环的是 AgentLoopRunner它是一个纯粹的 async 状态机while True: if ctx.cancelled: return result(statuscancelled) last await loop.step(ctx) # 一步推理—行动—观察 if not loop.should_continue(ctx, last): break终止条件清晰可枚举模型给出最终答案completed、达到max_steps默认 20 步、用户调用agent.cancel(run_id)cancelled、L3 审批被拒或超时denied、等待批复中pending_approval。完整的状态机描述见 docs/loops.md。asyncio 并行工具调用快在哪当模型一次性发出多个tool_calls时ReActLoop 默认用asyncio.gather并发执行所有工具parallel_tool_callsTrue单个工具失败只返回is_errorTrue的ToolResult反馈给模型不会中断其余调用。相比串行执行多工具场景下延迟接近于最慢的单个工具这正是 asyncio 非阻塞模型的红利。一次完整 Run 长什么样以「北京现在天气如何」为例最小示例见 docs/examples/minimal-react.md步骤消息窗口演变初始化userStep 0 后user→assistant(tool_calls: get_weather) →tool(晴 25°C)Step 1 后… →assistant(北京当前晴25°C) ✅全程事件流run_start→step_start→model_delta→tool_start/tool_end→run_end通过 EventBus 发出Web/CLI 的流式界面就是消费这条事件流渲染的。端到端可运行示例见 examples/minimal_run.py循环行为测试见 tests/test_react_loop.py。工具权限分级给 AI 的 L1/L2/L3「门禁」AuC 吸收 Claude Code 的工程纪律在工具与循环之间插入 ToolPrivilegeGate 门控级别名称典型操作默认策略L1Read-Only读文件、git status自动放行L2Write-Isolated沙盒内写代码、跑测试自动放行沙盒路径策略L3High-Riskgit push、外部 API、越权操作挂起 Run 人工批准L3 的「挂起—审批—恢复」状态机是亮点Run 不会丢弃上下文而是冻结在内存中经 Telegram / QQ / Web / CLI 任一审批端口等待人工批复批准后从原地恢复执行。这就是所谓「2FA for AI」。危险 shell 命令还会由 EscalationRules 自动从 L2 升级到 L3。详见 docs/tool-privilege.md。不止于核心周边能力速览 Web 双界面Code Chat 双模式、工作区浏览、沙盒内运行 HTML/Node/Python 项目源码位于 auc/web/server.py256 个内置角色agency 角色库按领域分类工程、市场、安全等智能 auto 路由见 auc/roles/agency_loader.py技能库数百个 SKILL.md 技能按来源分组见 auc/skill_library/sources.py检查点回滚写文件/删路径/执行命令前自动快照auc undo --list一键回滚见 auc/checkpoint.py上下文压缩两级压缩旧工具输出折叠模型摘要早期回合防止 Token 爆炸见 auc/context/compactor.py进化记忆.auc/evolution.yaml经验召回与金块固化见 auc/integration/evolution.py源码导览目录结构速查auc/ ├── agent.py # DefaultAgent 入口run / run_stream / cancel ├── loop/ # 可插拔循环react.pyReAct base.pyRunner ├── model/ # OpenAI / Anthropic / DeepSeek 客户端与路由 ├── tools/ # 文件、Shell、搜索、URL 抓取等沙盒工具 ├── policy/ # 权限门控、自治策略、危险命令升级 ├── context/ # 消息窗口与两级上下文压缩 ├── ports/ # 记忆 / 军规 / 审批 / 上下文包端口 ├── integration/ # Telegram、QQ 审批网关与进化记忆 └── web/ # FastAPI SSE 网页 UI总结AuC 用不到千行核心代码回答了「AI 智能体如何安全地一步步干活」asyncio 主循环驱动 ReAct 推理—行动闭环并行工具调用提速L1/L2/L3 权限门禁守住安全底线EventBus 让一切过程可观测。无论你是想给现有产品嵌入一个可控的编码智能体还是研究 Agent 框架设计AuC 都是一个麻雀虽小、五脏俱全的参考实现。下一步建议运行auc chat体验终端对话 → 阅读 docs/architecture.md 总览架构 → 在 examples/minimal_run.py 基础上定制自己的工具。赞分享【免费下载链接】AuCAgents-ufy-Core项目地址https://gitcode.com/gh_mirrors/auc/AuC点击查看免费下载相关推荐OpenManus开源AI智能体框架的全面解析OpenManus开源AI智能体框架的全面解析 OpenManus是一个开源AI智能体框架致力于为开发者和研究者提供强大、灵活且易于使用的智能体构建平台。本CANNBot 全景解析10 分钟看懂昇腾 AI 算子开发智能体团队如何重塑 CANN 开发效率CANNBot 全景解析10 分钟看懂昇腾 AI 算子开发智能体团队如何重塑 CANN 开发效率 CANNBot 是 CANN 社区的 Infra 智能体层人工智能AI AgentAI 技能代码智能体工作流自动化CANN模型优化Semantic Kernel微软开源AI智能体编排框架全面解析Semantic Kernel微软开源AI智能体编排框架全面解析 Semantic Kernel是微软开源的企业级AI智能体编排框架旨在帮助开发者快速集成大人工智能大模型AI AgentAgent 框架多智能体RAG创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

AuC：面向开发者的AI智能体编程框架完全指南，10分钟看懂asyncio单智能体ReAct核心

相关推荐

C#开发海康SDK：从C++手册到P/Invoke封装的避坑实战

Rockchip嵌入式调试实战：串口、工具链与内核追踪全解析

在VS Code与Keil MDK中统一clang-format格式化C/C++代码的TaoToken实践

更多资讯

分光计调节原理：各调一半法的光学-机械耦合解析

QEMU源码编译实战：可控构建、安全加固与性能调优

ShopNC B2B2C 33hao好商城V4：多商户商城架构、部署与二次开发实战

08cms房产门户多城市版：从部署到模板改造与SEO优化实战

策略模式实战：电商订单折扣引擎设计与落地

2026程序员薪资行情：网络安全成最高溢价赛道

今日更新

防关联浏览器哪个好？三款产品实测差异解析

2026钢铁行业AI转型系统选型对比：多基地排产、大宗原燃料采购与质量追溯，六家厂商能力差异在哪里

影刀RPA深度实战：大模型Fine-tuning定制RPA专用Prompt与指令生成

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？