Corriger la grammaire et l’orthographe avec l’API Correcteur

L’API Correcteur d’épreuves est une API web expérimentale qui vous permet de corriger les erreurs de grammaire, d’orthographe et de ponctuation dans le texte à l’aide d’un petit modèle de langue (SLM) intégré à Microsoft Edge, à partir du code JavaScript de votre site web ou de votre extension de navigateur.

Pour plus d’informations sur l’API Proofreader, consultez Explication de l’API Proofreader.

Contenu détaillé :

Disponibilité de l’API Correcteur

L’API Correcteur est disponible en tant qu’aperçu développeur dans Microsoft Edge, à partir de la version 158. Vous pouvez tester l’API Correcteur localement dans Microsoft Edge, sur votre appareil uniquement. Voir Activer l’API Correcteur, ci-dessous.

L’API Correcteur d’épreuves est optimisée pour corriger les fautes de grammaire, d’orthographe et de ponctuation dans le contenu du texte. Pour en savoir plus sur une alternative à des scénarios d’ingénierie d’invite plus personnalisés qui peuvent ne pas être pris en charge par ces API, consultez Demander un modèle de langage intégré avec l’API d’invite.

Choisir l’API à utiliser

Pour tirer parti des fonctionnalités d’IA dans les sites web et les extensions de navigateur, vous pouvez également utiliser les méthodes suivantes :

L’API Proofreader utilise un petit modèle de langage (SLM) qui s’exécute sur le même appareil où les entrées et les sorties du modèle sont utilisées (c’est-à-dire localement). Cela présente les avantages suivants par rapport aux solutions basées sur le cloud :

  • Coût réduit : L’utilisation d’un service d’IA cloud n’implique aucun coût.

  • Indépendance du réseau : Au-delà du téléchargement initial du modèle, il n’y a pas de latence réseau lors de l’invite du modèle, et le modèle peut également être utilisé lorsque l’appareil est hors ligne.

  • Confidentialité améliorée : Les données entrées dans le modèle ne quittent jamais l’appareil et ne sont pas collectées (par exemple, pour entraîner des modèles IA).

L’API Correcteur utilise un modèle fourni par Microsoft Edge et intégré au navigateur, qui présente des avantages supplémentaires par rapport aux solutions locales personnalisées telles que celles basées sur WebGPU, WebNN ou WebAssembly :

  • Coût unique partagé : Le modèle fourni par le navigateur est téléchargé lorsque l’API est appelée pour la première fois, puis le modèle est partagé sur tous les sites web qui s’exécutent dans le navigateur, ce qui réduit les coûts réseau pour les développeurs et les utilisateurs.

  • Utilisation simplifiée pour les développeurs web : Le modèle intégré peut être exécuté à l’aide d’API web simples et ne nécessite pas d’expertise en IA/ML ni d’infrastructure tierce.

Modèle d’instruction d’Aion

Dans Microsoft Edge, l’API Proofreader utilise le modèle Aion Instruct, qui est intégré au navigateur. Aion Instruct est un petit modèle de langage à paramètres 2,3B qui excelle dans les tâches textuelles. Pour en savoir plus sur le modèle, voir la carte du modèle microsoft/Aion-1.0-Instruct-2.3B, à Hugging Face.

Clause d’exclusion de responsabilité

Comme d’autres modèles de langage de cette taille, Aion Instruct peut potentiellement se comporter de manière peu fiable, inexacte, injuste ou offensante. Vous devez prendre en compte les risques liés à la transmission de contenu non fiable au modèle et valider la source et l’intégrité du contenu avant d’utiliser le contenu comme entrée de modèle. Pour plus d’informations, consultez Biais, risques et limitations, dans microsoft/Aion-1.0-Instruct-2.3B, à Hugging Face.

Configuration matérielle requise

