實踐：智慧體掛載技能與 MCP 工具

本篇以「會議助手」智慧體為例，講解 LanSphere 智慧體如何掛載藍信 MCP 工具與自訂技能：使用者用自然語言提出需求，智慧體自主決策呼叫查詢行程、建立會議、傳送私聊訊息等工具完成任務。適合已了解工作流與對話流、希望構建自主任務執行能力的開發人員閱讀。

場景與價值

約會議前翻行程、建會議後逐個發通知、會後整理紀要——這些事不複雜但瑣碎。智慧體與工作流的區別在於：工作流按固定流程執行，智慧體則由大模型根據使用者意圖自主規劃、呼叫工具。把藍信的行事曆、會議、訊息能力以 MCP 工具形式掛給智慧體，再掛一個自訂「會議紀要」技能，使用者一句話就能完成一連串操作。

你將搭建什麼

一個「會議助手」智慧體：幫使用者查行程、建立會議、給參會人發藍信通知，還能把會議記錄整理成結構化紀要。最終發佈到藍信 AI 助理，終端使用者在藍信客戶端「AI 助理市場」中直接對話使用。

準備工作

第一步：建立「會議紀要」程式碼技能

技能是可複用的能力單元，掛載到智慧體後由大模型按使用者意圖自動決策呼叫時機。這裡建立一個程式碼技能，把使用者貼上的會議記錄整理為「結論摘要 + 待辦事項」的結構化結果。

1. 進入「左側選單 → SKILL 管理 → 自訂技能」，點擊「建立技能」。
2. 基礎資訊：名稱填「會議紀要」（必填，不超過 30 字元，同一空間內唯一），描述選填（不超過 200 字元）。
3. 選擇類型：程式碼技能（Python 程式碼片段，定義輸入輸出 schema）。

注意：技能類型建立後不可修改。

4. 設定輸入參數（JSON Schema），範例：

{
  "type": "object",
  "properties": {
    "meeting_title": { "type": "string", "description": "會議標題" },
    "transcript": { "type": "string", "description": "會議討論原文或要點記錄" }
  },
  "required": ["transcript"]
}

5. 設定輸出參數（JSON Schema），範例：

{
  "type": "object",
  "properties": {
    "summary": { "type": "string", "description": "會議結論摘要" },
    "action_items": {
      "type": "array",
      "items": { "type": "string" },
      "description": "待辦事項列表"
    }
  }
}

6. 設定執行邏輯：編寫 Python 程式碼片段，解析輸入並返回與輸出 schema 一致的結構，範例：

def main(meeting_title: str = "", transcript: str = "") -> dict:
    lines = [line.strip() for line in transcript.splitlines() if line.strip()]
    action_items = [line for line in lines if "待辦" in line or "負責" in line]
    summary = lines[0] if lines else "無有效會議記錄"
    if meeting_title:
        summary = f"{meeting_title}：{summary}"
    return {"summary": summary, "action_items": action_items}

提示：程式碼寫法以頁面提供的程式碼範本為準，確保返回值欄位與輸出 schema 對應。

7. 偵錯執行並儲存：儲存前必須至少成功偵錯一次（偵錯逾時 30 秒），用一段真實會議記錄驗證輸出結構後再儲存。

第二步：建立智慧體

1. 點擊「新建專案」，應用類型選擇「智慧體」，填寫名稱（如「會議助手」）。
2. 進入「應用開發」分頁，完成模型選擇（可選用系統預設對話模型）。
3. 編寫提示詞。提示詞規範智慧體的應答規則，僅內部使用，終端使用者不可見：

你是一名會議助手，幫助使用者處理行程、會議與會議通知相關的事務。

## 能力範圍
1. 查詢行程：按使用者指定的日期查詢行程安排。
2. 建立會議：根據使用者提供的主題、時間、參會人建立會議。
3. 傳送通知：給指定參會人傳送藍信私聊訊息。
4. 整理紀要：根據使用者貼上的會議記錄產生結構化會議紀要。

