Rédiger des réponses par e-mail assistées par l'IA avec Hugging Face

Obtenez votre clé numérique (jeton API)

Tout d'abord, obtenons votre clé numérique unique, appelée jeton API. Une API (Application Programming Interface) est comme le menu numérique et le système de commande d'un restaurant, permettant à différents programmes informatiques de communiquer entre eux. Votre jeton API est comme votre passe VIP personnel et secret qui indique au « serveur » de Hugging Face (l'API) que vous êtes autorisé à passer une commande.

Ouvrez votre navigateur web et rendez-vous sur le site de Hugging Face. Connectez-vous à votre compte. Une fois connecté, vous verrez généralement une page épurée, peut-être avec votre fil d'activités. Recherchez votre photo de profil (généralement un cercle avec votre initiale ou une image choisie) dans le coin supérieur droit de l'écran. Cliquez dessus. Un menu coulissera ou s'ouvrira, affichant des options comme « Profil », « Paramètres » et « Se déconnecter ». Sélectionnez « Paramètres » dans ce menu. Sur l'écran suivant, vous verrez une barre latérale à gauche avec divers paramètres de compte. Cliquez sur « Jetons d'accès ». Vous verrez alors un bouton indiquant « Nouveau jeton ». Cliquez dessus. Une petite fenêtre apparaîtra, demandant des détails. Donnez un nom descriptif à votre jeton, comme « Email-Reply-Bot », et définissez le Rôle sur « lecture ». Ce rôle de « lecture » signifie que le jeton vous permet uniquement de recevoir des informations (comme du texte généré par l'IA), et non de modifier quoi que ce soit sur votre compte. Cliquez sur « Générer un jeton ». Une très longue chaîne de caractères aléatoires (votre jeton API) apparaîtra à l'écran. Copiez immédiatement ce jeton ! Vous pouvez cliquer sur l'icône de copie à côté. Traitez ce jeton comme un mot de passe – vous ne le verrez plus une fois que vous quitterez cette page. Enregistrez-le temporairement dans un endroit sûr, comme un simple document texte, car vous en aurez bientôt besoin.

Si cela semble différent : Si votre photo de profil n'est pas en haut à droite, recherchez une icône de compte générale (comme une silhouette de personne) ou un bouton de menu (souvent trois lignes horizontales, parfois appelé « menu hamburger »). Les « Paramètres » ou « Jetons d'accès » peuvent avoir des noms légèrement différents mais se trouveront généralement dans la zone de gestion de votre compte.

Vous saurez que cela a fonctionné lorsque vous aurez copié avec succès une longue chaîne de caractères commençant par hf_ (par exemple, hf_ABCDEF1234567890) et que vous l'aurez enregistrée en toute sécurité.

Trouvez un « Chef » IA (Modèle) pour votre e-mail

Maintenant, vous devez choisir un modèle d'IA, ce qui est comme sélectionner un chef spécifique pour votre repas. Chaque modèle est un programme informatique unique entraîné pour différentes tâches. Pour la rédaction d'e-mails, vous voudrez un modèle de « génération de texte » – un modèle spécifiquement conçu pour produire de nouveaux textes basés sur vos instructions.

Ouvrez un nouvel onglet de navigateur et accédez au Hugging Face Hub. Sur cette page, vous verrez une barre de recherche proéminente, généralement au milieu ou près du haut. Dans cette barre de recherche, tapez text-generation. Au fur et à mesure que vous tapez, une liste de modèles pourrait apparaître, ou vous pourriez avoir besoin d'appuyer sur Entrée pour voir les résultats. Vous verrez alors de nombreux modèles d'IA différents. Pour un débutant, un bon point de départ est gpt2 car il est bien connu et généralement efficace pour diverses tâches textuelles. Vous pourriez également voir distilgpt2 (une version plus petite et plus rapide) ou microsoft/DialoGPT-medium. Cliquez sur le modèle que vous avez choisi (par exemple, cliquez sur la carte du modèle gpt2). Sur la page spécifique du modèle, tout en haut, vous verrez son ID de modèle. Pour gpt2, l'ID de modèle est simplement gpt2. Notez cet ID de modèle – vous en aurez besoin pour l'étape suivante.

Si cela semble différent : Si text-generation ne donne pas de bons résultats, essayez de chercher des filtres sur le côté gauche de la page et sélectionnez « Génération de texte » sous « Tâches ». Les modèles les plus populaires sont souvent listés en premier ou clairement étiquetés.

Vous saurez que cela a fonctionné lorsque vous aurez noté avec succès l'ID de modèle (par exemple, gpt2) du modèle d'IA de génération de texte que vous avez choisi.

Préparez votre « Commande » (Requête API)

Maintenant, vous allez élaborer l'instruction spécifique que vous souhaitez envoyer à l'IA. Cette instruction est appelée un prompt. Vous combinerez votre jeton API, l'ID du modèle et votre prompt en une commande à l'aide d'un outil appelé curl (prononcé « keurl »). curl est un moyen courant d'envoyer des requêtes depuis le terminal de votre ordinateur vers des services web comme l'API de Hugging Face.

Ouvrez le terminal de votre ordinateur. Sous Windows, vous pouvez rechercher « Invite de commande » ou « PowerShell » dans le menu Démarrer. Sous Mac ou Linux, recherchez « Terminal ». Une fois ouvert, vous verrez une fenêtre avec un curseur clignotant, prête à recevoir votre saisie. Nous utiliserons une commande curl, qui est une ligne de code spécifique qui envoie votre requête. Votre commande inclura :