L’aperçu de l’API pour les développeurs Correcteur est destiné à fonctionner sur des appareils dotés de capacités matérielles qui produisent des sorties de modèle de langage compact (SLM) dont la qualité et la latence sont prévisibles.

L’API Correcteur a les exigences suivantes :

  • Systèmes d’exploitation :

    • Windows 10 ou 11.
    • macOS 13.3 ou version ultérieure.
    • 64 bits (x64) Linux avec pilotes GPU Vulkan et Microsoft Edge 159 ou version ultérieure.
  • Stockage : Au moins 20 Go disponibles sur le volume qui contient votre profil Edge. Si le stockage disponible tombe en dessous de 5 Go, le modèle est supprimé pour garantir que les autres fonctionnalités du navigateur disposent de suffisamment d’espace pour fonctionner.

  • GPU : 3 Go de VRAM ou plus.

  • Réseau : Forfait de données illimité ou connexion illimitée. Le modèle n’est pas téléchargé si vous utilisez une connexion limitée.

Pour case activée si votre appareil prend en charge l’aperçu du développeur de l’API Proofreader, consultez Activer l’API Proofreader ci-dessous et case activée la classe de performances de votre appareil.

En raison de la nature expérimentale de l’API Proofreader, vous pouvez observer des problèmes sur des configurations matérielles spécifiques. Si vous rencontrez des problèmes sur des configurations matérielles spécifiques, faites-nous part de vos commentaires en ouvrant un nouveau problème dans le référentiel MSEdgeExplainers.

Disponibilité du modèle Aion Instruct

Un téléchargement initial du modèle Aion Instruct est requis la première fois qu’un site Web appelle une API qui nécessite un modèle sur l’appareil. Pour surveiller le téléchargement du modèle, utilisez l’option lors de la monitor création d’une nouvelle session API Correcteur. Voir Suivre la progression du téléchargement du modèle, ci-dessous.

Le modèle n’est pas disponible dans les conditions suivantes :

  • Si l’option IA sur l’appareil est désactivée sous Paramètres>, Copilot et IA.
  • Si les stratégies d’entreprise GenAILocalFoundationalModelSettings ou ComponentUpdatesEnabled sont configurées pour bloquer le téléchargement du modèle.
  • Si l’appareil ne répond pas aux exigences matérielles, d’espace disque ou de réseau.

Considérations pour Edge Canary, Dev et Beta

Dans Microsoft Edge Canary, Dev et Beta, l’option IA sur l’appareil est désactivée par défaut sous Paramètres>Copilot et IA, afin d’éviter de télécharger le modèle séparément pour chaque canal.

Si vous activez l’indicateur d’API Correcteur dans edge://flags, l’option IA sur l’appareil est automatiquement activée dans Canary, Dev et Beta. Voir Activer l’API Correcteur, ci-dessous.

Activer l’API Correcteur

Pour utiliser l’API Correcteur dans Microsoft Edge :

  1. Vérifiez que vous utilisez Microsoft Edge version 158 ou ultérieure.

  2. Dans Microsoft Edge, ouvrez un nouvel onglet ou une nouvelle fenêtre, puis accédez à edge://flags.

  3. Dans la zone de recherche, en haut de la page, entrez API Proofreader.

    La page est filtrée pour afficher l’indicateur correspondant.

  4. Sélectionnez Activé en regard de l’indicateur d’API Correcteur d’épreuves :

    Page Indicateurs du navigateur

  5. Si vous le souhaitez, pour enregistrer localement les informations qui peuvent être utiles pour les problèmes de débogage, activez également l’indicateur Activer sur l’appareil les journaux de débogage du modèle IA .

  6. Redémarrez Microsoft Edge.

  7. Pour case activée si votre appareil répond à la configuration matérielle requise pour l’aperçu du développeur d’API Correcteur, ouvrez un nouvel onglet, accédez à edge://on-device-internals, puis case activée la valeur de classe de performances de l’appareil.

    Si la classe de performances de votre appareil est Moyenne ou supérieure, l’API Correcteur devrait être prise en charge sur votre appareil. Si vous continuez à remarquer des problèmes, veuillez créer un nouveau problème.

