Scrivere prompt efficaci per Bob

Cos'è un prompt?

Componenti di un prompt

Feedback
• Istruzione: Indica a Bob quale compito eseguire. L'istruzione è scritta come un comando chiaro, ad esempio "Riassumi questa funzione Python" o "Genera un SBOM per questa API." Istruzioni chiare riducono l'ambiguità e portano a risultati più rilevanti.
Feedback
• Ruolo: Assegna a Bob un ruolo o persona specifici da adottare nella generazione della risposta. Per esempio, potresti dire "Sei un ingegnere software senior con competenze in Python." Questo aiuta Bob a personalizzare la risposta in base alla prospettiva di quel ruolo.
Feedback
• Contesto: Il contesto fornisce informazioni aggiuntive o dettagli che modellano la risposta di Bob. Il contesto potrebbe includere una descrizione della situazione, il tono, il pubblico o informazioni chiave che vuoi incorporare. Il contesto aiuta Bob a rimanere allineato con il compito.
Feedback
• Esempio: Gli esempi includono uno o più esempi che dimostrano il pattern, il formato o il tono desiderato. Fornire esempi è particolarmente utile quando vuoi che l'output segua uno stile o una struttura specifici. Gli esempi aiutano Bob a interpretare cosa significa una buona risposta.
Feedback
• Suggerimenti: Un suggerimento è un breve testo che introduce il tipo di risposta che desideri. I suggerimenti vengono spesso posizionati alla fine del prompt per orientare la generazione dell'output di Bob nella direzione giusta.

Buone pratiche per i prompt

Feedback
• Sii specifico: Più specifico è il tuo prompt, meglio Bob può capire cosa vuoi. Invece di chiedere "Come scrivo una funzione Python?", chiedi "Come scrivo una funzione Python che prende una lista di numeri e restituisce la media?"
Feedback
• Fornisci contesto: Se il tuo prompt riguarda un progetto o una codebase specifica, fornisci del contesto. Questo aiuta Bob a generare una risposta rilevante per la tua situazione. Usa le menzioni di contesto @ di Bob per fare riferimento a file specifici.
Feedback
• Suddividi le attività: Come faresti nel raffinare un'attività nel tuo backlog, suddividi le attività complesse in passi più piccoli e gestibili. Questo può aiutare Bob a generare risposte più accurate e mirate.
Feedback
• Includi esempi: Se stai aggiungendo una nuova API, indica a Bob di esaminare API ben scritte nella tua codebase da usare come esempi. Puoi anche includere esempi nel tuo prompt per mostrare a Bob il formato o lo stile che vuoi.

Scrivere un prompt

Write a Python function that prints the date and time.

from datetime import datetime

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

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()

IBM SkillsBuild

Passi successivi