Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Workshop: Analiżi tat-Test

Lezzjoni 14 / 16 Aġġornat 28 ta’ Lulju 2026 Bidbieni
F'din il-paġna
  1. Għan tal-workshop
  2. Eżerċizzju 1: Analiżi tas-sentiment tar-reviżjonijiet tal-klijenti
  3. Eżerċizzju 2: Estrazzjoni ta’ data strutturata
  4. Eżerċizzju 3: Klassifikazzjoni tat-tickets tas-support
  5. Pariri għal kompiti ta’ analiżi
  6. Punti Ewlenin

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