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

Għodda document_library: Mistoqsijiet u Tweġibiet dwar il-Fajls Tiegħek

Lezzjoni 11 / 18 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. RAG Integrat ta’ Mistral
  2. Oħloq Librerija ta’ Dokumenti
  3. Ittella’ Dokumenti
  4. Oħloq Aġent b’Librerija ta’ Dokumenti
  5. Istaqsi d-Dokumenti
  6. Immaniġġja l-Libreriji
  7. Mill-Appoġġ Intern għall-Analiżi tal-Kuntratti
  8. Ipprepara s-Sorsi, Iżola l-Libreriji
  9. Punti Ewlenin

Lezzjoni aġġornata fit-3 ta’ Novembru 2026 ibbażata fuq l-SDK mistralai 3.7.0: id-dokumenti tal-librerija jiġu ġestiti permezz ta’ client.beta.libraries.documents (upload, list, delete). Il-metodi add_document, list_documents, u remove_document mill-verżjoni preċedenti ma jeżistux aktar, u t-tlugħ issa jsir direttament fil-librerija. Sors: client-python.

RAG Integrat ta’ Mistral

L-għodda document_library hija sistema ta’ Ġenerazzjoni Awwmentata bir-Rikupru (RAG) mibnija direttament fl-API tal-Aġenti. L-aġent tiegħek jaċċessa d-dokumenti li tlajt fil-cloud ta’ Mistral, jirkupra passi rilevanti, u jifformula t-tweġiba tiegħu b’ċitazzjonijiet. Id-differenza meta mqabbla ma’ soluzzjoni RAG magħmula fid-dar hija sinifikanti: m’għandekx bżonn tospita bażi tad-data vettorjali, iżżomm pipeline ta’ embedding, jew issaħħaħ strateġija ta’ tqattigħ (chunking). Int sempliċiment ittella’ fajls, tiddikjara l-għodda meta toħloq l-aġent, u tħalli l-mudell jiddeċiedi meta jistaqsi lill-librerija.

Oħloq Librerija ta’ Dokumenti

Librerija hija l-kontenitur li fih id-dokumenti tiegħek. Int toħloqha b’sejħa waħda tal-API qabel ma ttella’ kwalunkwe fajl.

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# Oħloq librerija
library = client.beta.libraries.create(
    name="Dokumentazzjoni Teknika",
    description="Manwali tal-prodott u speċifikazzjonijiet tekniċi."
)

print(f"ID tal-Librerija: {library.id}")

Ħu nota tal-ID irritornat: dan huwa dak li tgħaddi lill-aġent. M’hemm l-ebda shortcut bl-użu tal-isem tal-librerija. Jekk it-tim tiegħek jimmaniġġja libreriji separati għar-Riżorsi Umani, legali u tekniċi, aħżen dawn l-IDs fil-konfigurazzjoni tiegħek eżattament bħal strings ta’ konnessjoni.

Ittella’ Dokumenti

It-tlugħ iseħħ f’żewġ passi: l-ewwel, il-fajl jitqiegħed fl-ispazju tal-Fajls b’purpose espliċitu, imbagħad jitwaħħal mal-librerija.

# Ittella' PDF direttament fil-librerija
with open("product-manual.pdf", "rb") as f:
    document = client.beta.libraries.documents.upload(
        library_id=library.id,
        file={"file_name": "product-manual.pdf", "content": f},
    )

print(f"Dokument {document.id}: {document.processing_status}")

Il-formati appoġġjati jinkludu PDF, test sempliċi, u tipi oħra komuni ta’ dokumenti.

Oħloq Aġent b’Librerija ta’ Dokumenti

agent = client.beta.agents.create(
    model="mistral-medium-latest",
    name="Aġent tad-Dokumentazzjoni",
    instructions="""Int assistent tad-dokumentazzjoni.
- Wieġeb biss bl-użu ta' dokumenti mill-librerija
- Iċċita passi rilevanti
- Jekk l-informazzjoni mhix fid-dokumenti, iddikjara dan b'mod ċar""",
    tools=[{
        "type": "document_library",
        "library_ids": [library.id]
    }]
)

Il-parametru library_ids huwa lista: tista’ tassocja libreriji multipli ma’ aġent wieħed. Pereżempju, assistent tas-support jista’ juża kemm id-dokumentazzjoni tal-prodott kif ukoll il-proċeduri interni. Hawnhekk, l-istruzzjonijiet huma aktar minn sempliċiment xi ħaġa pjaċevoli li jkollok. Mingħajr id-direttiva li tillimita t-tweġibiet għad-dokumenti, il-mudell jimla l-lakuni bil-għarfien ġenerali tiegħu, u int titlef l-abbiltà li tiddistingwi x’jiġi mill-fajls tiegħek u x’jiġi minn xi mkien ieħor. It-tielet linja—li tiddikjara b’mod espliċitu meta l-informazzjoni tkun nieqsa—hija dak li jbiddel aġent ċattier f’wieħed affidabbli.

Istaqsi d-Dokumenti

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Kif jaħdem l-encoder tal-viżjoni Pixtral 12B?"
)

for entry in response.outputs:
    if entry.type == "message.output":
        for chunk in entry.content:
            if chunk.type == "text":
                print(chunk.text)
            elif chunk.type == "tool_reference":
                print(f"  [Sors] {chunk.title}")

