Workshop 概覽¶

Workshop 是一系列動手做的教學，帶你從零開始，完整走過平台的核心使用情境。每個教學都以前一個的成果為基礎，逐步延伸——完成整個系列後，你將擁有一套可以實際運作的知識庫問答系統，並了解如何把它整合到外部服務中。

教學內容¶

前置準備：建立知識庫¶

建立整個系列所需的基礎資源：儲存庫、知識庫與載入器。完成後，你的文件將完成索引，可供後續的 Agent 與工作流程進行檢索。

你會學到： 如何上傳文件、設定載入器連接儲存庫與知識庫、執行同步任務，以及確認索引成功。

教學 01：建立 QA Agent¶

以知識庫為基礎建立一個問答 Agent。Agent 能自行決定何時查詢工具，並支援多輪對話與追問。

你會學到： 如何設定 Agent 提示詞、新增 Retrieval 工具、設定工具描述，以及讓 Agent 自主檢索知識庫並回答。

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

為教學 01 的 Agent 加入第二個工具——一個遠端 MCP 伺服器（以網路搜尋為例）。當知識庫資料不足時，Agent 能自動退而使用外部搜尋補充資訊。

你會學到： 如何建立 Streamable HTTP 類型的 MCP 伺服器資源、將 MCP 工具加入 Agent、更新提示詞說明多工具的使用時機，以及驗證 Agent 確實呼叫了兩個工具。

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

反過來，把你的 Agent 包裝成一個 Custom MCP 伺服器，讓 Claude 等外部服務可以呼叫它。

你會學到： 如何建立 Custom 類型的 MCP 伺服器、將 Agent 定義為工具，以及在 Claude 中連接並授權使用這個來自平台的工具。

教學 04：建立 RAG Workflow¶

同樣的知識庫問答情境，改用固定的工作流程實現。分兩階段建立：先讓 LLM 直接回答，再加入檢索器任務，讓回答有所依據——並與前面的 Agent 做法對照。

你會學到： 工作流程的基本結構、如何設定 LLMAction 的提示詞樣板與變數、如何插入 RetrieverAction 並將知識庫檢索結果傳入 LLM，以及工作流程與 Agent 的取捨。