Youtu-Agent
面向开源模型的可配置智能体构建、评测与持续优化框架。
- Star 数
- ★ 4.6k
- 最近更新
- 今天
- License
- NOASSERTION
- 主语言
- Python
- FA 评分
- 27/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要用 DeepSeek 等 OpenAI 兼容模型快速搭建带网页搜索能力命令行助手的应用开发者。
- 不适合
- 不愿申请 Serper、Jina 等第三方搜索密钥的用户
- 需要稳定追踪分析功能的用户，DBTracingProcessor 尚未发布
这个 Agent 能做什么，适合哪些场景？
Youtu-Agent 是一个用于构建、运行和评测自主智能体的 Python 框架，基于 openai-agents SDK 构建。它以 YAML 定义智能体、模型和工具集，并提供交互式 CLI、示例程序和评测脚本。框架支持 OpenAI 兼容的 responses 与 chat.completions 接口，README 示例使用 DeepSeek API，也提到 gpt-oss 等模型。其自动生成流程可根据需求生成工具代码、提示词和配置；Agent Practice 与 Agent RL 模块则面向经验学习和端到端强化学习。项目可从源码部署，另提供 Docker 部署说明和可选的本地 Web UI 前端包。
开发者可通过 configs/agents 中的 YAML 组合模型与工具，例如 simple/base_search 配置引入 /tools/[email protected]。python scripts/cli_chat.py --config simple/base_search 会启动带搜索工具的交互式聊天；运行前需在 .env 中配置 SERPER_API_KEY、JINA_API_KEY 及兼容 OpenAI 格式的 LLM 凭据。python scripts/gen_simple_agent.py 会通过内置 meta-agent 澄清需求并生成配置，生成后可由 python scripts/cli_chat.py --config generated/xxx 执行。评测流程可先用 python scripts/data/process_web_walker_qa.py 下载并处理 WebWalkerQA 数据，再以 python scripts/run_eval.py --config_name ww --exp_id <your_exp_id> --dataset WebWalkerQA_15 --concurrency 5 运行；结果保存后可在评测分析平台进一步查看。示例还覆盖 CSV 分析并生成 HTML 报告、文件重命名与分类、检索增强生成、文献分析、SVG 可视化和 PPT 生成。
- 需要用 DeepSeek 等 OpenAI 兼容模型快速搭建带网页搜索能力命令行助手的应用开发者。
- 希望将智能体提示词、模型和工具组合纳入 YAML 配置管理的工程团队。
- 要在 WebWalkerQA 上处理数据、并发运行实验并分析结果的智能体研究人员。
- 需要根据自然语言需求自动生成工具代码与智能体配置的原型开发者。
- 需要让智能体读取 CSV、产出 HTML 报告的数据分析使用者。
- 需要构建 RAG、论文分析、资料检索或 PPT 生成工作流的开发者。
如何安装或部署这个 Agent？
运行环境要求 Python 3.12+，项目推荐使用 uv。执行：
git clone https://github.com/TencentCloudADP/youtu-agent.git
cd youtu-agent
uv sync
source ./.venv/bin/activate
cp .env.example .env随后在 .env 配置 OpenAI 格式兼容的模型服务，例如 UTU_LLM_TYPE=chat.completions、UTU_LLM_MODEL=deepseek-chat、UTU_LLM_BASE_URL=https://api.deepseek.com/v1 和 UTU_LLM_API_KEY=<your-api-key>。
如何使用这个 Agent？
最小本地对话可运行：
python scripts/cli_chat.py --config simple/base如需使用 simple/base_search 的网页搜索工具，还必须在 .env 设置 SERPER_API_KEY 和 JINA_API_KEY，然后运行：
python scripts/cli_chat.py --config simple/base_search若要自动生成配置，先运行 python scripts/gen_simple_agent.py，再按生成目录运行 python scripts/cli_chat.py --config generated/xxx。SVG 示例可运行 python examples/svg_generator/main.py；安装发布的 utu_agent_ui wheel 后，可运行 python examples/svg_generator/main_web.py，并访问终端显示的本地地址。
这个 Agent 有哪些优点和局限？
- 基于 openai-agents SDK，并明确支持 responses 和 chat.completions 两种 OpenAI 兼容接口。
- YAML 配置、内置工具集与 cli_chat.py 提供了从配置到交互执行的清晰路径。
- gen_simple_agent.py 提供需求澄清、工具代码与配置自动生成流程，而不仅是手写工具接入。
- 内置 WebWalkerQA 数据处理与 run_eval.py 评测流程，结果还能进入分析平台。
- README 展示了数据分析、文件管理、研究、RAG、SVG 与 PPT 等可运行方向。
- 源码部署要求 Python 3.12+；推荐的依赖同步流程依赖 uv。
- 网页搜索示例需要额外申请并配置 SERPER_API_KEY 与 JINA_API_KEY。
- 模型调用依赖 API 密钥及 OpenAI 格式兼容的服务；示例中的 DeepSeek 服务也需要网络访问。
- WebWalkerQA 评测还需要单独配置 JUDGE_LLM_TYPE、JUDGE_LLM_MODEL、JUDGE_LLM_BASE_URL 和 JUDGE_LLM_API_KEY。
- README 将 DBTracingProcessor 标注为“will be released soon”，因此不能据此假定该追踪分析能力已可用。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Youtu-Agent 当前 | 27 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 4.6k | 今天 | Python | OpenAI API |
| PraisonAI | 42 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 9.3k | 1 天前 | Python | Codex · Claude Code · OpenAI API · Claude API |
| HUD | 63 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 323 | 今天 | Python | OpenAI API · Claude API |
| IR-SIM 智能机器人模拟器 | 43 · 缺口较多 | 代码库 / SDK免费 | ★ 1.2k | 5 天前 | Python | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示仓库未提供权限最小化、用户确认、数据流透明、敏感数据处理、依赖安全、外部影响、回滚或来源归属的具体实现或文档。README 提到需要 API 密钥，但未说明权限控制或数据保护措施。因此所有信任标准得分为 0。
自一致性：README 和 pyproject.toml 中项目名称和描述一致，但存在版本不一致（README 提到 Python 3.12+，pyproject 要求 >=3.10），且 README 中 'Contribut' 截断，显示文档不完整。依赖可用性：pyproject 列出了依赖，但未提供锁定文件或版本范围验证，且存在从 GitHub 直接安装的依赖（swe-rex），可能不稳定。失败消息：未提供错误处理或用户提示的文档。
受众和场景：README 明确列出了研究人员、开发者和爱好者等受众，并提供了多种用例。能力边界：未明确说明框架的限制或适用边界。触发精度：提供了 CLI 和配置示例，但未详细说明触发条件。环境适配：提供了 Docker 和源码部署说明，但未说明不同操作系统的兼容性。
信息架构：README 结构清晰，有目录和文档链接。安装说明：提供了源码和 Docker 安装步骤，但未提供详细的故障排除。命名稳定性：项目名称在 README 和 pyproject 中一致，但存在 'uTu-agent' 和 'youtu-agent' 的混用。示例和 FAQ：提供了多个示例和 FAQ 链接，但未在仓库内提供 FAQ 内容。已知限制：未提及。许可证：提供了 MIT 许可证文件。版本和变更日志：pyproject 有版本号，但未提供变更日志。维护责任：作者信息在 pyproject 中，但未明确维护政策。
输出可用性：提供了 CLI 和 Web UI 示例，但未说明输出格式或质量保证。边际价值：提供了自动生成工具和 RL 训练等独特功能，具有边际价值。成本效益：README 提到低成本部署，但未提供具体成本分析。
声明可追溯性：README 中的性能声明引用了 arXiv 和 HuggingFace，但未提供复现步骤。跨来源佐证：提供了多个外部链接，但未提供独立验证。事实与推断分离：未区分事实和推断。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 仓库未提供权限控制、数据保护或用户确认机制，使用前需自行评估安全风险。
- 依赖管理未锁定版本，且包含从 GitHub 直接安装的依赖，可能引入供应链风险。
- README 中的性能声明缺乏可复现的详细步骤，需谨慎对待。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Security fix Fixes an unauthenticated remote code execution in the WebUI (WebUIAgents), reported through CNVD. All users who expose the WebUI beyond localhost (including the official Docker setup) should upgrade. - switch_agent only loads agent configs listed by list_agents (configs/agents/{examples,simple,orchestra,orchestrator,generated}/*.yaml). - /ws and /upload only accept same-origin requests; add more with UTU_WEBUI_ALLOWED_ORIGINS. - Uploaded filenames are confined to the workspace; uploads are size limited. …在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * Add trajectories tab by @qiuchaofan in https://github.com/TencentCloudADP/youtu-agent/pull/155 * [bugfix] 修复example中FileUtils.save_json的参数顺序 by @Mactarvish in https://github.com/TencentCloudADP/youtu-agent/pull/157 * Tracing: log for visual analysis by @Lightblues in https://github.com/TencentCloudADP/youtu-agent/pull/159 * Feat: add hooks by @Lightblues in https://github.com/TencentCloudADP/youtu-agent/pull/161 * Example: rag by @Lightblues in https://github.com/TencentCloudADP/youtu-agent/pull/162 …在 GitHub 查看 ↗ -
frontend/v0.3.0 utu_agent_ui v0.3.0