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

Ċitazzjonijiet b'Sorsi: Oġġett ta' Referenza u RAG

Lezzjoni 8 / 16 Aġġornat 3 ta’ Novembru 2026 Avvanzat
F'din il-paġna
  1. Għaliex iċ-ċitazzjonijiet huma essenzjali fil-produzzjoni
  2. Il-format tar-referenza
  3. Arkitettura tal-pipeline RAG biċ-ċitazzjonijiet
  4. L-aħjar prattiki għas-snippets
  5. Punti Ewlenin

Aġġornat fit-3 ta’ Novembru 2026 abbażi tal-gwida Citations & References ta’ Mistral: is-sorsi jgħaddu bħala riżultat ta’ għodda (tool result) f’oġġett fejn iċ-ċwievet huma numri ("0", "1"…) u l-valuri fihom url, title, snippets (lista ta’ listi), description, date, u source. L-”Oġġett ta’ Referenza” bil-kampi type, reference_id, u source_id mill-verżjoni preċedenti ma jidhirx fid-dokumentazzjoni, u lanqas limiti speċifiċi għan-numru ta’ sorsi. Sors: Citations & References.

Għaliex iċ-ċitazzjonijiet huma essenzjali fil-produzzjoni

Meta tiddispjega sistema ta’ Ġenerazzjoni Awwmentata bir-Rikupru (RAG) fil-produzzjoni, l-utenti tiegħek jeħtieġu li jivverifikaw it-tweġibiet tal-mudell. Tweġiba mingħajr sors hija affermazzjoni li ma tistax tiġi vverifikata. Iċ-ċitazzjonijiet ibiddlu tweġiba tal-AI f’waħda ddokumentata, traċċabbli u affidabbli.

Mistral AI tintegra nativament mekkaniżmu ta’ ċitazzjoni li jħalli lill-mudell jibbaża t-tweġibiet tiegħu fuq dokumenti sors u jipprovdi referenzi preċiżi. Il-mudell ġie mħarreġ fil-fond biex jgħaqqad ruħu mad-dokumenti u joħroġ passiġġi rilevanti.

Il-format tar-referenza

F’Mistral, is-sorsi ma jgħaddux minn parametru ddedikat: jaslu għand il-mudell bħala riżultat ta’ sejħa ta’ għodda. L-għodda tiegħek tirritorna oġġett JSON fejn kull ċavetta hija numru tas-sors ("0", "1", "2"…) u kull valur jiddeskrivi s-sors:

references = {
    "0": {
        "url": "https://docs.example.com/guide",
        "title": "Deployment Guide v3.2",
        "snippets": [
            [
                "Production deployment requires verification...",
                "Load tests must validate at least 1000 req/s..."
            ]
        ],
        "description": None,
        "date": "2026-03-15",
        "source": "docs-deployment"
    }
}

Kampi tar-referenza

  • Iċ-ċavetta ("0", "1"…) — l-identifikatur tas-sors, li l-mudell jerġa’ juża fiċ-ċitazzjonijiet tiegħu
  • url — l-indirizz tas-sors oriġinali
  • title — it-titlu tas-sors, għall-wiri
  • snippets — l-estratti rilevanti, bħala lista ta’ listi ta’ sentenzi: dan huwa l-kontenut li l-mudell juża biex jibbaża t-tweġiba tiegħu
  • description — deskrizzjoni qasira, jew None
  • date — id-data tal-pubblikazzjoni jew tal-aġġornament
  • source — l-oriġini tas-sors (bażi tad-data ta’ dokumenti, sit web)

Arkitettura tal-pipeline RAG biċ-ċitazzjonijiet

Il-fluss tax-xogħol sħiħ jinqasam f’erba’ passi.

1. Tiftix tad-dokumenti

Is-sistema ta’ rikupru tiegħek (Elasticsearch, Pinecone, pgvector, eċċ.) tirritorna d-dokumenti rilevanti għall-mistoqsija tal-utent.

