江楓在此，專注于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 開發者生態注入了新的活力。期待騰訊未來能開源更多優質的項目。