自訂 Skills#

#概覽

MeDo 官方 Skills 已覆蓋廣泛場景，包括 AI 工具、付款服務、影片技術、語音與圖片處理、文字處理、地圖服務、資訊搜尋、登入驗證等，幫助你高效完成任務並建立功能豐富的應用程式。

不過，官方 Skills 未必能完全滿足更垂直或高度自訂的業務需求。為此，MeDo 提供 自訂 Skills：只需上傳 .zip skill package，即可快速建立自訂 Skill，並在任務執行或應用程式生成期間靈活調用。

透過自訂 Skills，你可以為 MeDo 配備更豐富、更專業的能力和領域知識，讓它更有效地完成專業任務，或建立更符合業務需求的應用程式。

#外部 API 整合

目前，MeDo 暫時移除了直接透過 API 文檔連結或 API 描述建立自訂插件的方法。如果你需要整合外部 API，目前可使用以下方式。

未來，MeDo 將支援直接透過對話將 API 轉換為自訂插件，建立後即可快速用於任務執行或應用程式生成。敬請期待。

#在對話中直接整合

你可以在對話中直接提供 API 描述或 API 文檔連結，MeDo 會協助你整合 API。

範例：

請使用以下 API 生成一個天氣查詢應用程式：

https://openweathermap.org/api/current?collection=current_forecast

#透過對話或「Skill Creation & Editing」Skill 生成 skill package

在對話中提及 "@Skill Creation & Editing" Skill，並貼上 API 描述或 API 文檔連結。MeDo 會協助將 API 轉換為 skill package，你可以下載並匯入到 Custom Skills。

請注意，你提供的 API 描述應盡可能完整。可參考以下範例中的建議結構和必要資訊。

範例：

請使用 @Skill Creation & Editing，根據以下 API 文檔建立一個 .zip 天氣查詢 skill package。

Plugin Name：Weather Query

Plugin Description：根據城市名稱擷取即時天氣資訊，包括溫度、濕度和天氣狀況。

Request Method：GET

Full Request URL：
https://api.example.com/v1/weather?city=Beijing&unit=C

Request Header：Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.FAKE_PAYLOAD.SIGNATURE_FAKE

Request Parameters：
city：必填，城市名稱，例如 Beijing
unit：選填，溫度單位，C 或 F，預設為 C

Request Example (curl):
curl -X GET "https://api.example.com/v1/weather?city=Beijing&unit=C" -H "Authorization: Bearer YOUR_API_KEY"

#成功回應範例

{
  "city": "Beijing",
  "temperature": 18,
  "unit": "C",
  "condition": "Cloudy",
  "humidity": 62
}

#錯誤回應範例

{
  "error": "invalid_city",
  "message": "City not found"
}

#錯誤碼

• invalid_city：城市不存在（HTTP 404）
• missing_city：缺少城市參數（HTTP 400）
• invalid_unit：無效的溫度單位（HTTP 400）
• unauthorized：驗證失敗（HTTP 401）
• rate_limited：請求過多（HTTP 429）
• server_error：伺服器錯誤（HTTP 500）

#直接匯入並建立

如果你已準備好包含 API 的 skill package，可以直接匯入 Custom Skills。詳細指引請參閱以下章節。

#建立自訂 Skills

請前往：【My Skills > Create Skill】

#上傳 Skills

#Skill 上傳格式要求

進入 Skill Creation & Editing 頁面後，你可以點擊上傳區域或將文件拖入上傳區，上傳 .zip Skill Package 或 SKILL.md 文件。Skill Package 和 SKILL.md 文件都必須遵循下方的標準 SKILL 格式。

.zip Skill Package 建議結構：

• SKILL.md（必需，skill 定義文件）
• Additional Resources（選填）
• scripts/（Scripts）：Python 或 Shell 自動化腳本等可執行程式碼
• references/（Reference Materials）：產品文檔、業務規則、知識庫內容等
• assets/（Assets）：範本、圖示、字型、圖片和其他資源文件

financial-analysis.zip
└── financial-analysis/
    ├── SKILL.md           # 必需，skill 定義文件
    ├── scripts/           # 選填，腳本
    │   └── analyze.py
    ├── references/        # 選填，參考材料
    │   └── knowledge.md
    └── assets/            # 選填，素材
        └── icon.png

SKILL.md 結構範例：

---
name: skill-name
description: |
  Briefly describe the capability and applicable scenarios of this Skill.
  Use when: (1) Scenario One, (2) Scenario Two
---

## Purpose

Describe the core objective of this Skill.

## Instructions

Define the execution workflow and behavior rules of this Skill.

## Examples

Input: xxx

Output: xxx

## Guardrails

Define usage boundaries and limitations.

SKILL.md 完整範例：

---
name: financial-analysis
description: |
  Analyze enterprise financial data and generate insights.
  Use when: (1) Financial report analysis, (2) Company comparison, (3) Risk identification
---

## Purpose

