最近，腾讯把智能体平台开源了！

江枫在此，专注于AI工具、智能体与AI编程。本文将深入探讨腾讯最新开源的智能体项目 Youtu-Agent，并提供详尽的本地部署指南。在众多国外开源智能体平台中，国内的选择相对有限，字节的 ui-tars 虽有尝试，但用户体验仍有提升空间。然而，腾讯 Youtu-Agent 的出现，为国内开发者带来了新的可能性。本文将带领大家一步步在本地搭建并运行这款强大的智能体平台。

一、 Youtu-Agent 本地部署指南

Youtu-Agent 提供了两种安装方式：uv 和 Docker。考虑到 uv 的安装过程对普通用户可能较为繁琐，本文将重点介绍基于 Docker 的部署方法。

1. 获取项目代码

首先，需要将 Youtu-Agent 的代码克隆到本地：

git clone https://github.com/Tencent/youtu-agent.git
cd youtu-agent/

2. Docker 镜像构建

接下来，使用 Docker 构建项目镜像：

docker build -t youtu-agent .

3. 配置环境变量

将 youtu-agent/docker 目录下的 .env.example 文件复制一份，并重命名为 .env。然后，编辑 .env 文件，根据需求配置大模型及工具参数。

大模型配置：

您可以根据自己的偏好选择大模型。腾讯云为新用户提供了免费的 API 额度，是尝试的好机会。

工具 API 配置：

由于 Agent 在执行任务时需要网页搜索和多模态搜索功能，因此需要配置 Serper API 和 Jina API。请根据官方文档提供的链接申请相应的 API 密钥。

前端界面配置：

配置文件的末尾是前端界面的显示设置，默认端口为 8848。如果本地没有其他应用占用该端口，可以保持默认设置。

4. 启动 Youtu-Agent 服务

配置完成后，执行以下命令启动 Youtu-Agent 服务：

docker run -it -p 8848:8848 -v "D:opensourceenv:/youturunvoutu-agent\dockeragent/.env" youtu-agent

注意：请将命令中的 "D:opensourceenv:/youturunvoutu-agent\dockeragent/.env" 替换为您本地实际的 .env 文件路径。

服务成功启动后，您可以通过终端显示的浏览器地址访问 Youtu-Agent 的网页端界面。

二、 体验第一个本地 Agent

启动 Youtu-Agent 后，在浏览器中输入地址即可进入其简洁清爽的界面。与通用智能体类似，您只需直接输入需求即可开始使用。

示例：输入 deepseek-v3.1 有哪些亮点更新。

Youtu-Agent 的工作流程与直接调用大模型不同，它会调用多个 Agent 来协同完成任务。

• Planner Agent：首先，Planner Agent 负责对任务进行规划，将其分解为可执行的步骤。
• Search Agent：接着，Search Agent 利用配置的各种工具（包括之前设置的 API）来执行搜索任务。
• Reporter Agent：最后，Reporter Agent 将搜索结果进行汇总，并生成一个 SVG 图表。

生成的 SVG 图表不仅内容丰富，而且排版和布局也非常美观，可以直接下载到本地使用。

Youtu-Agent 提供了丰富的应用场景示例，您可以在项目中的 examples 文件夹中找到更多玩法。

三、 Agent 能力的自定义化

Youtu-Agent 的一个突出亮点是其 Agent 能力的自定义化，这在许多其他开源 Agent 项目中并不常见。

您可以通过修改 Agent 的行为定义，而不是直接修改代码或提示词，来定制 Agent 的功能。这种方式大大降低了非技术人员的门槛。

Youtu-Agent 将 Agent 的行为定义存储在 youtu-agent\configs\agents\simple_agents 目录下的 YAML 文件中。例如，您可以打开 analysis_agent.yaml 文件进行编辑。

在 YAML 文件中，您可以定义 Agent 的行为、能力和约束。对于需要生成图表的功能，mermaid_rules 部分定义了 Mermaid 图表的输出规范。您可以直接在这里修改图表的大小、尺寸和风格，实现高度个性化的智能体。

四、 结语

腾讯 Youtu-Agent 的开源，再次彰显了腾讯在 AI 开源领域的积极投入。继类 iMages 知识库项目开源后，这款智能体平台的推出，无疑为国内 AI 开发者生态注入了新的活力。期待腾讯未来能开源更多优质的项目。