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

Recapitulare: primul flux complet cu AI

Ai învățat, pe rând, toate piesele: cum gândește modelul, ce unealtă alegi, cum scrii promptul, ce nu lipești, cum citești, testezi și ceri o reparație. Acum le pui cap la cap pe o funcție reală din ColetExpres, de la cerință până la ultimul test care trece, și repari tu cele două greșeli ale asistentului.

Fluxul complet, într-o imagine

1. Cerințaregula de business2. Promptrețeta din lecția 43. Codpropus de asistent4. Citirelinie cu linie5. Testverifica, cazuri6. Repararefollow-up precisrulezi din nou toate cazuriletoate trec: abia acum commit
Fluxul din primul modul: cerință, prompt, cod propus, citire linie cu linie, test pe cazuri, reparare și din nou testele, până trec toate.

Sarcina lui Andrei, din tichetul de luni: „Comenzile de la 200 lei în sus au livrare gratuită în Cluj-Napoca, Florești și Turda.” Funcția se va folosi la coșul de cumpărături din site și la facturare.

Promptul și codul primit

Andrei aplică rețeta din lecția 4 și verifică să nu lipească date reale (lecția 7):

Scrie în Python 3.12 funcția livrare_gratuita(total: float, oras: str) -> bool pentru aplicația ColetExpres.
Regula: livrare gratuită pentru comenzi de la 200 lei în sus, doar în Cluj-Napoca, Florești și Turda.
Orașul vine din formular, scris de client.
Doar biblioteca standard. Dă-mi doar funcția, cu docstring.

Asistentul răspunde cu o mulțime de orașe și o funcție de o linie. Andrei o pune în editor, alături de ajutorul verifica (lecția 8) și de câteva cazuri calculate din regulă:

ORASE_GRATUITE = {"cluj-napoca", "florești", "turda"}


def livrare_gratuita(total, oras):
    """True dacă comanda are livrare gratuită: de la 200 lei, în orașele din zona Cluj."""
    return total > 200 and oras in ORASE_GRATUITE

def verifica(nume, real, asteptat):
    if real == asteptat:
        print(f"OK   {nume}")
    else:
        print(f"PICĂ {nume}: am primit {real!r}, așteptam {asteptat!r}")

cazuri = [
    ((250, "Cluj-Napoca"), True),
    ((200, "cluj-napoca"), True),
    ((150, "Turda"), False),
]

trecute = 0
for (total, oras), asteptat in cazuri:
    real = livrare_gratuita(total, oras)
    verifica(f"{total} lei, {oras}", real, asteptat)
    if real == asteptat:
        trecute += 1
print(f"{trecute}/{len(cazuri)} cazuri trec")
PICĂ 250 lei, Cluj-Napoca: am primit False, așteptam True
PICĂ 200 lei, cluj-napoca: am primit False, așteptam True
OK   150 lei, Turda
1/3 cazuri trec

Citești: două greșeli într-o linie

Codul rulează fără nicio eroare, dar două cazuri din trei pică. Citind linia cu return și urmărind valorile pe cazurile care pică (lecțiile 5 și 6), Andrei găsește două probleme:

Caz care picăCe se întâmplăCauza
200, "cluj-napoca"200 > 200 este False„de la 200 lei” include 200: trebuie >=
250, "Cluj-Napoca""Cluj-Napoca" in {"cluj-napoca", ...} este Falsemulțimea are orașe cu litere mici, clientul scrie cu majusculă

Prima greșeală e o confuzie clasică de prag. A doua e un caz pe care modelul nu avea cum să-l știe sigur: forma în care scriu clienții orașul. Andrei a spus în prompt că orașul vine din formular, dar asistentul n-a tras concluzia. Tocmai pentru asta ai testele.

Important

Observă că testul cu Turda trece. Dacă Andrei ar fi încercat doar acel caz, ar fi crezut că funcția e corectă. Cazurile alese bine (pe prag, cu majuscule) sunt cele care găsesc greșelile.

Repari: follow-up sau direct în cod

Ai două variante, la fel de bune. Fie scrii asistentului un follow-up precis (lecția 9):

Pentru livrare_gratuita(200, "cluj-napoca") am obținut False, mă așteptam la True (regula e de la 200 lei inclusiv).
Pentru livrare_gratuita(250, "Cluj-Napoca") am obținut False, mă așteptam la True (clientul scrie orașul cu majusculă).
Explică-mi cauza și repară doar linia cu return. Păstrează semnătura și mulțimea de orașe.

Fie, când greșeala e evidentă și mică, o repari singur: e mai rapid decât să explici. Oricum ar fi, după reparație rulezi din nou toate cazurile:

ORASE_GRATUITE = {"cluj-napoca", "florești", "turda"}


