...
← Curs AI pentru programatori: toate lecțiile
Lecția 4 · Primii pași cu AI în cod

Primul tău prompt bun pentru cod

Ai văzut că asistentul răspunde doar din ce îi pui pe masă. Acum înveți rețeta cursului pentru orice cerere de cod: limbaj, sarcină, intrare și ieșire, constrângeri, format. Cinci ingrediente, pe care le aplici aceleiași funcții, înainte și după, ca să vezi diferența.

Înainte: cererea scurtă

Clienții ColetExpres scriu des la suport mesaje ca „Bună, coletul meu CE12345678 n-a ajuns, poate și ce12345679?”. Andrei vrea o funcție care scoate AWB-urile dintr-un astfel de mesaj. Prima lui cerere:

scrie o funcție care extrage AWB-ul dintr-un mesaj
def extract_awb(message):
    words = message.split()
    for w in words:
        if w.startswith("AWB"):
            return w
    return None

Asistentul nu știe ce e un AWB la ColetExpres, așa că a presupus că începe cu literele „AWB”. Întoarce un singur cod (deși pot fi mai multe), numele e în engleză și nu se potrivește cu restul proiectului, iar CE12345678, cu virgula lipită n-ar fi recunoscut nici dacă regula ar fi fost bună.

Rețeta: cinci ingrediente

IngredientCe spuiExemplu
Limbaj + versiuneîn ce scrie codulPython 3.12
Sarcină (verb)ce trebuie să facă, cu un verb clar„extrage toate AWB-urile din text”
Intrare / ieșirenumele funcției, tipurile, exemple concreteextrage_awb(text: str) -> list[str], "... CE12345678 ..." -> ["CE12345678"]
Constrângeribiblioteci permise, stil, regulidoar biblioteca standard, nume în română
Formatcum vrei răspunsuldoar funcția, cu docstring, fără explicații lungi
Important

Cel mai puternic ingredient sunt exemplele de intrare și ieșire. Ele spun mai exact decât orice frază ce înseamnă „corect” și îți dau, gratis, primele teste: după ce primești codul, îl rulezi exact pe exemplele tale.

Nu ai nevoie de toate ingredientele la fiecare întrebare mică. Dar pentru o funcție care intră în proiect, lipsa oricăruia înseamnă că asistentul ghicește acea parte.

După: aceeași funcție, cu rețeta

Scrie în Python 3.12 funcția extrage_awb(text: str) -> list[str] pentru aplicația ColetExpres.
Sarcina: găsește toate AWB-urile din mesajul unui client. Un AWB are 2 litere urmate de 8 cifre.
Literele pot fi mici în mesaj; întoarce-le mereu cu majuscule, în ordinea apariției, fără duplicate.
Exemple:
"Coletul CE12345678 n-a ajuns, poate și ce12345679?" -> ["CE12345678", "CE12345679"]
"Nu am AWB" -> []
Doar biblioteca standard. Dă-mi doar funcția, cu un docstring scurt.
import re

def extrage_awb(text: str) -> list[str]:
    """Întoarce AWB-urile (2 litere + 8 cifre) din text, cu majuscule, fără duplicate."""
    gasite = re.findall(r"\b[A-Za-z]{2}\d{8}\b", text)
    rezultat = []
    for awb in gasite:
        awb = awb.upper()
        if awb not in rezultat:
            rezultat.append(awb)
    return rezultat

Acum funcția are numele din proiect, tipurile cerute, tratează literele mici, duplicatele și mesajul fără AWB. Și, foarte important, Andrei știe exact cum s-o verifice: o rulează pe cele două exemple din prompt și compară.

Atenție

Un prompt bun nu înseamnă cod garantat corect. De exemplu, \b din expresie cere o graniță de cuvânt, deci un AWB lipit de litere, ca în nrCE12345678, nu e găsit. E bine sau rău? Depinde de regula voastră, iar regula o știi tu, nu asistentul. Tot tu rulezi și testezi (lecția 8).

Cum scrii fiecare ingredient

