Pyxaura Pyxaura

Mettre en place Pyxaura pour un cas d'usage métier

Les pages Cas d'usage présentent les scénarios types (documentation interne, support
client, juridique, freelances, PME, développeurs). Ce guide donne la marche à suivre pratique,
commune à la plupart de ces usages, pour passer de l'idée à un assistant opérationnel.

1. Délimiter le périmètre avant de connecter quoi que ce soit

Créez un space dédié à ce cas d'usage précis plutôt que de tout mélanger dans un espace unique
(voir le guide des bonnes pratiques d'indexation).
Un space "Support client" et un space "Documentation RH" ne devraient jamais partager les mêmes
documents : une question posée dans le contexte support ne doit pas remonter une procédure RH sans
rapport.

2. Choisir les bonnes sources selon le cas d'usage

Cas d'usage Sources typiques
Documentation interne Google Drive/Notion (wiki, procédures), upload de PDF
Support client Upload (CGV, FAQ, base de connaissances), Notion
Juridique Upload (contrats, réglementation), avec un soin particulier à la structuration (voir §2 du guide indexation)
Développeurs Dépôt(s) Git (voir le guide dédié)
PME multi-équipes Combinaison de plusieurs des sources ci-dessus, avec un space par équipe si les périmètres ne se recoupent pas

3. Tester avant de généraliser

Avant de déployer un assistant à toute une équipe, posez vous-même une dizaine de questions
représentatives des besoins réels (pas des questions "faciles") et vérifiez :

  • que les citations pointent bien vers les bons documents (voir le guide sur les réponses sourcées) ;
  • que les réponses restent prudentes ("je ne trouve pas d'information sur ce sujet") plutôt que d'inventer une réponse quand aucun document pertinent n'existe ;
  • que le périmètre de documents connectés est suffisant — une lacune de contenu à ce stade se corrige facilement, une fois déployé auprès de plusieurs utilisateurs c'est plus coûteux à détecter.

4. Distribuer l'accès de façon contrôlée

Selon le cas d'usage :

  • Usage interne (chat) : invitez les membres de votre équipe sur le space concerné, avec le rôle adapté (lecture seule pour un usage de simple consultation, contribution si l'équipe doit aussi enrichir les sources).
  • Intégration externe (site web, outil support) : utilisez l'API (/query) avec un jeton dédié à cet usage, scopé au strict nécessaire (voir le guide sécurité).
  • Usage développeur (éditeur de code) : voir le guide MCP.

5. Suivre l'usage réel

Le tableau de bord d'utilisation (requêtes IA consommées, sources actives) permet de vérifier que
le plan choisi (voir le guide des plans) reste adapté à
l'usage réel, et d'identifier les questions fréquentes sans réponse satisfaisante — un bon
indicateur qu'un document devrait être ajouté ou clarifié.

Aller plus loin

Consultez les pages détaillées par cas d'usage pour des exemples concrets et un argumentaire
complet : documentation interne,
support client,
juridique,
freelances,
PME,
développeurs.