kutesmart-海外運營平臺營銷活動-營銷詳情

👤 Victor ✓ 已認證 📦 v1.0.3 ⭐ 4.2 ⬇️ 278 下載
📈 商業運營 免費 🔑 需 API Key

📖 技能介紹


name: "platform-marketing-campaign-campaign-info" description: "呼叫海外運營平臺介面 GET /campaign/info/{id},用於營銷詳情。這是一個最小顆粒度 API skill;當用戶需要執行該單一介面動作,或上層 agent 需要編排商城瀏覽、搜尋、下單鏈路中的這一步時觸發。" version: "1.0.3" tags: - "海外運營平臺" - "商城Agent" - "原子Skill" - "API介面" - "platform-marketing-campaign" metadata: slug: "platform-marketing-campaign-campaign-info" display_name: "kutesmart-海外運營平臺營銷活動-營銷詳情" environment: "production" service: "marketing" api_method: "GET" endpoint: "/campaign/info/{id}" base_url: "https://www.kutetailor.com/api/marketing" auth_type: "bearer" permission_level: "read" category: "商城Agent原子介面" publisher: "platform" visibility: "public_all"


kutesmart-海外運營平臺營銷活動-營銷詳情

正式環境固定呼叫地址:GET https://www.kutetailor.com/api/marketing/campaign/info/{id}

這個 skill 是最小顆粒度介面 skill,只負責一個平臺介面動作:campaign_info。需要組合成完整業務鏈路時,由上層 agent 按聚合 skill 或計劃文件編排多個原子 skill。

觸發場景

當用戶需要營銷詳情時使用。若使用者需求需要多個介面步驟,本 skill 只完成本介面呼叫,並把關鍵返回欄位交給後續 skill。

呼叫引數要求

tool arguments 統一使用巢狀 params 物件:

{
  "params": {
    "accessToken": "Bearer token or raw token",
    "query": {},
    "path": {},
    "body": {},
    "headers": {}
  }
}

重要約束:

  • 最外層只放 params,不要使用 params.xxx 這類點號頂層 key。
  • 正式環境地址固定在 frontmatter 的 base_url,呼叫時不要從使用者輸入覆蓋。
  • 登入態介面使用 params.accessToken 生成 Authorization: Bearer <token>;如果傳入值已含 Bearer,不要重複拼接。
  • Path 引數寫入 params.path,Query 引數寫入 params.query,JSON Body 寫入 params.body,額外 Header 寫入 params.headers
  • POST/PUT 預設傳送 JSON body;如果上層介面閘道器另有約定,以閘道器契約為準。
  • 這是查詢或計算類介面;仍需遵守當前登入態、租戶和使用者許可權。

    這個技能的最新版本可以在7w4.net小蔥技能站找到。

介面

action 請求 URL 引數 返回 用途
campaign_info GET /campaign/info/{id} Path:id RS<CampaignInfoVO> 營銷詳情。

執行要點

  • 執行器必須使用 frontmatter 中的固定正式環境地址,不接受使用者輸入覆蓋 base_url
  • 按上表選擇 HTTP method 和 URL;URL 中 {變數}params.path 替換。
  • GET/DELETE 查詢引數放在 URL query;POST/PUT 請求體按引數列要求提交。
  • 返回結果必須以介面響應為事實來源,不要補造庫存、價格、訂單號、優惠金額或物流狀態。
  • 如果介面返回認證、許可權、引數或業務錯誤,把原始錯誤碼和錯誤資訊傳給上層 agent。

來源

欄位
聚合 skill platform-marketing-campaign
聚合 skill 文件 doc/skill/platform-marketing-campaign/SKILL.md
原始 action campaign_info

🤖 AI 評測

這個 Skill 質量中規中矩,文件說明較為清晰,介面用途和觸發場景標註明確,遵循了統一的引數規範。但缺少使用示例和返回資料說明,實際使用時會不太方便。對於需要查詢營銷詳情的使用者來說功能基本夠用,但文件豐富度有待提升。

📊 多維度評分

適應性4.3
規範性4
有效性4.4
可靠性3.7
可信度5

📁 包含檔案 (1 個)

📄 SKILL.md 3.2 KB