Workshop 概覽¶

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

教學內容¶

前置準備：建立知識庫¶

建立整個系列所需的基礎資源：Storage、Knowledge Base 與 Loader。 完成後，你的文件將完成索引，可供後續的 Workflow 與 Agent 進行檢索。

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

教學 01：建立 RAG Workflow¶

分兩階段建立一個問答 Workflow：先讓 LLM 直接回答，再加入檢索器任務，讓回答有所依據。

你會學到： Workflow 的基本結構、如何設定 LLMAction 的提示詞樣板與變數、如何插入 RetrieverAction 並將知識庫檢索結果傳入 LLM。

教學 02：建立 QA Agent¶

把相同的知識庫問答情境改用 Agent 實現。Agent 能自行決定何時查詢工具，並支援多輪對話與追問。

你會學到： 如何設定 Agent 提示詞、新增 Retrieval 工具、設定工具描述，以及 Agent 與 Workflow 在執行模式與對話方式上的差異。

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

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

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

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

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

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