Mini-guide : Créer un agent thématique via le PIAG

📌 Prérequis

  1. Accès : Contacter le RSSI de votre structure pour obtenir les droits.
  2. Carte agent : Peut être requise pour l'authentification renforcée.
  3. Préparation : Rédiger une fiche de paramétrage (nom, public cible, périmètre, sources, modèle, outils, responsable maintenance).

🛠️ Étapes de création

1️⃣ Accéder à l'interface

  • Allez sur la page d'accueil du PIAG → menu déroulant en haut à droite, choisir "Agents thématiques".

Agent_them_menu

  • Cliquez sur le bouton "Créer un agent".

Agent_them_bouton


2️⃣ Paramétrer l'agent

Remplissez les champs obligatoires (marqués d'un astérisque *) :

Champ Recommandations
Données sensibles ? Oui si l'agent traite des données personnelles, internes ou confidentielles → Modèle Mistral imposé (pas de recherche web). ❌ Non pour des données publiques.
Intitulé Court, explicite, orienté usage (ex: "FAQ PIAG" plutôt que "Projet X-2026"). Éviter les acronymes non expliqués.
Description courte 255 caractères max. Préciser le public cible, le périmètre et les limites (ex: "Agent pour les agents du MTE. Hors périmètre : demandes d'habilitation.").
Description longue Documenter : périmètre, sources, limites, règles de mise à jour, contact pour maintenance.
Modèle Choisir en fonction du besoin :
- Mistral : Données sensibles (pas de recherche web).
- GPT-5.1/GPT-4.1 : Recherche web possible (cocher l'option).
- Claude/Perplexity : Pour des tâches complexes ou de la recherche sourcée.
Outils Activer uniquement ceux nécessaires (la liste varie selon le modèle choisi):
- ~~Génération d'images/fichiers~~ (non disponibles pour le moment)
- Recherche web (si modèle compatible)
- RAG (corpus documentaire)
Prompt système Structurer en blocs clairs :
```markdown
[Rôle] : "Tu es l'assistant {nom_agent} pour {public_cible} sur {sujet}."
[Périmètre] : "Tu réponds uniquement sur : {in_scope}. Hors périmètre : {out_scope} → redirige vers {contact}."
[Sources] : "Priorité : (1) {corpus_interne} ; (2) {web_sites_autorisés}. Si aucune source, dis-le explicitement."
[Qualité] : "Pour les dates/chiffres, cite la source et la date. En cas de doute, propose une vérification humaine."
[Format] : "Réponds en {format} : synthèse + références (liens/citations) + prochaines étapes si utile."
```
Logo Format : PNG/JPG (< 2 Mo). Visuel lisible en petite taille (éviter le texte).
Permissions Appliquer le principe du moindre privilège :
- Lecteur : Utilisateurs finaux.
- Contributeur : Personne chargée de mettre à jour les documents.
- Propriétaire : 1–2 personnes max (responsables fonctionnel + technique).
Corpus/RAG - Corpus mutualisé : Réutiliser une base existante (ex: fiches SPOTE).
- Documents joints : Ajouter des fichiers spécifiques à l'agent (PDF, DOCX, etc.). Limite : 25 Mo/fichier.
MCP (optionnel) Réservé aux intégrations techniques (ex: annuaire interne). À utiliser avec prudence (gouvernance SI requise).

3️⃣ Tester et publier

  1. Recette courte :
  2. Tester 10 questions (simples, ambigües, hors périmètre, sensibles).
  3. Vérifier : citations, redirections, gestion des limites.
  4. Maintenance :
  5. Désigner un responsable pour les mises à jour (prompt, corpus, permissions).
  6. Prévoir une fréquence de revue (mensuelle/trimestrielle).

💡 Bonnes pratiques (extraites du guide)

À faire

  • Cadrer le périmètre : Un agent = un sujet précis. Documenter ce qu'il ne traite pas.
  • Sources fiables :
  • Privilégier des documents validés, datés, versionnés.
  • Éviter les PDF scannés (non textuels) ou les brouillons.
  • Prompt clair :
  • Structurer en blocs (rôle, périmètre, sources, règles).
  • Imposer un comportement en cas d'incertitude (ex: "Dis 'Je ne sais pas' si aucune source n'est disponible").
  • Gouvernance :
  • Limiter les propriétaires à 1–2 personnes.
  • Documenter les règles de maintenance (qui, quand, comment).
  • Transparence :
  • L'agent doit citer ses sources (liens, titres, dates).
  • Indiquer clairement quand il redirige vers un humain (ex: "Contactez le service X pour ce sujet").

À éviter

  • Prompt trop long : Consignes redondantes ou contradictoires → l'agent devient imprévisible.
  • Corpus trop large : Documents hétérogènes/obsolètes → réponses incohérentes.
  • Droits trop larges :
  • Éviter de donner Contributeur à tout le monde.
  • Ne pas partager un agent avec des documents non diffusables à son public.
  • Oublier la maintenance : Un agent non mis à jour devient trompeur (ex: procédures périmées).
  • Ignorer les limites :
  • Ne pas utiliser l'agent pour des décisions humaines (ex: arbitrages juridiques).
  • Ne pas traiter de données sensibles (santé, carrière, conflits) sans cadre RSSI.

📎 Ressources utiles

Rappel

Un agent thématique n'est pas infaillible. Toujours relire et valider les réponses, surtout pour les dates, chiffres, ou références réglementaires.


Paramètres d’affichage

Choisissez un thème pour personnaliser l’apparence du site.