Parcours complet : du besoin client à la production

Ce tutoriel suit le parcours typique d'un BA affecté à un projet nAIxus. Il couvre toutes les étapes, du premier atelier client jusqu'à la mise en production du flow.

Scénario : Le service RH d'un grand compte veut un assistant interne pour répondre aux questions des collaborateurs sur les congés, le télétravail et les notes de frais. L'assistant sera accessible via Microsoft Teams.

Étape 1 : Recueil de besoin

Ce que vous devez obtenir du client

Livrables de cette étape

• Note de cadrage avec périmètre validé.
• Documents sources collectés.
• Canal de déploiement identifié et prérequis listés (ici : accès Azure AD pour le bot Teams).

Étape 2 : Vérifier la faisabilité

Ouvrez la matrice de capacités et vérifiez :

Pas de blocage. On peut avancer.

Si un besoin était en "limitation" (par exemple "SSO obligatoire"), il faudrait le signaler comme risque et négocier avec le client.

Étape 3 : Concevoir le flow

Choisir le pattern

En consultant le guide de conception de flows, le pattern branchement conditionnel est le plus adapté : l'agent analyse la question, et une condition gère le cas "hors périmètre".

Note : Ce scénario utilise un Agent car les questions sont en langage naturel et nécessitent de la compréhension sémantique. Pour un cas de routage par mots-clés ou catégories prédéfinies, un flow Condition → HTTP Request (sans Agent) suffirait. Consultez les cas d'usage pour d'autres patterns.

Dessiner le flow

Trigger from Channel (Teams) 
  → Agent (Assistant RH) 
    → Condition (dans le périmètre ?)
      → oui → Réponse à l'utilisateur
      → non → "Contactez rh@client.com pour cette question"

Ce que fait chaque node

Rédiger le prompt de l'agent

Rôle : Tu es l'assistant RH de [Entreprise]. Tu réponds aux questions 
des collaborateurs sur les congés, le télétravail et les notes de frais.

Contexte : Les collaborateurs te posent des questions via Teams. Tu te 
bases uniquement sur les documents de référence fournis (charte RH, 
politique télétravail, procédure notes de frais).

Instructions :
1. Réponds en français, de manière claire et concise.
2. Cite la source quand c'est possible ("Selon la charte RH, article 4...").
3. Si la question ne concerne pas les congés, le télétravail ou les notes 
   de frais, réponds exactement : "JE NE SAIS PAS".
4. Ne donne jamais d'informations sur les salaires, la paie ou les 
   données personnelles des autres collaborateurs.

Contraintes :
- Ne réponds qu'en te basant sur les documents fournis. Ne fabrique pas 
  d'informations.
- Si tu n'es pas sûr, dis-le. Ne devine pas.
- Format : réponse courte (3-5 phrases max), ton professionnel mais 
  accessible.

Astuce : Le marqueur "JE NE SAIS PAS" est une convention pour que la Condition puisse détecter facilement le cas hors périmètre. On aurait pu utiliser un JSON structuré à la place.

Étape 4 : Construire dans nAIxus

4.1 Créer le flow

1. Connectez-vous à nAIxus.
2. Cliquez sur + New Flow.
3. Nommez-le : "Assistant RH — [Client]".
4. Ajoutez une description : "Répond aux questions sur congés, télétravail, notes de frais via Teams."

4.2 Ajouter les nodes

1. Depuis la palette, glissez un Trigger from Channel sur le canvas.
2. Ajoutez un Agent. Connectez le Trigger à l'Agent.
3. Ajoutez une Condition. Connectez l'Agent à la Condition.
4. La Condition a deux sorties : connectez chacune à la suite du flow (réponse directe ou message de redirection).

4.3 Configurer l'Agent

1. Cliquez sur le node Agent.
2. Dans le panneau de droite :
   • Provider : OpenAI (ou le fournisseur configuré par l'admin).
   • Model : GPT-4o.
   • System Prompt : Collez le prompt rédigé à l'étape 3.
   • Temperature : 0.2 (réponses factuelles).

4.4 Configurer la Condition

1. Cliquez sur le node Condition.
2. Expression : vérifiez si la sortie de l'agent contient "JE NE SAIS PAS".

4.5 Renommer les nodes

Ne laissez pas les noms par défaut. Renommez :

• "Trigger from Channel" → "Message Teams"
• "Agent" → "Analyser question RH"
• "Condition" → "Dans le périmètre ?"

Étape 5 : Tester le flow

5.1 Test manuel (Trigger Manual)

Avant de brancher Teams, testez avec un Trigger Manual :

1. Remplacez temporairement le Trigger from Channel par un Trigger Manual.
2. Cliquez sur Run et saisissez : "Combien de jours de congés ai-je droit ?"
3. Vérifiez la réponse. Est-elle correcte ? Cite-t-elle la source ?

5.2 Tester les cas limites

5.3 Itérer sur le prompt

Si les résultats ne sont pas satisfaisants :

• Ajoutez des exemples dans le prompt (few-shot).
• Précisez les frontières ("congés inclut RTT et congés exceptionnels").
• Ajustez la temperature (baisser si les réponses sont trop créatives).

Pour un guide complet des tests, consultez le guide de test et validation.

Étape 6 : Configurer le canal

6.1 Créer le channel Teams

1. Dans nAIxus, allez dans Settings > Channels.
2. Cliquez sur + New Channel.
3. Sélectionnez Microsoft Teams.
4. Suivez les instructions pour connecter le bot Teams (nécessite un admin Azure AD côté client).

6.2 Lier le flow au channel

1. Dans le flow, remplacez le Trigger Manual par le Trigger from Channel.
2. Sélectionnez le channel Teams créé.

6.3 Tester dans Teams (environnement de dev)

1. Ouvrez Teams.
2. Trouvez le bot dans les contacts.
3. Envoyez un message de test.
4. Vérifiez que la réponse arrive correctement.

Étape 7 : Valider avec le client

Préparer la démo

• Préparez 5-10 questions types couvrant les différents cas.
• Montrez le cas nominal ET le cas hors périmètre.
• Montrez les sources citées dans les réponses.

Points à valider

Intégrer les retours

Après la démo, vous aurez probablement :

• Des ajustements de prompt (ton, périmètre, formulations).
• Des cas limites à gérer (nouvelles questions fréquentes).
• Des ajustements du message de redirection.

Modifiez le flow, retestez, et revalidez.

Étape 8 : Mise en production

Checklist pré-production

• Tous les cas de test passent.
• Le client a validé le comportement de l'assistant.
• Le canal Teams est configuré en environnement production.
• La clé API de production est utilisée (nx_live_).
• Les documents sources sont à jour.
• L'équipe support sait comment escalader si problème.

Déployer

1. Passez le channel de l'environnement staging vers production.
2. Vérifiez qu'un message envoyé en production obtient une réponse.
3. Communiquez aux collaborateurs la disponibilité de l'assistant.

Après la mise en production

Récapitulatif du parcours

Total typique : 1 à 2 semaines pour un cas d'usage simple comme une FAQ interne.