1
Începe cu verbul și limbajul: „Scrie în Python 3.12 funcția...”.
2
Dă semnătura exactă: numele funcției, parametrii, tipul întors. Așa se potrivește cu restul codului.
3
Adaugă 2–4 exemple de intrare -> ieșire, inclusiv un caz limită (text gol, fără rezultat).
4
Spune ce se întâmplă la intrare invalidă: întoarce None, listă goală sau aruncă ValueError? Dacă nu spui, asistentul alege.
5
Pune constrângerile: doar biblioteca standard, stilul proiectului.
6
Cere formatul: doar funcția, cu docstring; fără explicații lungi și fără exemple de utilizare, dacă nu le vrei.

Datele lungi (exemple multe, un fișier, un tabel) le pui la final, între delimitatori """, ca asistentul să știe clar unde se termină instrucțiunea și unde încep datele.

Greșeli frecvente

  • Fără exemple: „normalizează numărul” poate însemna zeci de formate diferite.
  • Fără caz invalid: funcția întoarce ceva ciudat (șirul neschimbat, None) și nimeni nu observă până la primul client cu număr greșit.
  • Fără constrângeri: primești o soluție cu un pachet extern pe care proiectul nu-l are.
  • Fără format: trei paragrafe de explicații, două variante și un exemplu de utilizare, din care cauți tu funcția.
  • Prompt de o pagină, fără structură: ingredientele se pierd. Câte o propoziție scurtă pentru fiecare e suficient.
FormulareValidări de date

Telefoane, emailuri, coduri poștale: exemplele de intrare și ieșire fac diferența.

RapoarteFormatări de sume

„1234.5” -> „1.234,50 lei”: fără exemplu, primești formatul american.

IntegrareConversii între formate

CSV de la un partener în JSON-ul aplicației: dai 2 rânduri de exemplu și rezultatul dorit.

Exercițiul tău

Clienții ColetExpres își scriu numărul de telefon în tot felul de formate, iar curierii au nevoie de un format unic. În editor ai tabelul primit de la Ioana. Scrie deasupra lui promptul pentru funcția normalizeaza_telefon(text), folosind rețeta: limbaj și versiune, numele funcției, exemplele (tabelul), constrângerea „doar biblioteca standard” și ce se întâmplă la o intrare invalidă.

  • Spune limbajul și versiunea: Python 3.
  • Dă numele exact: normalizeaza_telefon.
  • Spune că exemplele de intrare -> ieșire sunt în tabel (sau scrie-le).
  • Cere doar biblioteca standard.
  • Spune ce face funcția la o intrare invalidă (de ex. aruncă ValueError).
Ingredientele, câte o propoziție: „Scrie în Python 3 funcția normalizeaza_telefon(text: str) -> str... Exemplele sunt mai jos. Doar biblioteca standard. La un număr invalid aruncă ValueError.”

Soluția exercițiului

Scrie în Python 3.12 funcția normalizeaza_telefon(text: str) -> str pentru aplicația ColetExpres.
Sarcina: transformă un număr de telefon românesc, scris de client în orice format, în formatul +40 urmat de 9 cifre, fără spații.
Exemple de intrare -> ieșire sunt în tabelul de mai jos (stânga intrarea, dreapta rezultatul dorit).
Dacă textul nu e un număr românesc valid (alt număr de cifre, litere), aruncă ValueError cu un mesaj clar.
Constrângeri: doar biblioteca standard (poți folosi re), fără pachete externe.
Format: dă-mi doar funcția, cu un docstring scurt, fără explicații lungi.

"""
Numere de telefon din formularele clienților ColetExpres (stânga: ce scrie clientul | dreapta: ce vrem în baza de date)
0722 123 456      | +40722123456
0040 722 123 456  | +40722123456
+40-722-123-456   | +40722123456
(0264) 555 123    | +40264555123
"""
Excelent! Continuă cu lecția următoare →
prompt.txtPrompt
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Primii pași cu AI în cod Lecția 4 · Primul tău prompt bun pentru cod
Progres 0% 0 din 12
Lecția curentă 4 / 10 Primii pași cu ai în cod