2. Bini tar-referenzi

Inti tistruttura d-dokumenti rkuprati f’dan il-format:

def build_references(search_results):
    """Converts search results to Mistral's reference format."""
    return {
        str(i): {
            "url": result.get("url", ""),
            "title": result["title"],
            "snippets": [result["relevant_passages"]],
            "description": None,
            "date": result.get("date"),
            "source": result.get("collection", "default"),
        }
        for i, result in enumerate(search_results)
    }

3. Sejħa tal-mudell b’għodda

Inti tiddikjara għodda li l-mudell isejjaħ biex jikseb is-sorsi. Meta tissejjaħ, il-kodiċi tiegħek jirritorna json.dumps(references) f’ToolMessage, imbagħad tkompli l-konversazzjoni (lezzjoni li jmiss).

from mistralai.client import Mistral

client = Mistral(api_key="your-api-key")

get_information_tool = {
    "type": "function",
    "function": {
        "name": "get_information",
        "description": "Retrieves relevant document sources",
        "parameters": {
            "type": "object",
            "properties": {"query": {"type": "string"}},
            "required": ["query"]
        }
    }
}

4. Il-mudell jiċċita s-sorsi tiegħu

It-tweġiba finali mhix sempliċiment stringa: il-kontenut tagħha jalternaw bejn oġġetti TextChunk u ReferenceChunk, fejn il-kamp reference_ids fih in-numri tas-sorsi ċċitati — 0 għaċ-ċavetta "0". Inti tfittex dawn in-numri fit-tabella tar-referenzi tiegħek biex turi t-titli u l-links.

L-aħjar prattiki għas-snippets

Il-kwalità taċ-ċitazzjoni tiddependi direttament mill-kwalità tas-snippets, u l-ewwel setting li għandek tħares huwa t-tul tagħhom. Snippet ta’ żewġ sa ħames sentenzi jagħti lill-mudell passaġġ dens u użabbli; estratt li jkopri paġna sħiħa jdilwi l-informazzjoni rilevanti sal-punt fejn il-mudell jiċċita s-sors mingħajr ma verament jibbaża ruħu fuqu. Oqgħod attent li ma taqtax wisq qasir madankollu: snippet maqtugħ mill-kuntest tiegħu jista’ jiġi interpretat ħażin — “ir-rata titla’ għal 20%” ma tfisser xejn jekk is-sentenza ta’ qabel, li speċifikat liema rata, tkun inqatgħet.

In-numru ta’ sorsi jilgħab l-istess rwol tat-tul, fuq livell ta’ mistoqsija: kull sors miżjud jispiċċa jiswa tokens tal-kuntest, kemm jekk jiġi ċċitat kif ukoll jekk le. Ibda b’ħafna sorsi u iċċekkja, fir-reference_ids, liema wħud il-mudell effettivament juża qabel ma żżid aktar. Fl-aħħar nett, meta l-ħin ikun importanti (dokumentazzjoni b’verżjonijiet, prezzijiet, regolamenti), imla l-kamp date għal kull sors: din hija informazzjoni li l-mudell jista’ juża, u li int tista’ turi.

Punti Ewlenin

  • Is-sorsi jgħaddu permezz ta’ riżultat ta’ għodda, indiċjati bin-numru ("0", "1"…), b’URL, titlu, snippets, u metadata
  • Il-mudell ta’ Mistral huwa mħarreġ nativament biex jibbaża t-tweġibiet tiegħu fuq is-sorsi pprovduti
  • Is-snippets iridu jkunu konċiżi u fil-kuntest għal ċitazzjonijiet ta’ kwalità għolja
  • Illimita ruħek għal 3–7 referenzi għal kull mistoqsija għal użu ottimali
  • Iċ-ċitazzjonijiet ibiddlu t-tweġibiet tal-AI f’informazzjoni verifikabbli u traċċabbli