def livrare_gratuita(total, oras):
    """True dacă comanda are livrare gratuită: de la 200 lei, în orașele din zona Cluj."""
    return total >= 200 and oras.lower() in ORASE_GRATUITE

def verifica(nume, real, asteptat):
    if real == asteptat:
        print(f"OK   {nume}")
    else:
        print(f"PICĂ {nume}: am primit {real!r}, așteptam {asteptat!r}")

cazuri = [
    ((250, "Cluj-Napoca"), True),
    ((200, "cluj-napoca"), True),
    ((150, "Turda"), False),
]

trecute = 0
for (total, oras), asteptat in cazuri:
    real = livrare_gratuita(total, oras)
    verifica(f"{total} lei, {oras}", real, asteptat)
    if real == asteptat:
        trecute += 1
print(f"{trecute}/{len(cazuri)} cazuri trec")
OK   250 lei, Cluj-Napoca
OK   200 lei, cluj-napoca
OK   150 lei, Turda
3/3 cazuri trec
Bine de știut

.lower() transformă textul în litere mici, așa că „Cluj-Napoca”, „CLUJ-NAPOCA” și „cluj-napoca” devin toate „cluj-napoca”. .casefold() face același lucru, puțin mai agresiv, pentru comparații între limbi. Spațiile de la capete (" Turda") ar mai cere un .strip(): un caz de test bun de adăugat data viitoare.

Ce ai învățat în modulul 1

LecțiaIdeea de luat cu tine
1–2Asistentul prezice cod plauzibil din ce e pe masă; plauzibil nu înseamnă corect.
3Completare, chat, agent: cu cât face mai mult singur, cu atât verifici mai mult.
4Rețeta: limbaj, sarcină, intrare/ieșire cu exemple, constrângeri, format.
5–6Citești linie cu linie, urmărești valorile, ceri explicații la nivelul tău.
7Fără chei, parole și date ale clienților în prompt.
8–9Teste pe cazuri normale, limită și invalide; follow-up cu real vs așteptat.
  • Greșeala de evitat: „merge pe un exemplu, deci e bun”.
  • Obiceiul de păstrat: tabelul de cazuri rămâne lângă funcție și rulează după fiecare modificare.
  • Regula cursului: AI-ul accelerează, dar tu răspunzi de cod. Abia când trec toate testele faci commit.

În modulul 2 înveți să-i dai asistentului contextul potrivit: fișierele, convențiile și specificațiile proiectului.

Exercițiul tău

În editor ai funcția livrare_gratuita generată de asistent, ajutorul verifica și tabelul de cazuri. Rulează: două cazuri pică. Repară cele două greșeli din funcție (pragul de 200 lei și comparația orașului indiferent de majuscule), apoi adaugă în tabel cazul ((300, "Iași"), False). La final trebuie să vezi 4 linii OK și 4/4 cazuri trec.

  • Rulează și citește liniile cu PICĂ.
  • Repară pragul: livrarea e gratuită de la 200 lei, inclusiv.
  • Repară comparația orașului ca să nu conteze majusculele (de ex. oras.lower()).
  • Adaugă în cazuri linia ((300, "Iași"), False),.
  • Rulează din nou: 4/4 cazuri trec.
return total >= 200 and oras.lower() in ORASE_GRATUITE

Soluția exercițiului

# Cod generat de asistent pentru ColetExpres: livrare gratuită
ORASE_GRATUITE = {"cluj-napoca", "florești", "turda"}


def livrare_gratuita(total, oras):
    """True dacă comanda are livrare gratuită: de la 200 lei, în orașele din zona Cluj."""
    return total >= 200 and oras.lower() in ORASE_GRATUITE  # reparat: >= (de la 200) și oraș fără majuscule


# Ajutorul de testare al cursului
def verifica(nume, real, asteptat):
    if real == asteptat:
        print(f"OK   {nume}")
    else:
        print(f"PICĂ {nume}: am primit {real!r}, așteptam {asteptat!r}")


cazuri = [
    ((250, "Cluj-Napoca"), True),
    ((200, "cluj-napoca"), True),
    ((150, "Turda"), False),
    ((300, "Iași"), False),
]

trecute = 0
for (total, oras), asteptat in cazuri:
    real = livrare_gratuita(total, oras)
    verifica(f"{total} lei, {oras}", real, asteptat)
    if real == asteptat:
        trecute += 1
print(f"{trecute}/{len(cazuri)} cazuri trec")
Excelent! Continuă cu lecția următoare →
main.pyPython
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 10 · Recapitulare: primul flux complet cu AI
Progres 0% 0 din 12
Lecția curentă 10 / 10 Primii pași cu ai în cod