Créer des personas
Guide étape par étape pour créer des personas IA dans CodeCourier, incluant les dix types de personas, les champs, la liaison de contexte et la configuration initiale.
Créer une persona dans CodeCourier ne prend que quelques clics depuis le dashboard. Une fois créée, la persona peut être utilisée dans n’importe quel persona pipeline au sein du projet. Ce guide décrit le processus de création, explique chaque champ et fournit des recommandations pour obtenir les meilleurs résultats de vos configurations de persona.
Créer une persona depuis l’UI
Naviguer vers la page Personas
Depuis votre dashboard de projet, trouvez l’entrée Personas dans la navigation latérale. Si vous ne la voyez pas, il se peut que vous deviez scroller ou y accéder depuis le menu de navigation. La page des personas se trouve à l’adresse /p/{projectId}/personas.
Ouvrir le dialogue de création
Cliquez sur le bouton + Create dans le coin supérieur droit de l’en-tête de page. Cela ouvre un dialogue où vous saisissez les détails de base de la persona. Si vous n’avez encore aucune persona, la page affiche un état vide avec un bouton de création bien visible.
Saisir un nom
Donnez à votre persona un nom descriptif qui reflète son objectif. De bons noms communiquent le rôle et la spécialisation d’un coup d’œil :
Frontend Designer- un designer axé sur l’implémentation UIStrict Code Reviewer- un reviewer avec un feedback détailléSecurity Checker- un checker qui fait respecter les standards de sécuritéPerformance Optimizer- un optimizer axé sur l’efficacité runtimeArchitecture Planner- un planner pour les tâches de conception système
Les noms doivent être non vides et sont validés à la soumission. Ils peuvent être modifiés ultérieurement depuis la page de détail de la persona.
Sélectionner un type
Choisissez le type de persona dans le menu déroulant. CodeCourier définit les types suivants, chacun correspondant à un rôle spécifique dans le pipeline de workflow :
- Designer - Agent principal de codage et d’implémentation
- Checker - Code review avec verdict pass/fail et feedback
- Optimizer - Agent d’amélioration de code et de refactoring
- Prompter - Agent de prompt engineering et de spécification
- Investigator - Agent d’analyse de codebase et de recherche
- Planner - Agent d’architecture et d’analyse d’issues
- Deep-Dive - Agent d’analyse intensive multi-système
- Reviewer - Code review qualitatif sans verdict pass/fail
- Custom - Type libre pour des rôles spécialisés ou non standard
Le type détermine l’icône de la persona et son comportement par défaut au sein des persona pipelines. La sélection par défaut est designer.
Ajouter une description (optionnel)
Le champ description est optionnel mais recommandé. Utilisez-le pour documenter l’objectif de la persona, sa spécialisation, ou toute convention qu’elle doit suivre. Cela aide les membres de l’équipe à comprendre à quoi sert la persona lorsqu’ils la sélectionnent dans les configurations de workflow.
Soumettre le formulaire
Cliquez sur Create pour enregistrer la persona. En cas de succès, vous êtes automatiquement redirigé vers la page de détail de la persona où vous pouvez configurer des paramètres avancés comme la sélection du modèle, les instructions, les skills, les commands, les scripts et la liaison de contexte.
Démarrage rapide
Référence des champs de persona
Le dialogue de création capture les champs essentiels. La configuration complète est disponible sur la page de détail de la persona après la création. Voici une référence complète de tous les champs :
Champs principaux (définis à la création)
| Champ | Type | Requis | Description |
|---|---|---|---|
name | string | Oui | Nom d’affichage de la persona. Doit être non vide. |
type | enum | Oui | Type de rôle : designer, checker, optimizer, prompter, investigator, planner, deep-dive, reviewer ou custom. |
description | string | Non | Description lisible par un humain de l’objectif de la persona. |
Champs de configuration (définis sur la page de détail)
| Champ | Type | Défaut | Description |
|---|---|---|---|
cliId | string | Défaut du projet | Quel outil CLI utiliser (par ex., claude, opencode, codex). |
model | string | Défaut de l’outil | Modèle LLM spécifique (par ex., claude-opus-4-6, claude-sonnet-4-6). |
thinkingEffort | string | none | Profondeur de reasoning : none, low, medium, high, xhigh ou max. |
instructions | string | Vide | Instructions système personnalisées pour l’agent. |
contextId | ID | Aucun | Lie un document Context à cette persona. Le markdown de la version active du contexte est injecté dans la sandbox aux côtés des instructions de la persona. |
selectedSkills | string[] | Vide | Tableau d’IDs de skills à rendre disponibles pendant les sessions. |
selectedCommands | string[] | Vide | Tableau d’IDs de commands à injecter dans la sandbox comme alias ou commands shell. |
selectedScripts | string[] | Vide | Tableau d’IDs de scripts à injecter dans la sandbox comme scripts exécutables. |
learningsEnabled | boolean | true | Si les learnings compilés sont injectés dans les sessions. |
isEnabled | boolean | true | Si la persona est active et sélectionnable dans les pipelines. |
Champs de versioning (gérés automatiquement)
| Champ | Type | Description |
|---|---|---|
version | number | Numéro de version croissant de manière monotone. Commence à 1 à la création. |
isLatest | boolean | True sur la version active actuelle. Une seule version par persona est latest à tout moment. |
parentPersonaId | ID | Pointe vers l’enregistrement de version précédent. Null sur la première version. |
Versioning et édition
isLatest et tous les futurs workflow runs l’utilisent. Les versions précédentes sont préservées et visibles dans l’historique des versions.Liaison de contexte
Les documents Context sont des ressources markdown réutilisables - documentation, guides de référence, notes architecturales, ou tout autre matériel de référence - que vous maintenez séparément des instructions de persona. Lorsque vous liez un document de contexte à une persona via le champ contextId, le markdown de la version active du contexte est automatiquement préfixé à la configuration de la sandbox aux côtés des propres instructions de la persona.
C’est particulièrement puissant pour partager du contexte entre plusieurs personas sans dupliquer le contenu. Par exemple, un document de contexte “Codebase Architecture” pourrait être lié simultanément à vos personas designer, reviewer et deep-dive. Lorsque vous mettez à jour le document d’architecture, les trois personas récupèrent le changement à leur prochain run.
Pour lier un contexte, naviguez vers l’onglet Context sur la page de détail de la persona et sélectionnez un document de contexte dans le menu déroulant. Seuls les documents de contexte actifs sont listés.
Créer des personas via l’API
Les personas peuvent aussi être créées de manière programmatique via la mutation Convex. C’est utile pour automatiser la configuration de personas ou construire des outils personnalisés :
import { api } from "@/convex/_generated/api";
import { useMutation } from "convex/react";
// In a React component:
const createPersona = useMutation(api.personas.create);
const personaId = await createPersona({
projectId: "your-project-id",
name: "Frontend Designer",
type: "designer",
description: "Specialized in React and Tailwind CSS",
model: "claude-opus-4-6",
instructions: "Follow the project's component patterns...",
contextId: "context-id-for-architecture-doc",
selectedSkills: ["frontend-design", "vitest-testing"],
selectedCommands: ["lint-check", "type-check"],
selectedScripts: ["run-tests"],
isEnabled: true,
});Validation
ConvexError par la mutation. Trimmez toujours la saisie utilisateur avant de la soumettre.Dupliquer des personas existantes
Si vous voulez créer une persona similaire à une existante, utilisez l’action Duplicatedepuis la liste des personas. Cela crée une copie avec “(copy)” ajouté au nom et des paramètres identiques - y compris la même liaison de contexte, les mêmes skills, commands et scripts. Vous pouvez ensuite la renommer et ajuster les champs qui doivent changer. La duplication est souvent plus rapide que de créer depuis zéro lorsque vous avez besoin de plusieurs personas avec des configurations similaires.
Opérations groupées
La page de liste des personas prend en charge la sélection groupée avec des cases à cocher. Sélectionnez plusieurs personas et utilisez la barre d’actions groupées pour toutes les supprimer en une fois. La suppression groupée utilise le soft delete, ce qui signifie que les personas sont déplacées vers la corbeille et peuvent être restaurées si nécessaire.