IBM Bob est un assistant de programmation et de technologie, mais Bob ne peut pas lire dans tes pensées. Bob dépend de tes instructions pour produire de bons résultats. Apprendre les bases de l'écriture de prompts améliore ton expérience avec Bob, te fait gagner du temps et te donne ce que tu veux.

Qu'est-ce qu'un prompt ?

Un prompt est un ensemble d'instructions que tu donnes à Bob pour obtenir l'output souhaité. Un prompt peut être une question, une demande ou une commande. Il peut être aussi simple que "Quelle est la capitale de la France ?" ou aussi complexe que "Écris une fonction Python qui prend une liste de nombres et renvoie la moyenne."

Pense au principe de développement logiciel "garbage in, garbage out". Si tu donnes à Bob un prompt vague ou incomplet, tu obtiendras peut-être une réponse vague ou incomplète.

Quand tu écris des prompts de meilleure qualité, tu obtiens des réponses de meilleure qualité. Un bon prompt est clair, spécifique et fournit suffisamment de contexte pour que Bob comprenne ce que tu veux.

Composants d'un prompt

Pour écrire un prompt efficace, tu dois inclure les composants suivants :

Instruction : Indique à Bob quelle tâche effectuer. L'instruction est rédigée comme une commande claire, par exemple "Résume cette fonction Python" ou "Génère un SBOM pour cette API." Des instructions solides réduisent l'ambiguïté et mènent à des résultats plus pertinents.

Rôle : Assigne à Bob un rôle ou un persona spécifique à adopter lors de la génération de la réponse. Par exemple, tu pourrais dire "Tu es un ingénieur logiciel senior avec une expertise en Python." Cela aide Bob à adapter sa réponse à la perspective de ce rôle.

Contexte : Le contexte fournit des informations supplémentaires ou des détails qui façonnent la réponse de Bob. Le contexte peut inclure une description de la situation, le ton, le public ou les informations clés que tu veux intégrer. Le contexte aide Bob à rester aligné sur la tâche.

Exemple : Les exemples comprennent un ou plusieurs exemples qui démontrent le modèle, le format ou le ton souhaité. Fournir des exemples est particulièrement utile lorsque tu veux que l'output suive un style ou une structure spécifique. Les exemples aident Bob à interpréter ce que signifie une bonne réponse.

Indices : Un indice est un court fragment de texte qui introduit le type de réponse que tu veux. Les indices sont souvent placés à la fin du prompt pour orienter la génération de l'output de Bob dans la bonne direction.

Au fur et à mesure que tu affines tes compétences en écriture de prompts, tu peux sauvegarder tes prompts dans un fichier pour les réutiliser et les partager avec ton équipe.

Bonnes pratiques pour les prompts

Les bonnes pratiques suivantes peuvent t'aider à écrire des prompts efficaces pour Bob.

Sois spécifique : Plus ton prompt est spécifique, mieux Bob peut comprendre ce que tu veux. Au lieu de demander "Comment écrire une fonction Python ?", demande "Comment écrire une fonction Python qui prend une liste de nombres et renvoie la moyenne ?"

Fournis du contexte : Si ton prompt concerne un projet ou une base de code spécifique, fournis du contexte à ce sujet. Cela aide Bob à générer une réponse pertinente pour ta situation. Utilise les mentions de contexte @ de Bob pour référencer des fichiers spécifiques.

Décompose les tâches : Comme tu le ferais en affinant une tâche dans ton backlog, décompose les tâches complexes en étapes plus petites et plus gérables. Cela peut aider Bob à générer des réponses plus précises et ciblées.

Inclus des exemples : Si tu ajoutes une nouvelle API, demande à Bob de passer en revue des APIs bien écrites dans ta base de code pour les utiliser comme exemples. Tu peux aussi inclure des exemples dans ton prompt pour montrer à Bob le format ou le style que tu veux.

Écrire un prompt

Dans cette section, tu vas écrire un prompt vague pour Bob et examiner l'output. Tu vas ensuite affiner ton prompt en te basant sur les bonnes pratiques pour améliorer la qualité de la réponse.

L'objectif est que Bob génère une fonction Python qui affiche la date et l'heure actuelles au format UTC. La fonction doit être bien documentée et inclure la gestion des erreurs.

