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 NoneAsistentul 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
| Ingredient | Ce spui | Exemplu |
|---|---|---|
| Limbaj + versiune | în ce scrie codul | Python 3.12 |
| Sarcină (verb) | ce trebuie să facă, cu un verb clar | „extrage toate AWB-urile din text” |
| Intrare / ieșire | numele funcției, tipurile, exemple concrete | extrage_awb(text: str) -> list[str], "... CE12345678 ..." -> ["CE12345678"] |
| Constrângeri | biblioteci permise, stil, reguli | doar biblioteca standard, nume în română |
| Format | cum vrei răspunsul | doar funcția, cu docstring, fără explicații lungi |
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 rezultatAcum 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ă.
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
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.
Telefoane, emailuri, coduri poștale: exemplele de intrare și ieșire fac diferența.
„1234.5” -> „1.234,50 lei”: fără exemplu, primești formatul american.
CSV de la un partener în JSON-ul aplicației: dai 2 rânduri de exemplu și rezultatul dorit.
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).
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 """
