Workshop: Analiżi tat-Test
F'din il-paġna
Għan tal-workshop
Wara l-kitba, ibdel il-mara: dan il-workshop iħarrek biex tuża Mistral għal kompiti ta’ analiżi—tanalizza s-sentiment tat-test, testraġġi informazzjoni ewlenija, u tikklassifika l-kontenut. Dawn il-ħiliet huma fundamentali għall-awtomazzjoni tal-ipproċessar tad-data tat-test fin-negozju. Kull meta bniedem jaqra għexieren ta’ testi simili biex jipproċessa l-istess grilja ta’ informazzjoni, ikollok kandidat għall-awtomazzjoni. Se tinnota fil-komuni bejn it-tliet eżerċizzji: it-temperatura tibqa’ baxxa, għax fl-analiżi, il-konsistenza hija aktar importanti mill-kreattività.
Eżerċizzju 1: Analiżi tas-sentiment tar-reviżjonijiet tal-klijenti
Immaġina dan ix-xenarju: timmaniġġja s-servizz tal-klijenti għal suq online u tirċievi mijiet ta’ reviżjonijiet kuljum. Huwa impossibbli li taqrahom kollha; trid tanalizzahom awtomatikament biex tiskopri problemi rikorrenti u tipprijoritizza r-risposti. Il-prompt tas-sistema jiddefinixxi grilja ta’ analiżi fissa—sentiment, temi, urġenza, azzjoni—u jinfurza output f’JSON sabiex l-għodda tat-ticketing tiegħek tkun tista’ tipproċessa r-riżultat.
messages = [
{
"role": "system",
"content": """You are a customer experience analyst.
For each review, provide:
1. Overall sentiment: positive / mixed / negative
2. Topics covered (max 3)
3. Urgency level: low / medium / high
4. Recommended action (1 sentence)
Respond in structured JSON."""
},
{
"role": "user",
"content": """Analyze these 3 customer reviews:
Review 1: "Order received in 2 days, careful packaging. However, the user
manual is only in English, which is a shame for a product sold in France.
The product itself works very well."
Review 2: "This is the THIRD time I've received a defective item. Support
has been giving me the runaround for 2 weeks. I will contact the DGCCRF if
nothing moves."
Review 3: "Good value for money. Nothing exceptional but does the job.
Standard delivery, no issues."
Return a JSON table with the analysis of each review."""
}
]
response = client.chat.complete(
model="mistral-large-latest",
messages=messages,
temperature=0.1
)
Ir-riżultat mistenni jidher hekk—innnota li r-reviżjoni 1, ġeneralment sodisfatta iżda b’riżerva, trid toħroġ bħala “mixed” u mhux “positive”, u r-reviżjoni 2, bit-theddida li tikkuntattja d-DGCCRF (l-aġenzija Franċiża għall-protezzjoni tal-konsumatur), trid ttriggera urġenza għolja:
[
{
"review": 1,
"sentiment": "mixed",
"themes": ["delivery", "documentation", "product quality"],
"urgency": "low",
"action": "Translate the user manual to French for future batches."
},
{
"review": 2,
"sentiment": "negative",
"themes": ["product quality", "customer service", "recurrence"],
"urgency": "high",
"action": "Escalate to support manager for priority handling."
},
{
"review": 3,
"sentiment": "positive",
"themes": ["value for money", "delivery"],
"urgency": "low",
"action": "No action required, standard satisfied review."
}
]
Eżerċizzju 2: Estrazzjoni ta’ data strutturata
It-tieni sitwazzjoni: tirċievi emails ta’ applikazzjonijiet għax-xogħol f’test liberu u trid testraġġi informazzjoni ewlenija biex tgħaqqadha mas-sistema ATS (Applicant Tracking System) tiegħek. Ir-riskju prinċipali fl-estrazzjoni huwa l-invenzjoni: mudell mingħajr istruzzjonijiet jimla l-vojt b’deduzzjonijiet plawżibbli b’ferħ. Għalhekk iż-żewġ regoli kardinali tal-prompt tas-sistema—“not provided” għal kwalunkwe informazzjoni nieqsa, u projbizzjoni assoluta fuq id-deduzzjoni.
messages = [
{
"role": "system",
"content": """You extract structured data from free text.
Rules:
- If information is not mentioned, indicate "not provided"
- NEVER deduce information: stay strictly with the text
- Dates must be in YYYY-MM-DD format
- Skills must be normalized terms"""
},
{
"role": "user",
"content": """Extract information from this job application email:
"Hello,
I am submitting my application for the full-stack developer position
published on LinkedIn. My name is Sarah Benali and I have 6 years
of experience in web development. Currently a Lead Developer at DataViz (Paris),
I work primarily with React, Node.js, and PostgreSQL. I also have
strong experience with AWS and Docker. My current daily rate is
€650 and I am available starting May 15, 2026.
Best regards,
Sarah Benali"
Expected JSON format:
{
"name": "",
"target_role": "",
"experience_years": 0,
"current_role": "",
"current_company": "",
"location": "",
"skills": [],
"daily_rate": "",
"availability": ""
}"""
}
]
response = client.chat.complete(
model="mistral-large-latest",
messages=messages,
temperature=0.0
)
Hawnhekk hawn l-output li għandek tikseb:
{
"name": "Sarah Benali",
"target_role": "Full-stack developer",
"experience_years": 6,
"current_role": "Lead Developer",
"current_company": "DataViz",
"location": "Paris",
"skills": ["React", "Node.js", "PostgreSQL", "AWS", "Docker"],
"daily_rate": "€650",
"availability": "2026-05-15"
}
Innota t-temperatura f’0.0: għall-estrazzjoni, trid risposta deterministika leali għat-test sors. Innota wkoll il-konverżjoni tad-data għall-format ISO, mitluba espliċitament fir-regoli—mingħajr din l-istruzzjoni, il-mudell ikun ikkopja “May 15, 2026” kif inhi.
Eżerċizzju 3: Klassifikazzjoni tat-tickets tas-support
L-aħħar sitwazzjoni: it-tim tas-support tiegħek jirċievi tickets mhux ikkategorizzati li jeħtieġu routing awtomatiku lid-dipartiment it-tajjeb. Iċ-ċavetta għal dan l-eżerċizzju hija d-definizzjoni eżawrjenti tal-kategoriji u l-prijoritajiet fil-prompt tas-sistema. Jekk tħalli lill-mudell jinventa t-tassonomija tiegħu stess, kull lott ta’ tickets joħroġ b’kategoriji differenti u r-routing tiegħek isir impossibbli li jiġi mmaniġġjat.
messages = [
{
"role": "system",
"content": """You classify technical support tickets.
Available categories:
- BILLING: payment issues, invoices, subscriptions, refunds
- TECHNICAL: bugs, errors, functionality issues, slowness
- ACCOUNT: login, password, settings, account deletion
- FEATURE: requests for new features, suggestions
- OTHER: anything that doesn't fit the categories above
Priorities:
- P1: service inaccessible, data loss, direct financial impact
- P2: degraded functionality, workaround possible
- P3: question, information request, suggestion
Respond ONLY in JSON, no text before or after."""
},
{
"role": "user",
"content": """Classify these 4 tickets:
Ticket A: "Unable to log in since this morning. I tried to
reset my password but I'm not receiving the email."
Ticket B: "Would it be possible to add an Excel export in addition to CSV?"
Ticket C: "I was charged twice for my March subscription."
Ticket D: "The app crashes when I import a file larger than 50 MB.
Error message: MEMORY_EXCEEDED."
Format:
[{"ticket": "A", "category": "", "priority": "", "service": "", "summary": ""}]"""
}
]
response = client.chat.complete(
model="mistral-large-latest",
messages=messages,
temperature=0.0
)
Ir-riżultat mistenni—innnota li t-ticket C, bl-impatt finanzjarju dirett tiegħu, imur għal P1 filwaqt li l-ħsara teknika fit-ticket D tibqa’ f’P2 peress li jeżisti workaround:
[
{
"ticket": "A",
"category": "ACCOUNT",
"priority": "P2",
"service": "Level 1 Support",
"summary": "Unable to log in, reset email not received"
},
{
"ticket": "B",
"category": "FEATURE",
"priority": "P3",
"service": "Product",
"summary": "Request for Excel export in addition to CSV"
},
{
"ticket": "C",
"category": "BILLING",
"priority": "P1",
"service": "Accounting",
"summary": "Double charge March subscription, refund request"
},
{
"ticket": "D",
"category": "TECHNICAL",
"priority": "P2",
"service": "Development",
"summary": "Crash importing large files (MEMORY_EXCEEDED)"
}
]
Pariri għal kompiti ta’ analiżi
Erba’ prattiki tajbin jissintetizzaw il-metodu ta’ dan il-workshop. Aħdem b’temperatura 0 għall-klassifikazzjoni u l-estrazzjoni: trid konsistenza, mhux ispirazzjoni. Iddfinixxi l-kategoriji espliċitament fil-prompt tas-sistema, inkella l-mudell se jinventa tiegħu stess. Dejjem inkludi l-istruzzjoni “not provided” għad-data nieqsa, inkella l-mudell jimla l-vojt b’invenzjonijiet plawżibbli. U qabel kwalunkwe dispjegament, ittestja fuq każijiet limitu: testi ambigwi, tickets li jaqgħu f’żewġ kategoriji, data parzjali—hawnhekk hija fejn il-grilja tiegħek turi d-dgħufijiet tagħha, mhux fuq każijiet ta’ kotba.
Punti Ewlenin
- L-analiżi tat-test b’Mistral taħdem l-aħjar b’temperatura baxxa (0-0.2)
- Dejjem iddefinixxi l-kategoriji u l-format tal-output fil-prompt
- Infurza r-regola “not provided” biex tevita l-alluċinazzjonijiet
- Il-few-shot itejjeb il-konsistenza tal-klassifikazzjoni
- Ittestja fuq każijiet reali rappreżentattivi qabel ma tiddispjega fil-produzzjoni