Bħat-tiftix fuq il-web, it-tweġiba tasal f’biċċiet (chunks) ta’ żewġ tipi. Il-biċċiet text fihom it-tweġiba miktuba; il-biċċiet tool_reference fihom il-provenjenza, bil-qasam title li jżomm l-isem tad-dokument sors u l-qasam url li jipprovdi r-referenza interna f’dak id-dokument. Din is-separazzjoni tippermettilek turi t-tweġiba u, eżatt taħtha, il-lista ta’ dokumenti li pproduċewha.

Din it-traċċabbiltà mhix sempliċiment dekorattiva. Konsulent li jwieġeb klijent ibbażat fuq proċedura interna jrid ikun jista’ jispeċifika liema proċedura qed jiċċita; avukat li jiddependi fuq kuntratt irid ikun jista’ jmur lura għal dak il-kuntratt. Mingħajr ċitazzjonijiet, sistema RAG tipproduċi affermazzjonijiet li ma jistgħux jiġu vverifikati.

Immaniġġja l-Libreriji

# Elenska l-libreriji
libraries = client.beta.libraries.list()
for lib in libraries.data:
    print(f"{lib.name} ({lib.id})")

# Elenska d-dokumenti f'librerija
documents = client.beta.libraries.documents.list(library_id=library.id)
for doc in documents.data:
    print(f"{doc.name} — {doc.size} bytes")

# Ħassar dokument mill-librerija
client.beta.libraries.documents.delete(
    library_id=library.id,
    document_id=document.id
)

# Ħassar il-librerija
client.beta.libraries.delete(library_id=library.id)

It-tneħħija ta’ dokumenti hija l-operazzjoni l-aktar injorata, u l-aktar għalja meta tintesa. Verżjoni antika ta’ lista tal-prezzijiet jew proċedura tibqa’ tiġi ċċitata mill-aġent għal dejjem, iġġorr id-dehra kollha ta’ leġittimità għax hija mis-sors. Agħmel it-tneħħija ta’ dokument rifless kull meta tippubblika verżjoni ġdida.

Mill-Appoġġ Intern għall-Analiżi tal-Kuntratti

L-appoġġ intern huwa l-każ ta’ użu l-aktar immedjat: l-impjegati jistaqsu mistoqsijiet dwar ir-Riżorsi Umani b’lingwa naturali minflok ma jħaffru fl-intranet.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Appoġġ Intern",
    instructions="Wieġeb mistoqsijiet tal-impjegati bl-użu tal-bażi tad-dokumentazzjoni tar-RU.",
    tools=[{"type": "document_library", "library_ids": [rh_library.id]}]
)

L-analiżi tal-kuntratti tbiddel il-paradigma: l-aġent mhux biss jirkupra, iżda jeżamina. Hawnhekk, l-istruzzjonijiet jiddeskrivu kompitu, mhux biss ambitu.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Analist tal-Kuntratti",
    instructions="""Analiżi tal-kuntratti mtejbin.
- Identifika klawżoli importanti
- Issinja riskji potenzjali
- Qabbel mal-istandards tal-industrija""",
    tools=[{"type": "document_library", "library_ids": [contrats_library.id]}]
)

Fl-aħħar nett, bażi tal-għarfien tal-prodott turi l-kombinazzjoni tal-għodod: id-dokumentazzjoni uffiċjali tieħu preċedenza, u t-tiftix fuq il-web jimla l-lakuni meta d-dokumenti ma jkoprux mistoqsija.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Espert tal-Prodott",
    instructions="Wieġeb mistoqsijiet tekniċi dwar il-prodotti tagħna abbażi tad-dokumentazzjoni uffiċjali.",
    tools=[
        {"type": "document_library", "library_ids": [docs_library.id]},
        {"type": "web_search"}  # Ripjieg jekk id-dokumenti ma jkunux biżżejjed
    ]
)

Ipprepara s-Sorsi, Iżola l-Libreriji

Il-kwalità tar-RAG tiġi ddeterminata qabel ma ssejjaħ l-API. PDF strutturat b’intestaturi ċari, sottotitoli u paragrafi distinti jiġi maqsum u rkuprat ferm aħjar minn skennijiet iċċattjati jew dokument fejn il-loġika kollha tinsab fil-layout. Imbagħad, ifred il-libreriji tiegħek skont id-dominju minflok ma toħloq bucket wieħed li jaqbad kollox. Aġent konness biss mal-librerija legali ma jirriskjax li jiċċita memorandum tar-RU biex iwieġeb mistoqsija dwar kuntratt. Dawn iż-żewġ deċiżjonijiet—li tloxxa l-istruttura tas-sors u li tiżola l-libreriji—jaffettwaw ir-riżultat finali aktar minn kwalunkwe aġġustament tal-mudell.

Punti Ewlenin

  • document_library hija RAG integrata—m’hemmx bżonn timmaniġġja l-infrastruttura vettorjali tiegħek stess
  • Oħloq libreriji tematiċi u ittella’ dokumenti permezz tal-API tal-Fajls
  • It-tweġibiet jiċċitaw passi rilevanti bl-użu ta’ biċċiet tool_reference
  • Tista’ tassocja libreriji multipli ma’ aġent wieħed
  • Ikkombina ma’ għodod oħra għal kopertura komprensiva