教學 02：為 Agent 連接 MCP 工具¶

本教學將延伸教學 01 建立的 QA Agent，為其連接一個遠端 MCP（Model Context Protocol）伺服器作為額外工具。完成後，當內部知識庫的資料不足以回答問題時，Agent 能夠退而使用外部網路搜尋。

您將建立的內容¶

一個具備兩個工具的 Agent：

• Retrieval 工具 — 搜尋內部知識庫（來自教學 01）
• MCP 工具 — 當知識庫資料不足時，呼叫遠端 MCP 伺服器取得外部資訊

Agent 會自行判斷每個問題應使用哪個工具。

第一部分：建立 MCP 伺服器資源¶

步驟 1：建立 MCP 伺服器¶

1. 從側邊欄進入「資源」，點擊「MCP 伺服器」。
2. 點擊「+」按鈕建立新的 MCP 伺服器。
3. 填寫表單：
   • 名稱：輸入名稱（例如 tutorial_tavily）
   • 類型：Streamable HTTP
   • 端點 URL：貼上您的提供者提供的 MCP 端點 URL （例如 https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>）
   • HTTP 標頭：除非提供者要求，否則留空
4. 點擊「儲存」按鈕。

第二部分：將 MCP 工具加入 Agent¶

步驟 2：開啟 Agent 進行編輯¶

1. 從側邊欄進入「Agents」。
2. 點擊教學 01 中建立的 tutorial_labor_qa_agent。
3. 在 Agent 詳細頁面，點擊編輯（）圖示。

步驟 3：新增 MCP 伺服器工具¶

1. 向下捲動至「自訂工具」區塊，點擊「+」按鈕。
2. 在「新增工具」對話框中，選擇「MCP 伺服器」。

3. 填寫「新增 MCP 伺服器工具」表單：

   • 名稱：輸入 Agent 用來引用此工具的名稱（例如 tavily_search — 此名稱會出現在 Agent 提示詞中）
   • MCP 伺服器：選擇第一部分建立的伺服器（例如 tutorial_tavily）
   • 描述：說明此工具的功能，以及 Agent 應在什麼情況下使用它

   範例描述（可直接複製貼上）：

   tavily提供的搜尋工具，在retrieval tool所提供的資料，不足以回答當下問題時使用，在網路上搜尋資訊作為輔助型工具。
   

4. 點擊「儲存」按鈕。

步驟 4：更新 Agent 提示詞¶

Agent 現在有了第二個工具，請更新「Agent 提示詞」，說明各工具的使用時機。

在 <task> 區塊加入改用網路搜尋的時機：

<task>
根據民眾提出的問題，優先使用 Retrieval_tool 查詢相關資料，如果沒有足以回答問題的資料，則使用 tavily_search 進行網路搜尋，再依據查詢結果提供完整且正確的回答。
每一則回答都必須有明確的資料來源支撐。
</task>

並在 <tools> 區塊中加入新工具的說明：

<tools>
你可以使用以下工具：

- **Retrieval_tool**：包含內部文件資料。處理任何與業務相關的問題時，請優先使用此工具查詢。
- **tavily_search**：網路搜尋工具。當 Retrieval_tool 所提供的資料不足以回答問題，
  或問題需要來自外部來源的最新資訊時，使用此工具進行補充搜尋。
</tools>

點擊「儲存」按鈕以儲存更新後的 Agent。

步驟 5：以需要網路搜尋的問題測試¶

前往 Agent 的聊天介面（點擊「前往聊天」按鈕）。輸入一個內部知識庫可能無法完整回答的問題，例如：知識庫文件建立後才發生的近期事件或法規異動。可直接複製以下範例問題：

請幫我看看到2026年6月為止，有沒有什麼針對醫護的勞動法規新增或改動

步驟 6：查看回答¶

Agent 會回傳一個整合內部知識庫與外部 MCP 工具的回答，網路搜尋取得的內容會與內部文件結果一併呈現在答案中。

步驟 7：查看思考過程¶

展開「顯示思考過程」，可以看到 Agent 的工具呼叫順序。您應該會看到內部檢索工具與 MCP 工具都列在其中，確認 Agent 使用了兩個來源來組成回答。

總結¶

下一步¶

• 教學 03：將 Agent 發佈為 MCP 伺服器