Réutiliser les prompts

Points d'accès

Fichiers statiques, régénérés à chaque publication du site. Requête GET, sans en-tête particulier ; les appels depuis un navigateur sont autorisés (CORS ouvert).

Ce que contient chaque module

• role, context, task, constraints, output_format — le prompt, champ par champ
• variables — les {…} à remplacer par vos valeurs
• content_fields — ce que votre utilisateur doit fournir (texte source, activité…)
• assembled.system / assembled.user — le prompt monté, prêt à envoyer, charte de rédaction accessible incluse
• prompt_version — à surveiller pour vous resynchroniser

{
  "slug": "falc",
  "name": "FALC — Facile à Lire et à Comprendre",
  "prompt_version": "1.3.0",
  "role": "Enseignant spécialisé, expert en adaptation FALC…",
  "context": "Texte de {discipline}, niveau {niveau}. Profil de l'élève : {profil}",
  "task": "Réécris ce texte en version FALC…",
  "constraints": ["Phrases : une seule information ou une seule idée par phrase, 15 mots au maximum…"],
  "output_format": "Deux parties nettement séparées par un titre de niveau 2 (##)…",
  "variables": ["discipline", "niveau", "profil", "contraintes_additionnelles"],
  "content_fields": [{ "key": "sourceText", "label": "Texte source" }],
  "assembled": { "system": "Tu es …", "user": "…" }
}

Mise en œuvre

Trois étapes, sans dépendance à installer : récupérer, remplacer, envoyer.

// Exemple complet : adapter un texte en FALC avec l'IA de votre choix.
const valeurs = { niveau: 'CM2', discipline: 'Sciences', profil: 'Troubles cognitifs' };
const contenu = "La photosynthèse est le processus par lequel les plantes…";

// 1. Récupérer le prompt
const r = await fetch('https://inclusia.forge.apps.education.fr/api/prompts/falc.json');
const p = await r.json();

// 2. Remplacer les variables {…}, puis le marqueur [à compléter]
const remplir = (s) => s.replace(/\{(\w+)\}/g, (_, k) => valeurs[k] ?? '');
const system = remplir(p.assembled.system);
const user = remplir(p.assembled.user).replace('[à compléter]', contenu);

// 3. Appeler votre modèle (ici, une API compatible OpenAI)
const reponse = await fetch('https://VOTRE-FOURNISSEUR/v1/chat/completions', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', Authorization: 'Bearer VOTRE_CLE' },
  body: JSON.stringify({
    model: 'VOTRE_MODELE',
    messages: [{ role: 'system', content: system }, { role: 'user', content: user }],
  }),
});

const resultat = (await reponse.json()).choices[0].message.content;  // markdown
console.log(p.prompt_version);  // « 1.3.0 » — à stocker avec le résultat

Intègre les prompts d'Inclus'IA dans mon application.

Catalogue complet : https://inclusia.forge.apps.education.fr/prompts.json
Un seul module    : https://inclusia.forge.apps.education.fr/api/prompts/<slug>.json
Résumé machine    : https://inclusia.forge.apps.education.fr/llms.txt

Contrat du JSON, à respecter tel quel :
- « assembled.system » et « assembled.user » sont le prompt déjà monté. Envoie-les
  tels quels à un modèle de chat, dans les rôles system et user. Ne les reformule pas,
  ne les résume pas, n'ajoute pas d'instructions : ils contiennent déjà les règles
  pédagogiques et une charte de rédaction accessible.
- « variables » liste des clés qui apparaissent dans le texte sous la forme {cle} ;
  remplace chacune par la valeur saisie par l'utilisateur (une valeur multiple se
  joint par « , »). Une variable sans valeur se remplace par une chaîne vide.
- « content_fields » liste les contenus à fournir ; dans assembled.user, chacun
  apparaît sous la forme « <label> :[saut de ligne][à compléter] ». Remplace le
  marqueur [à compléter] par le contenu réel.
- « prompt_version » est la version sémantique du prompt : stocke-la avec chaque
  résultat produit, et compare-la au démarrage pour détecter une mise à jour.

Ce que je veux :
1. une fonction chargerPrompt(slug) avec un cache mémoire ;
2. une fonction construirePrompt(slug, valeurs, contenu) qui renvoie { system, user } ;
3. l'appel à mon fournisseur d'IA, le résultat étant du markdown à rendre tel quel.

Contraintes d'interface, non négociables :
- rappeler à l'utilisateur de ne saisir aucune donnée personnelle d'élève
  (nom, prénom, initiales, date de naissance, adresse, INE) ;
- présenter le résultat comme un point de départ à relire, jamais comme un
  document prêt à distribuer ;
- citer « Inclus'IA » avec un lien vers https://inclusia.forge.apps.education.fr
  (licence CC BY-SA 4.0).

Versions

Chaque prompt porte un numéro de version sémantique. C'est le contrat sur lequel vous pouvez compter :

Une version majeure peut casser votre intégration : comparez prompt_version avant de vous resynchroniser. Chaque évolution est détaillée dans le journal des modifications du dépôt.

Modules disponibles

Les 20 prompts, avec leur version et le champ que votre utilisateur doit obligatoirement fournir.