Għodda document_library: Mistoqsijiet u Tweġibiet dwar il-Fajls Tiegħek
F'din il-paġna
Lezzjoni aġġornata fit-3 ta’ Novembru 2026 ibbażata fuq l-SDK
mistralai3.7.0: id-dokumenti tal-librerija jiġu ġestiti permezz ta’client.beta.libraries.documents(upload,list,delete). Il-metodiadd_document,list_documents, uremove_documentmill-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_libraryhija 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