Help users analyze financial data, identify business trends, and detect potential risks.

## Instructions

1. Understand the user's input data or questions
2. Analyze key financial indicators
3. Generate structured conclusions

## Examples

Input: Financial reports from the past three years of a company

Output: Revenue trends, profit changes, and risk alerts

## Guardrails

- Do not fabricate data
- Ask follow-up questions when data is insufficient

#注意事項

將 .zip Skill Packages 和 SKILL.md 文件上傳至 MeDo 時，需符合以下格式要求。

Frontmatter 範例：

---
name: financial-analysis
description: |
  Analyze enterprise financial data and generate business insights.
  Use when: (1) Financial report analysis, (2) Company comparison
---

## Instructions

1. Analyze user input
2. Extract key indicators

......

上傳完成後，MeDo 會根據你提供的內容解析並設定 skill。此過程通常需要約一分鐘。解析期間請勿離開頁面。

如果解析成功，介面會顯示 skill 設定。詳情請參閱第 2 節。如果解析失敗，MeDo 會停止解析並說明原因。

#編輯設定

解析成功後，介面會顯示 skill 設定。

#基本資訊

MeDo 會根據上傳的 skill package 自動設定 skill 圖示、skill 名稱和 skill 描述。

示意圖：

#環境變數

如果 skill 包含環境變數，介面會顯示 Environment Variables 模組。環境變數是 skill 執行所需的設定值，例如 API Keys。設定後，skill 會在執行期間安全讀取這些值，不會對外暴露。

項目	說明	示意圖
Name	調用 skill 時使用的環境變數名稱。此值由 MeDo 自動生成，不能修改。
Value	與 Name 對應的值。填寫後，skill 在調用時會自動使用此設定。如果留空，則需要在專案中使用該 skill 時手動設定。

#Skill Definition

Skill Definition 是 MeDo 將此 skill 整合到應用程式中的核心依據。它會根據上傳的 skill package 自動生成，無法手動修改。

生成後，你可以檢查內容是否符合預期，包括是否已包含所有必需文件，以及文件內容是否準確。對於 API 型 skills，你還應檢查所有必要 endpoint、endpoint 描述和範例是否完整。

如果生成結果不符合預期，可以修改對應 skill 文件並重新上傳解析。

#完成建立

所有資訊設定完成後，點擊 Create 即可完成自訂 skill 建立流程。

#使用自訂 Skills

#測試 Skills

建立完成後，你可以在應用程式中調用該 skill 進行測試。你可以使用「@」定位自己的自訂 skills，並直接調用。

#測試自訂 Skill 是否能正確調用

調用 skill 生成應用程式或功能後，你可以從左側欄的 Used Skills 列表檢查該 skill 是否已被使用。

情況	說明	示意圖
已使用	如果該 skill 出現在 Used Skills 列表中，可以繼續進行功能測試。
未使用	如果該 skill 未被使用，請嘗試再次調用它以重新生成功能或應用程式。如果仍然無法調用，請返回 skill 設定頁，檢查 Skill Definition 中的 endpoint 名稱和描述是否與目標使用場景匹配。如不匹配，請改善頂部輸入框中的描述並重新生成 Skill Definition。

#測試自訂 Skills 的可用性

如果自訂 skill 可以成功調用，下一步就是測試生成的功能是否正常運作。

例如，如果你建立了一個自訂油價查詢 skill，就應測試它是否真的能正確取得油價。

情況	說明	示意圖
功能正常運作	這表示你已成功建立一個可用的自訂 skill，並可在你的應用程式中使用。	/
功能無法正常運作	這可能由憑證錯誤或生成質量問題引起。請先確認提供的憑證是否正確。如果問題仍然存在，請嘗試透過對話修復。如果能透過對話修復，通常表示自訂 skill 本身可用。 如果多輪對話仍無法解決問題，問題可能出在自訂 skill definition 本身。請返回 skill 設定頁，檢查 API 文檔是否完整，包括 endpoint 定義、endpoint 路徑和方法、請求參數、請求範例、回應範例、錯誤碼和描述。如有任何資訊缺失，請更新描述並重新生成 skill definition。

#正式使用

Skill 通過測試後，即可在應用程式中正式使用。

不過，實際使用效果仍可能受需求描述不清等因素影響，導致生成的功能未必能一次達到高度可用狀態。因此，即使測試成功，某些與 skill 相關的功能偶爾仍可能不符合預期。遇到這種情況時，你可以直接透過對話修復問題。

#管理自訂 Skills

你可以透過以下入口管理已建立的 skills：

【Skills > My Skills > 目標 Skill】

你可以在此設定或刪除自訂 skills。

從 Skill > My Skills 刪除 skill 後，該 skill 將無法再用於生成新的應用程式或功能。不過，已經使用該 skill 的應用程式不會受到影響。

如果你也希望既有應用程式停止使用該 skill，請從對應應用程式中移除該 skill。移除後，該應用程式就不會再使用該 skill。