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
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 False | mulț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.
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
.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ția | Ideea de luat cu tine |
|---|---|
| 1–2 | Asistentul prezice cod plauzibil din ce e pe masă; plauzibil nu înseamnă corect. |
| 3 | Completare, chat, agent: cu cât face mai mult singur, cu atât verifici mai mult. |
| 4 | Rețeta: limbaj, sarcină, intrare/ieșire cu exemple, constrângeri, format. |
| 5–6 | Citești linie cu linie, urmărești valorile, ceri explicații la nivelul tău. |
| 7 | Fără chei, parole și date ale clienților în prompt. |
| 8–9 | Teste 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.
Î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.
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") 