• -X POST : Cela indique à Hugging Face que vous envoyez des données (comme passer une commande).
• -H "Authorization: Bearer YOUR_API_TOKEN" : Cela inclut votre passe VIP (jeton API) pour confirmer que vous êtes autorisé à faire la requête.
• -H "Content-Type: application/json" : Cela indique à Hugging Face que vous envoyez des informations au format JSON (JavaScript Object Notation), qui est une manière structurée pour les programmes informatiques d'échanger des données.
• -d '{ "inputs": "YOUR PROMPT", "parameters": { "max_new_tokens": 50, "return_full_text": false } }' : Ce sont les données réelles que vous envoyez. "inputs" contient votre prompt (l'instruction pour l'IA). "parameters" sont des instructions supplémentaires, comme "max_new_tokens": 50 (demandant environ 50 nouvelles pièces de texte, appelées jetons – un jeton correspond à environ quatre caractères) et "return_full_text": false (ce qui garantit que l'IA ne renvoie que sa réponse générée, et non votre prompt original).
• https://api-inference.huggingface.co/models/YOUR_MODEL_ID : C'est l'adresse web de la « cuisine » de l'IA où votre modèle choisi attend.

Vous devez remplacer YOUR_API_TOKEN par votre véritable jeton de l'Étape 1 et YOUR_MODEL_ID par l'ID de modèle de l'Étape 2.

Si cela semble différent : Assurez-vous que votre terminal est prêt à accepter des commandes. Certains réseaux d'entreprise pourraient bloquer les commandes curl. Si vous rencontrez des erreurs comme « commande introuvable », vous pourriez devoir contacter votre service informatique ou essayer un autre ordinateur.

Vous saurez que cela a fonctionné lorsque vous aurez une chaîne de commande curl complète (comme l'exemple ci-dessous) qui inclut votre jeton API réel et l'ID du modèle choisi, prête à être copiée et collée dans votre terminal.

curl -X POST \
  -H "Authorization: Bearer hf_YOURUNIQUEKEY123" \
  -H "Content-Type: application/json" \
  -d '{ "inputs": "Le client est mécontent du service et souhaite un remboursement. Rédigez une réponse polie et empathique.", "parameters": { "max_new_tokens": 80, "return_full_text": false } }' \
  https://api-inference.huggingface.co/models/gpt2

Envoyez votre commande à la « Cuisine » de l'IA

Avec votre commande curl complète prête, il est temps de l'envoyer. Copiez soigneusement toute la commande, y compris curl au début et l'URL du modèle à la fin. Ensuite, retournez à votre fenêtre de terminal ouverte.

Collez toute la commande curl dans la fenêtre du terminal au niveau du curseur clignotant. Après avoir collé, appuyez sur la touche Entrée de votre clavier. Ce qui se passe ensuite, c'est que votre ordinateur envoie cette requête via internet à Hugging Face. L'IA traitera ensuite votre requête – ce processus est appelé inférence. Cela pourrait prendre quelques secondes, surtout la première fois que vous utilisez un modèle spécifique ou si Hugging Face doit « charger » le modèle sur ses serveurs pour vous. La fenêtre du terminal restera généralement vide pendant un court instant en attendant une réponse.

Si cela semble différent : Si rien ne se passe pendant une longue période (plus de 20-30 secondes), ou si vous voyez une erreur immédiate comme « Connexion refusée », vérifiez votre connexion internet et assurez-vous que votre commande curl est exactement telle qu'écrite, sans guillemets ni caractères manquants. Une réponse lente pourrait simplement signifier que le modèle prend un moment à charger.

Vous saurez que cela a fonctionné lorsque, après une courte attente, la fenêtre du terminal affichera un nouveau texte. Ce texte commencera généralement par un crochet ouvrant [ ou une accolade ouvrante {, indiquant que des données ont été reçues.

Lisez la « Réponse » de l'IA (Brouillon d'e-mail)

Après une courte attente, vous verrez du texte apparaître dans votre terminal. Ce sera au format JSON (JavaScript Object Notation), qui est une manière standard et organisée pour les programmes de s'échanger des données. Cela peut sembler un peu complexe au début, mais ne vous inquiétez pas – vous recherchez une partie spécifique.

La sortie JSON affichera typiquement une liste (indiquée par []) contenant un ou plusieurs objets (indiqués par {}). À l'intérieur de l'un de ces objets, vous trouverez la clé "generated_text". Le texte suivant immédiatement cette clé, entre guillemets, est votre réponse d'e-mail rédigée par l'IA. Par exemple, vous pourriez voir quelque chose comme \"generated_text\": \"Cher [Nom du client],\\n\\nMerci de nous avoir contactés...\" (le \n signifie un saut de ligne, et \\ signifie un seul caractère \). Lisez ce texte généré. Vous pouvez surligner et copier le texte à l'intérieur des guillemets après "generated_text".

Si cela semble différent : Si vous voyez des messages d'erreur au lieu du JSON, revenez en arrière et vérifiez attentivement l'Étape 3 pour les fautes de frappe dans votre jeton API, l'ID du modèle ou la structure des données JSON (surtout les guillemets). Parfois, un max_new_tokens très court peut entraîner une réponse très brève ou incomplète.

Vous saurez que cela a fonctionné lorsque vous pourrez clairement identifier et copier le texte de l'e-mail généré par l'IA dans la section \"generated_text\": de la sortie du terminal. Vous pouvez ensuite coller ce texte dans votre programme d'e-mail, le personnaliser avec des noms, des détails spécifiques et la voix de votre marque, car l'IA ne fournit qu'un brouillon général.