Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Un prompting efficace consiste à donner des instructions claires à un assistant capable. Guidez bien Agent et vous passerez de l’idée à l’application rapidement.

Exemples rapides

Voyez la différence entre des invites vagues et des invites efficaces :
Vague : « Corrige mon code. »Efficace : « Mon script échoue lors du traitement des entrées utilisateur. L’erreur semble se trouver dans la fonction de validation. Peux-tu aider à déboguer la partie validate_input ? Voici le message d’erreur : [détails] »L’invite efficace identifie la zone du problème, la fonction suspectée et fournit du contexte.
Vague : « Crée un site web. »Efficace : « Crée un simple site portfolio avec des sections pour Accueil, À propos de moi et Formulaire de contact. Utilise un thème de design épuré et moderne avec du contenu d’exemple. »L’invite efficace définit l’objectif, les fonctionnalités principales et l’esthétique souhaitée.
Vague : « Ne le rends pas lent. »Efficace : « Refactorise la fonction de traitement des données pour gérer des entrées plus importantes de manière plus efficace. Pourrait-on utiliser un algorithme ou une structure de données différente ? »Dis à Agent comment améliorer plutôt que d’utiliser des contraintes négatives.
Vague : « Ajoute une animation. »Efficace : « Anime l’image principale de la page d’accueil pour qu’elle apparaisse en fondu doucement au premier chargement de la page, afin de créer un effet accueillant. »Identifie l’élément spécifique, l’effet souhaité, le timing et l’expérience visée.
Vague : « Construis le backend. »Efficace : « Configure la logique côté serveur. Implémente l’authentification utilisateur (inscription/connexion) et crée un endpoint API pour récupérer les données du profil utilisateur de manière sécurisée. »Décompose les grandes tâches en fonctionnalités spécifiques.

Principes fondamentaux

Dix conseils pour un prompting efficace avec Replit Agent

Planifiez d’abord

Avant de faire une invite, décrivez les fonctionnalités et les parcours utilisateur de votre application. Un plan clair conduit à des invites plus ciblées.
Réfléchissez à la structure de votre application comme le ferait un chef de produit. Décomposez l’objectif global en étapes logiques. Au lieu de : « Construis une application de gestion de tâches. » Essayez : « 1. Crée la structure HTML de base avec un champ de saisie et une liste de tâches. 2. Ajoute du JavaScript pour ajouter des tâches. 3. Utilise une base de données pour stocker les tâches. 4. Ajoute la fonctionnalité pour marquer les tâches comme terminées. » Ensuite, faites une invite à Agent pour chaque étape.

Construisez de manière incrémentale

Utilisez les Points de contrôle pour sauvegarder la progression après chaque étape réussie. Si quelque chose se casse, vous pouvez revenir à un état fonctionnel et essayer une approche différente. Au lieu de : « Construis une plateforme e-commerce complète. » Essayez : « Configure un projet full-stack de base pour un site e-commerce avec inscription et connexion utilisateur en utilisant Replit Auth. » Puis enchaînez avec des invites pour les listes de produits, le panier et le paiement.

Soyez précis

Définissez exactement ce dont vous avez besoin : formats de sortie, contraintes, cas particuliers. Au lieu de : « Ajoute un formulaire de contact. » Essayez : « Crée une page de formulaire de contact à /contact avec des champs pour :
  • Nom (obligatoire)
  • Email (obligatoire, doit être dans un format valide)
  • Message (obligatoire, minimum 10 caractères)
À la soumission, envoie les données du formulaire à contact@mondomaine.com. »

Utilisez un langage positif

Dites ce que vous voulez, pas ce qu’il faut éviter. Au lieu de : « Ne rends pas la page de profil utilisateur confuse. » Essayez : « Conçois une page de profil utilisateur épurée. Affiche le nom d’utilisateur en évidence, suivi de l’email et de la date d’inscription. Inclus un bouton “Modifier le profil”. »

Restez simple

Utilisez un langage clair et direct. Décomposez les demandes complexes en points. Au lieu de : « Implémente l’infrastructure côté serveur nécessaire pour faciliter la génération dynamique et la récupération d’artefacts de contenu générés par les utilisateurs. » Essayez : « Crée une fonctionnalité backend pour que les utilisateurs puissent soumettre des articles de blog. Les utilisateurs doivent saisir un titre et le corps du contenu. Stocke les articles dans la base de données. »

Travailler avec le contexte

Fournissez les fichiers pertinents

Mentionnez des fichiers spécifiques plutôt que de joindre tout votre projet. Au lieu de : (Joindre tout) « Implémente la page de profil utilisateur en te basant sur notre système de design. » Essayez : « Crée la page de profil utilisateur. Récupère les données utilisateur depuis l’endpoint du serveur. Stylise selon [URL vers les docs de design] et reproduis cette maquette : [joindre profile_mockup.jpg]. »
Commencez une nouvelle conversation lorsque vous passez à des tâches sans rapport. Cela évite la confusion due au contexte accumulé.

Montrez des exemples

Réduisez l’ambiguïté en fournissant des exemples concrets — extraits de code, données d’exemple ou captures d’écran. Au lieu de : « Améliore l’apparence des cartes produit. » Essayez : « Repense les cartes produit sur la page boutique. Chaque carte doit afficher l’image du produit, le nom, le prix et un bouton “Ajouter au panier”, similaire à cette mise en page : [joindre capture d’écran]. Utilise une bordure gris clair. »

Déboguer efficacement

Lorsque des erreurs surviennent, fournissez :
  • Le message d’erreur exact
  • Les extraits de code pertinents
  • Les noms des fichiers où l’erreur se produit
  • Ce que vous essayiez d’accomplir
  • Les étapes que vous avez déjà essayées
Au lieu de : « Ma page de connexion est cassée. » Essayez : « Lorsque je me connecte avec les bons identifiants sur /login, j’obtiens une erreur “Utilisateur introuvable” dans la console du navigateur. La vérification de la base de données ne semble pas fonctionner. Voici le code de gestion de la connexion dans auth.js. »

Demandez des conseils

Passez en mode Plan pour explorer les options avant de construire. Demandez à Agent des bibliothèques, des approches et des compromis.
Au lieu de : « Ajoute des paiements. » Essayez : « Quelles sont les bonnes options pour accepter des paiements par carte bancaire dans une application web construite sur Replit ? J’ai besoin de quelque chose de relativement simple à intégrer. »

Itérez sur vos invites

Votre première invite n’est peut-être pas parfaite — c’est normal. Si le résultat n’est pas bon :
  • Ajoutez plus de détails
  • Fournissez un exemple
  • Simplifiez l’instruction
  • Essayez une autre façon d’expliquer
Initial : « Crée un en-tête pour mon site web. » Affiné : « Crée un composant d’en-tête fixe avec le logo du site à gauche et des liens de navigation (Accueil, À propos, Contact) à droite. »

Résumé

Un prompting efficace se résume à :
  • Planifier avant de faire une invite
  • Construire de manière incrémentale avec les Points de contrôle
  • Être précis sur les exigences
  • Fournir du contexte via des exemples et des fichiers pertinents
  • Itérer lorsque les résultats ne sont pas tout à fait bons
Maîtrisez ces principes et vous construirez des applications plus rapidement avec Agent.