Points de terminaison Persona API

Référence complète des points de terminaison REST API des personas - lister, créer, mettre à jour, supprimer, dupliquer, activer/désactiver et consulter les analytics des personas d’agents IA.

8 min lire
apipersonasagents

Les personas définissent la personnalité, les compétences et les préférences de modèle des agents de codage IA. Chaque persona peut être assignée à des étapes de pipeline de workflow pour contrôler le comportement des agents durant l’exécution. La Persona API fournit 9 points de terminaison pour une gestion complète du cycle de vie.

Points de terminaison

GET /api/v1/personas/list

Liste toutes les personas du projet.

curl -H "Authorization: Bearer cc_live_..." \
  https://<deployment>.convex.site/api/v1/personas/list

GET /api/v1/personas/get

Récupère une seule persona par ID.

Paramètres de query :

  • id (requis) - L’ID du document persona
curl -H "Authorization: Bearer cc_live_..." \
  "https://<deployment>.convex.site/api/v1/personas/get?id=..."

GET /api/v1/personas/analytics

Consulte les analytics et statistiques d’usage d’une persona.

Paramètres de query :

  • id (requis) - L’ID du document persona
  • days (optionnel) - Nombre de jours de lookback (par défaut : historique complet)

POST /api/v1/personas/create

Crée une nouvelle persona.

curl -X POST -H "Authorization: Bearer cc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Senior Architect",
    "description": "Expert in system design and code review",
    "type": "checker",
    "cliId": "claude_code",
    "model": "claude-sonnet-4-20250514",
    "thinkingEffort": "high",
    "instructions": "Focus on architecture, performance, and security.",
    "selectedSkills": ["code-review", "architecture"],
    "isEnabled": true
  }' \
  https://<deployment>.convex.site/api/v1/personas/create

Champs du body :

  • name (string, requis) - Nom d’affichage
  • description (string, optionnel) - Description lisible
  • type (string, requis) - Type de persona (p. ex., designer, checker, optimizer)
  • cliId (string, optionnel) - Identifiant de l’outil CLI
  • model (string, optionnel) - ID du modèle LLM
  • thinkingEffort (string, optionnel) - Niveau d’effort de réflexion
  • instructions (string, optionnel) - Instructions personnalisées
  • selectedSkills (array, optionnel) - Identifiants de skills
  • isEnabled (boolean, optionnel) - Si la persona est active

POST /api/v1/personas/update

Met à jour une persona existante. Tous les champs du body sauf personaId sont optionnels.

{
  "personaId": "...",
  "name": "Updated Name",
  "model": "claude-opus-4-20250514",
  "learningsEnabled": true
}

Champs additionnels : description, type, thinkingEffort, instructions, selectedSkills, isEnabled, learningsEnabled.

POST /api/v1/personas/delete

Supprime une persona.

{ "personaId": "..." }

POST /api/v1/personas/duplicate

Crée une copie d’une persona existante.

{ "personaId": "..." }

POST /api/v1/personas/toggle

Bascule l’état activé/désactivé d’une persona.

{ "personaId": "..." }

POST /api/v1/personas/bulk-delete

Supprime plusieurs personas en une seule requête.

{ "personaIds": ["id1", "id2", "id3"] }