Personnalités

Une personnalité est un prompt système réutilisable et nommé (« Coach RH », « Assistant juridique », « Rédacteur concis »…). Au lieu de recopier le même prompt système à chaque appel, vous le définissez une fois et le sélectionnez par son slug partout où vous lancez une requête.

La personnalité s’ajoute en tête du prompt système. Les règles de votre organisation (consigne d’org, règles imposées par un administrateur) priment en cas de conflit : une personnalité oriente le ton et le rôle, elle ne contourne pas la politique de l’organisation.

Trois niveaux

Personnelle : créée par vous (dans l’assistant ou le portail), visible de vous seul.
Organisation : créée par un administrateur, disponible pour tous les membres.
Bibliothèque : proposée par Astrolabe, utilisable par tous les comptes.

En cas de slug identique, la précédence est personnelle > organisation > bibliothèque : vous pouvez « surcharger » une personnalité d’org ou globale par la vôtre.

Dans l’API

Passez le paramètre personality (le slug) à POST /v1/chat/completions :

{
  "model": "mistral-small",
  "personality": "coach-rh",
  "messages": [{ "role": "user", "content": "Prépare-moi un entretien annuel." }]
}

Le prompt de la personnalité est injecté comme message système avant l’appel. Un slug introuvable pour votre clé renvoie une erreur 400 (jamais de réponse silencieuse sans la personnalité demandée).

La résolution suit votre clé : une clé d’organisation voit les personnalités de l’org et les globales ; une clé personnelle voit les vôtres et les globales.

Découvrir les slugs

curl https://api.astrolabe.chat/v1/personalities \
  -H "Authorization: Bearer $ASTROLABE_API_KEY"

{
  "personalities": [
    { "slug": "coach-rh", "name": "Coach RH", "description": "…", "icon": "🎯", "scope": "org", "prompt": "…" }
  ]
}

GET /v1/personalities/{slug} renvoie une personnalité précise (résolue avec la même précédence). Ces routes sont en lecture seule : la création et l’édition se font au portail et dans l’assistant.

Dans l’assistant, le playground et les tâches

Assistant : un sélecteur de personnalité apparaît à la création d’une conversation. Vous pouvez aussi définir une personnalité par défaut (menu « Mes personnalités ») appliquée à vos nouvelles conversations. La conversation conserve la personnalité choisie à sa création.
Playground : un sélecteur « Personnalité » au-dessus du prompt système. Il s’ajoute au prompt système libre.
Tâches : chaque tâche peut déclarer une personnalité, composée avec la consigne d’org au moment de l’exécution.

Dans Slack

La commande /astrolabe-personnalite gère votre personnalité par défaut :

/astrolabe-personnalite — liste les personnalités disponibles (l’actuelle est marquée) ;
/astrolabe-personnalite <slug> — la définit comme votre personnalité par défaut (appliquée par le bot et pré-sélectionnée dans l’assistant web) ;
/astrolabe-personnalite aucune — la retire.

Make / Zapier

Le module de chat expose un champ « Personality » : renseignez le slug d’une personnalité existante.

Exporter / importer

Une personnalité s’exporte en fichier JSON portable (sans secret) que vous pouvez transmettre à quelqu’un d’autre, ou qu’un administrateur peut ajouter à la bibliothèque. À l’import, le formulaire de création est pré-rempli.