Perfect AI Beauty Agent : le guide d'intégration A2A pour les marques de beauté

Architecture du flux Agent-to-Agent (A2A)

Le flux comporte deux volets :

• Côté client : utilisateur final → site/app de la marque → agent d'IA client charge SKILL.md → appelle Perfect AI Beauty Agent. L'entrée image (selfie / caméra live) est capturée via Perfect CameraKit ou la caméra native de l'appareil.
• Côté Perfect Corp : Perfect AI Agent oriente la requête via : LLM (OpenAI ou LLM de votre choix) pour la compréhension de l'intention → RAG pour la connaissance de la marque, les SKU et la logique de recommandation (provenant de la Console Perfect) → Catalogue de Services pour l'exécution.

Intentions et fonctionnalités disponibles dans les systèmes Agent-to-Agent (A2A)

Chaque fonctionnalité est exposée comme une intention. Votre agent hôte enregistre ces intentions comme des outils. Le runtime de l'agent sélectionne et appelle l'intention appropriée en fonction de la demande de l'utilisateur.

Requête et réponse Agent-to-Agent (A2A)

4.1 requête – champs d'entrée

4.2 réponse – champs de sortie

4.3 exemple : flux chaîné (analyse de peau → recommandation)

# Étape 1 — l'agent hôte envoie une requête d'analyse de peau{"intent": "skin_analysis",
  "brand_id": "acme-beauty",
  "prompt": "Help me with my skincare routine.",
  "image": "<base64 selfie from CameraKit>"}# Étape 1 — réponse de 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 }}}# Étape 2 — l'agent hôte enchaîne vers la recommandation{"intent": "product_recommendation",
  "brand_id": "acme-beauty",
  "analysis_id": "ana_abc123",
  "prompt": "Suggest serums for my top concerns."}# Étape 2 — réponse de 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 — référence du manifeste

Déposez le dossier de compétence dans le répertoire des skills de votre agent. Votre agent lit SKILL.md au démarrage, enregistre les intentions comme outils appelables et sélectionne automatiquement la bonne en fonction de l'intention utilisateur.

Structure du dossier

perfect-ai-beauty-agent/
├── SKILL.md                  # manifeste — capacités, authentification, isolation des données
├── references/
│   ├── intent-schemas.md     # définitions complètes des champs d'entrée/sortie
│   └── brand-onboarding.md   # checklist de configuration de la marque
└── assets/
    └── arch-overview.md      # notes d'architecture A2A

Champs clés du 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
---

Configuration et onboarding pas à pas pour les systèmes Agent-to-Agent (A2A)

Codes d'erreur et mode de gestion

Garantir l'isolation des données et la sécurité dans les flux Agent-to-Agent (A2A)

• brand_id est requis dans chaque requête. Tous les catalogues de SKU, corpus RAG, règles de recommandation et historiques utilisateur sont segmentés par brand_id au niveau des données.
• Les clés d'API sont limitées à une marque. Une clé émise pour la marque A ne peut pas accéder aux données de la marque B : les requêtes renvoient 403.
• Les sessions CameraKit sont éphémères et limitées par jeton. Aucun flux vidéo ni aucune image ne sont conservés côté serveur après la fin de la session.
• user_id est un jeton opaque. Aucune donnée personnelle directement identifiable n'est requise ni stockée. Les marques peuvent choisir d'activer l'historique utilisateur persistant, désactivé par défaut.
• Les clés d'API peuvent être renouvelées à tout moment depuis Perfect Console. Les anciennes clés sont immédiatement révoquées lors de la rotation.