Ceri date structurate (JSON) fără să dai schema exactă
Dacă ceri „extrage datele din factură în JSON” fără schemă, cheile se schimbă de la un document la altul („total”, „Total”, „suma_totala”), iar automatizarea care citește JSON-ul se strică. Repari dând schema exactă (numele cheilor, tipul valorilor), ce pui când lipsește o valoare și cerând doar JSON, fără alt text.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când rezultatul asistentului nu e citit de un om, ci de o automatizare (un pas din Make, Zapier, Power Automate, un script, un tabel), forma lui trebuie să fie exact aceeași de fiecare dată. Cu o cerere vagă („dă-mi datele în JSON”), asistentul alege singur numele cheilor, scrie sumele ca text cu „lei”, datele în formate diferite și adaugă uneori o frază înainte de JSON. Fiecare dintre acestea strică pasul următor.
O a doua problemă: când o valoare lipsește din document, asistentul o poate inventa sau poate omite cheia.
Regula practică: dă schema exactă, ca exemplu de JSON cu toate cheile; spune tipul fiecărei valori (număr fără unitate, dată ca 2026-03-12); spune ce pui când lipsește („null”); cere doar JSON, fără text și fără blocuri de cod, dacă automatizarea nu le suportă. Dacă unealta ta are un mod de răspuns structurat (JSON schema), folosește-l.
De ce apare: cauzele frecvente
1Doar „în JSON”
Extrage datele din factura de mai jos în JSON.Extrage datele din factura de mai jos. Răspunde doar cu JSON,
exact cu aceste chei:
{"furnizor": "", "numar": "", "data": "AAAA-LL-ZZ",
"total": 0, "moneda": "RON"}
"total" e număr fără unitate. Dacă o valoare lipsește,
pune null.Fără schemă, cheile și formatele variază. Cu schema, tipurile și regula pentru lipsuri, fiecare factură dă același JSON.
2Text în jurul JSON-ului
Dă-mi datele în format JSON.Răspunde doar cu obiectul JSON: fără explicații,
fără text înainte sau după.O frază de tipul „Iată datele:” înaintea JSON-ului face ca pasul următor să nu-l poată citi.
Corectează greșeala, direct în pagină
Promptul de mai jos cere datele facturii „în JSON”, iar cheile și formatele diferă de la o factură la alta. Rescrie-l: cere doar JSON, cu cheile exacte furnizor, numar, data (în formatul AAAA-LL-ZZ) și total (număr fără unitate), iar dacă o valoare lipsește din factură, pune null.
Extrage datele din factura de mai jos în JSON.
"""
[textul facturii]
"""Indiciu
Scrie schema ca exemplu de JSON și spune ce pui când lipsește o valoare.
Reparația
Extrage datele din factura de mai jos. Răspunde doar cu JSON, fără alt text, exact cu aceste chei:
{"furnizor": "", "numar": "", "data": "AAAA-LL-ZZ", "total": 0}
"data" este în formatul AAAA-LL-ZZ, iar "total" este un număr fără unitate. Dacă o valoare lipsește din factură, pune null.
"""
[textul facturii]
"""De ce merge
Fără schemă, asistentul alege singur numele cheilor și formatele, iar pasul următor din automatizare nu mai găsește „total” când primește „suma_totala”. Cu cheile exacte, tipurile valorilor și regula pentru lipsuri, fiecare factură dă același JSON.
null în loc de valoare inventată îți arată facturile incomplete. „Doar JSON” elimină frazele din jur, care ar strica citirea automată.
Cum o eviți pe viitor
- Dă schema ca exemplu de JSON, cu toate cheile.
- Spune tipul fiecărei valori: număr fără unitate, dată AAAA-LL-ZZ, text.
- Spune ce pui când lipsește o valoare (null), ca să nu fie inventată.
- Cere doar JSON, fără alt text.
- Folosește modul de răspuns structurat al uneltei, dacă există.
- Testează pe documente diferite, inclusiv incomplete.
Întrebări frecvente
De ce cheile au alt nume la fiecare factură?
Pentru că nu le-ai fixat. Asistentul alege un nume potrivit pentru fiecare document, iar alegerea poate varia. Un exemplu de JSON cu cheile exacte rezolvă asta.
Ce fac dacă JSON-ul primit nu e valid?
În automatizare, verifică JSON-ul înainte de pasul următor și trimite cazurile invalide la un om sau reîncearcă. Uneltele cu răspuns structurat reduc mult această problemă.
Greșeli înrudite
Clasificarea automată nu are o listă fixă de categorii Când ceri „clasifică emailul” fără o listă de categorii, asistentul inventează etichete diferite de la un email la altul („Reclamație”, „Problemă livrare”, „Nemulțumire”), iar regulile din automatizare nu le mai recunosc. Repari dând lista exactă de categorii, cu o categorie „Altele” și răspuns de un singur cuvânt. Răspunsul are introduceri și încheieri de umplutură („Sigur! Iată...”) Asistenții încep des cu „Sigur! Iată o variantă...” și termină cu „Spune-mi dacă vrei modificări”, iar tu trebuie să tai aceste rânduri înainte să folosești textul. Repari cerând „Dă-mi doar textul final, fără introducere, fără explicații și fără întrebări la sfârșit”. Nu-i spui să răspundă doar din documentul dat Când întrebi ceva despre un regulament sau o politică lipită în prompt, asistentul poate amesteca documentul cu ce „știe” în general și inventează reguli pe care firma ta nu le are. Repari scriind: „Răspunde doar din documentul de mai jos, cu citatul exact. Dacă nu scrie acolo, spune că nu scrie.” Învață AI pentru productivitate de la zero, cu exerciții la fiecare lecție
Curs AI pentru productivitate: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 8 lecții sunt gratuite.