Si l'interface de chat est fermée, ouvre-la en cliquant sur l'icône Bob à côté de la barre de navigation ou utilise le raccourci Option + Command + B (Mac) ou Ctrl + Alt + B (Windows).

Panneau de chat Bob ouvert dans IBM Bob IDE

Sélectionne Ask dans le sélecteur de mode dans l'interface de chat.

Saisis le prompt suivant :

Write a Python function that prints the date and time.

Bob va générer une réponse, mais elle ne répondra peut-être pas à toutes tes exigences.

from datetime import datetime

def print_datetime():
    now = datetime.now()
    print(now.strftime("%Y-%m-%d %H:%M:%S"))

Bob a généré une fonction, mais elle n'inclut probablement pas la gestion des erreurs ou n'est pas au format UTC.

Démarre un nouveau chat pour effacer la fenêtre de contexte.

Maintenant, affine ton prompt pour donner un rôle à Bob et inclure des instructions, des exemples et du contexte plus spécifiques.

Ajoute un rôle : Donne un rôle à Bob pour l'aider à comprendre la perspective qu'il doit adopter lors de la génération de la réponse. Par exemple, "Tu es un ingénieur logiciel senior avec une expertise en Python."
Ajoute des instructions spécifiques : Sois clair sur ce que tu veux. Par exemple, "Écris une fonction Python 3 qui affiche la date et l'heure actuelles au format UTC."
Ajoute du contexte : Fournis toute information supplémentaire qui peut aider Bob à générer une meilleure réponse. Par exemple, "La fonction doit être bien documentée et inclure la gestion des erreurs."
Exemple : Inclus un exemple de ce à quoi tu veux que l'output ressemble. Si tu as des exemples dans ta base de code, tu peux les référencer en utilisant les mentions de contexte @ de Bob, ou créer des liens vers des exemples externes comme de la documentation ou des sources faisant autorité comme Real Python.

You are a senior software engineer with expertise in Python 3. Write a Python 3 function that prints the current date and time in UTC format. The function should be well documented and include error handling, modeled after https://realpython.com/ref/best-practices/exception-handling/.

"""
utc_datetime.py — Utility for printing the current UTC date and time.
"""

from datetime import datetime, timezone

def print_utc_datetime() -> None:
    """Print the current date and time in UTC (ISO 8601 format).

    Retrieves the current moment from the system clock, attaches UTC timezone
    info, formats it as an ISO 8601 string, and writes it to stdout.

    Returns:
        None

    Raises:
        OSError: If the system clock cannot be read (e.g., hardware failure or
            OS-level permission restrictions).
        ValueError: If datetime formatting unexpectedly fails (e.g., year out
            of the supported range).

    Example:
        >>> print_utc_datetime()
        Current UTC date and time: 2025-07-15T13:42:00.123456+00:00
    """
    try:
        now_utc: datetime = datetime.now(tz=timezone.utc)
    except OSError as exc:
        # System clock is unavailable or inaccessible.
        raise OSError("Failed to read the system clock.") from exc

    try:
        formatted: str = now_utc.isoformat()
    except ValueError as exc:
        # Extremely unlikely, but guard against out-of-range datetime values.
        raise ValueError(
            f"Failed to format the datetime object: {now_utc!r}"
        ) from exc

    print(f"Current UTC date and time: {formatted}")


if __name__ == "__main__":
    print_utc_datetime()

La réponse de Bob devrait maintenant être mieux alignée avec tes exigences, démontrant l'importance d'écrire des prompts efficaces.

IBM SkillsBuild

IBM SkillsBuild est une plateforme d'apprentissage en ligne gratuite qui propose des cours et des ressources pour t'aider à développer tes compétences dans divers domaines technologiques, notamment l'IA et l'apprentissage automatique. Tu peux trouver des cours sur la façon d'écrire des prompts efficaces pour des assistants IA comme Bob, ainsi que d'autres sujets liés au développement logiciel et à la technologie.

Pour en savoir plus sur la rédaction de bons prompts, suis le cours Craft Precise Prompts for AI Models.

Prochaines étapes

Dans ce tutoriel, tu as appris les composants d'un prompt efficace et affiné un prompt vague en un prompt qui produit de manière fiable l'output souhaité.

Passe à Utiliser une skill pour transformer un prompt bien écrit en un workflow réutilisable et reproductible que Bob peut appliquer automatiquement.

Écrire des prompts efficaces pour Bob