Voir un exemple fonctionnel

Pour voir l’API Correcteur en action et examiner le code existant qui utilise ces API :

  1. Activez l’API Correcteur, comme décrit ci-dessus.

  2. Dans Microsoft Edge, ouvrez un onglet ou une fenêtre et accédez au terrain de jeu API Correcteur.

  3. Dans la bannière d’informations située en haut, vérifiez la case activée sur le status. Le status initial indique API sur l’appareil et téléchargement de modèle :

    Indicateur d’état indiquant la progression du téléchargement du modèle

    Une fois le modèle téléchargé, la bannière d’informations indique API sur l’appareil et modèle disponibles, indiquant que l’API et le modèle peuvent être utilisés :

    Bannière d’informations affichant le message : API sur l’appareil et modèle prêt.

    Si le modèle ne démarre pas le téléchargement, redémarrez Microsoft Edge et réessayez.

    L’API Correcteur d’épreuves est uniquement prise en charge sur les appareils qui répondent à certaines configurations matérielles requises. Pour plus d’informations, consultez la section Configuration matérielle requise ci-dessus.

  4. Si vous le souhaitez, modifiez le contenu et les paramètres de la page. Par exemple, modifiez le texte à relire ou modifiez la langue d’entrée attendue.

  5. Cliquez sur le bouton Relire en bas de la page.

    La sortie est générée dans la section de réponse de la page :

    La page de démonstration du correcteur, contenant les paramètres et un bouton Relire

Voir aussi :

  • /built-in-ai/ - Lisez-moi et code source pour la démo des terrains de jeu IA intégrés.

Utiliser l’API du correcteur d’épreuves

Vérifier si l’API est activée

Avant d’utiliser l’API Correcteur dans le code de votre site web, case activée que l’API est activée, en testant la présence de l’objet Proofreader :

if (!Proofreader) {
  // The Proofreader API is not available.
}

Vérifier si le modèle peut être utilisé

L’API de correction d’épreuves ne peut être utilisée que si l’appareil prend en charge l’exécution du modèle, et après téléchargement du modèle de langage et de l’environnement d’exécution du modèle par Microsoft Edge.

Pour case activée si l’API peut être utilisée, utilisez la méthode :availability()

const availability = await Proofreader.availability();

if (availability == "unavailable") {
  // The model is not available.
}

if (availability == "downloadable" || availability == "downloading") {
  // The model can be used, but it needs to be downloaded first.
}

if (availability == "available") {
  // The model is available and can be used.
}

Créer une session

La création d’une session indique au navigateur de charger le modèle de langage en mémoire afin qu’il puisse être utilisé. Avant de pouvoir utiliser l’API Correcteur pour corriger le texte, créez une session à l’aide de la create() méthode :

// Create a Proofreader session.
const session = await Proofreader.create();

Pour personnaliser la session de modèle, vous pouvez transmettre des options à la create() méthode :

// Create a Proofreader session with options.
const session = await Proofreader.create(options);

Les options disponibles sont répertoriées ci-dessous :

Option Description
monitor Fonction utilisée pour surveiller la progression du téléchargement du modèle. Voir Suivre la progression du téléchargement du modèle, ci-dessous.
expectedInputLanguages Tableau de chaînes de caractères. Chaque chaîne est une langue que le texte d’entrée est censé contenir. Par exemple : ["en", "es"].
Surveiller la progression du téléchargement du modèle

Pour suivre la progression du téléchargement du modèle, utilisez l’option monitor . Ceci est utile lorsque le modèle n’a pas encore été entièrement téléchargé sur l’appareil sur lequel le modèle sera utilisé, pour informer les utilisateurs de votre site web qu’ils doivent attendre.

