玩美 AI Beauty Agent：美妝品牌 A2A 串接完整指南

Agent-to-Agent（A2A）流程架構說明

整體流程可分為兩端：

• Client 端——終端使用者 → 品牌官網／ App → Client AI Agent 載入 SKILL.md → 呼叫玩美 AI Beauty Agent。影像輸入（自拍／即時相機）可透過 Perfect CameraKit 或裝置原生相機擷取。
• 玩美移動端——玩美 AI Agent 流程包含：LLM（OpenAI 或指定 LLM）解析意圖 → RAG 讀取品牌知識庫、SKU 與推薦邏輯（來自 Perfect Console）→ Services Catalog 執行服務。

Agent-to-Agent（A2A）系統中的意圖與可用能力

每個能力都以命名 intent 暴露給外部。主控 Agent 會將這些 intent 註冊成工具，並由 Agent 執行環境依照使用者需求，自動選擇並呼叫正確的 intent。

Agent-to-Agent（A2A）請求與回應格式

4.1 Request — 輸入欄位

4.2 Response — 輸出欄位

4.3 範例：串接流程（膚質分析 → 產品推薦）

# Step 1 — 主控 Agent 發送膚質分析請求{"intent": "skin_analysis",
  "brand_id": "acme-beauty",
  "prompt": "Help me with my skincare routine.",
  "image": "<base64 selfie from CameraKit>"}# Step 1 — Perfect AI Beauty Agent 回應{"intent_handled": "skin_analysis",
  "message": "Your skin type is Normal. Top concerns: Moisture (mild), Dark Circles (mild).",
  "image": "<annotated skin report URL>",
  "analysis_id": "ana_abc123",
  "data": {"skin_type": "Normal",
    "concern_scores": { "moisture": 68, "dark_circles": 72 }}}# Step 2 — 主控 Agent 串接產品推薦{"intent": "product_recommendation",
  "brand_id": "acme-beauty",
  "analysis_id": "ana_abc123",
  "prompt": "Suggest serums for my top concerns."}# Step 2 — Perfect AI Beauty Agent 回應{"intent_handled": "product_recommendation",
  "message": "Based on your skin report, here are 2 serums for moisture and dark circles.",
  "data": {"recommendations": [{ "sku_id": "SERUM-VC01", "name": "Vitamin C Serum", "match_score": 0.94, "reason": "Targets dark circles and hyperpigmentation" },
      { "sku_id": "SERUM-HA02", "name": "Hyaluronic Acid Serum", "match_score": 0.89, "reason": "Deep hydration for moisture-deficient skin" }]}}

SKILL.md — Manifest 參考說明

將 skill 資料夾放進 Agent 的 skills 目錄中。Agent 啟動時會讀取 SKILL.md，註冊裡面的 intents 成為可呼叫工具，並依照使用者意圖自動選擇正確的 intent。

資料夾結構

perfect-ai-beauty-agent/
├── SKILL.md                  # manifest — 能力、驗證、資料隔離設定
├── references/
│   ├── intent-schemas.md     # 完整輸入／輸出欄位定義
│   └── brand-onboarding.md   # 品牌上線設定清單
└── assets/
    └── arch-overview.md      # A2A 架構說明筆記

關鍵 Frontmatter 欄位

---
name: perfect-ai-beauty-agent
description: >
  Invoke Perfect AI Beauty Agent for skin analysis (CameraKit),
  skincare product recommendations, virtual try-on, or beauty consultation.
  Brand-scoped: all data partitioned by brand_id.
  Trigger: skin analysis, skincare advice, product recommendation,
  virtual try-on, beauty consultation, skin score, CameraKit.
license: Proprietary — contact api-support@perfectcorp.com
metadata:
  author: Perfect Corp RD
  version: 0.1-draft
---

Agent-to-Agent（A2A）系統逐步設定與品牌導入流程

錯誤代碼與處理方式

在 Agent-to-Agent（A2A）工作流程中確保資料隔離與安全性

• 每次請求都必須提供 brand_id。所有 SKU 商品庫、RAG 語料、推薦規則與使用者歷史，會在資料層依照 brand_id 分區隔離。
• API Key 皆為品牌範圍。發給品牌 A 的金鑰無法存取品牌 B 的資料，否則請求會回傳 403。
• CameraKit 工作階段為暫時性的且以 token 綁定。在工作階段結束後，伺服器端不會保留任何影像畫面或相片。
• user_id 為不透明 token。不需要、也不會儲存任何真實個資（PII）。是否啟用使用者歷史由品牌自行選擇，預設為關閉。
• API Key 可隨時輪替。可在玩美移動 Console 中重發新金鑰，舊金鑰會在輪替後立即失效。