Ċitazzjonijiet b'Sorsi: Oġġett ta' Referenza u RAG
F'din il-paġna
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 fihomurl,title,snippets(lista ta’ listi),description,date, usource. L-”Oġġett ta’ Referenza” bil-kampitype,reference_id, usource_idmill-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ġinalititle— it-titlu tas-sors, għall-wirisnippets— 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ħudescription— deskrizzjoni qasira, jewNonedate— id-data tal-pubblikazzjoni jew tal-aġġornamentsource— 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