// Create a Proofreader session with the monitor option to monitor the model
// download.
const session = await Proofreader.create({
  monitor: m => {
    // Use the monitor object argument to add an listener for the
    // downloadprogress event.
    m.addEventListener("downloadprogress", event => {
      // The event is an object with the loaded and total properties.
      if (event.loaded == event.total) {
        // The model is fully downloaded.
      } else {
        // The model is still downloading.
        const percentageComplete = (event.loaded / event.total) * 100;
      }
    });
  }
});

Exécuter l’API du correcteur d’épreuves

Pour générer du texte révisé à l’aide de l’API Correcteur, après avoir créé la session de modèle correspondante, utilisez la session.proofread() méthode. Cette méthode retourne une promesse qui se résout une fois que l’API Correcteur a fini de générer le texte corrigé.

// Create a Proofreader session.
const session = await Proofreader.create();

// Correct the text and wait for the result.
const result = await session.proofread(textToBeCorrected);

// Use the result.
console.log(result);

Utiliser le résultat de l’API Correcteur

La session.proofread() méthode retourne une promesse qui se résout dans un objet qui a les propriétés suivantes :

Propriété Description
correctedInput Texte corrigé, sous forme de chaîne.
corrections Tableau d’objets de correction.

Un objet de correction a les propriétés suivantes :

Propriété Description
startIndex Index du premier caractère corrigé dans le texte d’entrée.
endIndex Index du dernier caractère corrigé dans le texte d’entrée.
correction La chaîne qui remplace le texte incorrect.

L’exemple suivant montre comment utiliser le résultat de la session.proofread() méthode :

// Create a Proofreader session.
const session = await Proofreader.create();

// Correct the text and wait for the result.
const result = await session.proofread(textToBeCorrected);

// Log the corrected text.
console.log("Corrected text:", result.correctedInput);

// Log each correction.
result.corrections.forEach(({ startIndex, endIndex, correction }) => {
  const initialText = textToBeCorrected.slice(startIndex, endIndex);
  console.log(`Replaced text "${initialText}" (index ${startIndex} to ${endIndex}) with "${correction}"`);
});

Détruire une session

Détruisez la session pour faire savoir au navigateur que vous n’avez plus besoin du modèle de langage, afin que le modèle puisse être déchargé de la mémoire.

Vous pouvez détruire une session de deux manières différentes :

  • En utilisant la destroy() méthode.
  • En utilisant un AbortControllerfichier .
Détruire une session en utilisant la méthode destroy()

Vous pouvez utiliser la méthode pour détruire une session de correction d’épreuves session.destroy() :

const session = await Proofreader.create();

// Later, destroy the session by using the destroy method.
session.destroy();
Détruire une session à l’aide d’un AbortController

Alternativement, vous pouvez créer un AbortController objet, créer une Proofreader session, puis appeler abort():

// Create an AbortController object.
const controller = new AbortController();

// Create a Proofreader session and pass the
// AbortController signal object by using the signal option.
const session = await Proofreader.create({ signal: controller.signal });

// Later, such as when the user interacts with the UI, destroy the session by
// calling the abort() function of the AbortController object.
controller.abort();

Envoyer des commentaires

Nous sommes très intéressés par la gamme de scénarios pour lesquels vous envisagez d’utiliser l’API Proofreader, les problèmes éventuels avec l’API ou le modèle de langage, et si de nouvelles API spécifiques à une tâche seraient utiles.

Pour envoyer des commentaires sur vos scénarios et les tâches que vous souhaitez accomplir, ajoutez un commentaire au problème de commentaires de l’API Correcteur.

Si vous remarquez des problèmes lors de l’utilisation de l’API à la place, signalez-les sur le dépôt.

Vous pouvez également contribuer à la discussion sur la conception de l’API Proofreader au dépôt du groupe de travail Web Machine Learning du W3C.

Voir aussi