Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Luachan le Foinsí: Oibiacht Tagartha agus RAG

Ceacht 8 as 16 Nuashonraithe 3 Samhain 2026 Ardleibhéal
Ar an leathanach seo
  1. Cén fáth a bhfuil luachan riachtanach i dtáirgeadh
  2. Formáid na tagartha
  3. Ailtireacht píblíne RAG le luachan
  4. Dea-chleachtais do bhlúirí (snippets)
  5. Príomhphointí

Nuashonraithe an 3 Samhain, 2026 bunaithe ar threoir Luachan & Tagairtí ó Mistral: seachadtar foinsí mar thoradh uirlise in oibiacht ina bhfuil uimhreacha mar eochracha ("0", "1"…) agus luachanna ina bhfuil url, title, snippets (liosta de liostaí), description, date, agus source. Níl an “Oibiacht Tagartha” le réimsí type, reference_id, agus source_id ón leagan roimhe seo le feiceáil sa doiciméadú, agus níl tairseacha sonracha ann maidir le líon na bhfoinsí ach an oiread. Foinse: Luachan & Tagairtí.

Cén fáth a bhfuil luachan riachtanach i dtáirgeadh

Nuair a chuireann tú córas Giniúint Augmentaithe Aisghabhála (RAG) i bhfeidhm i dtimpeallacht táirgthe, ní mór do d’úsáideoirí freagraí an mhúnla a fhíorú. Is maíomh nach féidir a fhíorú é freagra gan fhoinse. Déanann luachan freagra AI a thiontú go ceann atá doiciméadaithe, inrianaithe, agus iontaofa.

Cuireann Mistral AI sásra luachana isteach go dúchasach a ligeann don mhúnla a chuid freagraí a bhunú ar dhoiciméid fhoinsí agus tagairtí cruinne a sholáthar. Oileadh an múnla go domhain chun é féin a ghreamú de dhoiciméid agus pasáistí ábhartha a eastósct.

Formáid na tagartha

Ag Mistral, ní théann foinsí trí pharaiméadar tiomnaithe: sroicheann siad an múnla mar thoradh glao uirlise. Tugann d’uirlis oibiacht JSON ar ais ina bhfuil gach eochair ina uimhir foinse ("0", "1", "2"…) agus gach luach ag cur síos ar an bhfoinse:

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"
    }
}

Réimsí tagartha

  • An eochair ("0", "1"…) — an t-aitheantóir foinse, a athúsáideann an múnla ina luachan
  • url — seoladh na foinse bunaidh
  • title — teideal na foinse, le haghaidh taispeána
  • snippets — na blúirí ábhartha, mar liosta de liostaí de chodanna: seo an t-ábhar a úsáideann an múnla chun a fhreagra a ghreamú
  • description — cur síos gairid, nó None
  • date — an dáta foilsithe nó nuashonraithe
  • source — bunús na foinse (bunachar sonraí doiciméad, suíomh gréasáin)

Ailtireacht píblíne RAG le luachan

Briseann an sruth oibre iomlán síos ina cheithre chéim.

1. Cuardach doiciméad

Tugann do chóras aisghabhála (Elasticsearch, Pinecone, pgvector, srl.) na doiciméid atá ábhartha don cheist úsáideora ar ais.

2. Tagairtí a thógáil

Struchtúraíonn tú na doiciméid a aisghabhadh sa fhormáid seo:

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. An múnla a ghlaowh le huirlis

Dearann tú uirlis a ghlaonn an múnla uirthi chun foinsí a fháil. Nuair a ghlaotar uirthi, filleann do chód json.dumps(references) i ToolMessage, agus ansin leanann tú ar aghaidh leis an gcomhrá (an chéad cheacht eile).

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. Luachann an múnla a chuid foinsí

Ní teaghrán simplí é an fhreagra dheireanach: malartaíonn a chuid ábhair idir oibiachtaí TextChunk agus ReferenceChunk, áit a bhfuil uimhreacha na bhfoinsí a luadh sa réimse reference_ids — 0 don eochair "0". Déanann tú cuardach orthu seo i do thábla tagartha chun teidil agus naisc a thaispeáint.

Dea-chleachtais do bhlúirí (snippets)

Braitheann cáilíocht na luachan go díreach ar cháilíocht na mblúirí, agus is é an chéad socruithe le breathnú air ná a bhfad. Tugann blúire de dhá go cúig abairt pas dlúth, inúsáidte don mhúnla; caolaíonn blúire a shíneann thar leathanach iomlán an fhaisnéis ábhartha go dtí an pointe nach ndéanann an múnla ach an fhoinse a luadh gan é féin a ghreamú go fírinneach di. Bí cúramach gan gearradh ró-ghearr, áfach: is féidir blúire a stróicteadh as a chomhthéacs a mhíthuiscint — ní chiallaíonn “éiríonn an ráta go 20%” aon rud má gearradh an abairt roimhe, a shonraigh cén ráta a bhí i gceist.

Tá an ról céanna ag líon na bhfoinsí agus atá ag an bhfad, ar scála na ceiste: costálann gach foinse bhreise tócan comhthéacs, cibé an luadh iad nó nach ea. Tosaigh le roinnt beag foinsí agus seiceáil, sna reference_ids, cé na cinn a úsáideann an múnla i ndáiríre sula gcuireann tú níos mó leo. Ar deireadh, nuair a bhíonn tábhacht le ham (doiciméadú leaganaithe, praghsáil, rialacháin), líon an réimse date do gach foinse: is faisnéis í seo is féidir leis an múnla a úsáid, agus is féidir leatsa í a thaispeáint.

Príomhphointí

  • Seachadtar foinsí trí thoradh uirlise, innéacsaithe de réir uimhreach ("0", "1"…), le URL, teideal, blúirí, agus meiteashonraí
  • Oileadh an múnla Mistral go dúchasach chun a chuid freagraí a ghreamú de na foinsí a soláthraíodh
  • Caithfidh blúirí a bheith gonta agus comhthéacsaithe le haghaidh luachan ar ardchaighdeán
  • Teorainn tú féin do 3–7 tagairt in aghaidh na ceiste le haghaidh úsáide optamach
  • Déanann luachan freagraí AI a thiontú go faisnéis atá infhíoraithe agus inrianaithe