## 執行規則
- 建立會議、傳送通知等實際操作前，先向使用者複述關鍵資訊
  （主題、時間、參會人、訊息內容），得到確認後再執行。
- 資訊不足時主動追問，不要臆測日期、時間與人員。
- 使用者說「今天」「明天」等相對日期時，先換算為具體日期再呼叫工具。
- 工具呼叫失敗時，向使用者說明失敗情況並建議重試，不要假裝已完成。

## 輸出格式
- 行程、會議列表分條展示，包含時間與主題。
- 操作完成後簡要回執：完成了什麼、關鍵資訊是什麼。
- 與會議、行程無關的請求，禮貌說明自己的能力邊界。

第三步：掛載藍信 MCP 工具

在「應用開發 → 工具設定」中，從 MCP 服務分類勾選藍信 MCP 服務的以下工具：

掛載後，大模型會根據使用者意圖自動決策呼叫哪個工具、何時呼叫，無需在畫布中編排固定順序。

第四步：掛載「會議紀要」技能

在工具設定區的「技能」分類中勾選第一步建立的「會議紀要」技能。如智慧體掛載了多個技能，可按需設定允許或禁止呼叫的技能，避免意圖相近的技能互相干擾。

第五步：表單設定（可選）

如希望使用者進入對話前先補充基礎資訊（例如預設參會範圍、所在部門），可在表單設定中新增表單項。表單變數會自動替換提示詞中的對應變數，減少每輪對話中的重複說明。按頁面提示完成設定即可。

第六步：偵錯對話

在偵錯區進行三輪對話，觀察模型如何決策呼叫工具：

第一輪：查行程。 使用者：「幫我看看今天有什麼安排？」——模型識別為查詢意圖，呼叫「查詢行程」工具，把結果分條整理後返回。

第二輪：建會議。 使用者：「明天下午 3 點約一個專案評審會，參會人張三、李四。」——模型先把「明天」換算為具體日期，複述會議主題、時間、參會人請使用者確認；使用者回覆「確認」後，呼叫「建立會議」工具並回執結果。

第三輪：發通知。 使用者：「給張三和李四發個訊息，提醒他們明天評審會帶上季度資料。」——模型呼叫「傳送私聊訊息」工具逐個傳送，完成後回執傳送情況。

三輪涵蓋了「查詢 → 確認後執行 → 批次操作」的典型決策路徑。偵錯中重點關注：模型是否選對了工具、相對日期是否換算正確、敏感操作前是否先徵求確認。

第七步：發佈到藍信 AI 助理

智慧體支援發佈到藍信 AI 助理（需管理員及以上角色，且僅限本人建立的應用）：

1. 進入應用詳情頁「發佈渠道」分頁，選擇「藍信 AI 助理」。
2. 已綁定藍信的帳號，確認彈出視窗後直接發佈；未綁定的，按彈出視窗引導跳轉藍信授權認證中心，掃碼認證通過後自動執行發佈。
3. 助理標題預設繼承應用名稱（不超過 10 字）、描述預設繼承應用說明（不超過 20 字）。
4. 發佈後系統自動在藍信側建立應用與機器人實例，上架藍信客戶端「AI 助理市場」。終端使用者首次使用需完成資料授權，同意授權後方可對話。

調優與邊界

上線後可在「資料看板」分頁檢視執行成功率、工具呼叫分佈等指標，在「對話日誌」分頁對回答標記好評/差評並新增標註回覆，持續優化。

擴充思路

• 關聯知識庫：把會議紀要範本、會議室使用規範等文件掛給智慧體，回答更貼合單位實際；
• 工作流呼叫：把「每週例會提醒」做成定時工作流，在畫布中新增「智慧體」節點呼叫本智慧體；
• 批次通知：使用藍信 MCP 的「取得群成員」工具，實現按群批次傳送通知；
• 工作流技能：已有成熟工作流時，可將其封裝為工作流技能掛給智慧體，複用既有流程。