Uirlis document_library: Ceisteanna agus Freagraí bunaithe ar do Chomhaid
Ar an leathanach seo
An ceacht nuashonraithe an 3 Samhain, 2026 bunaithe ar SDK
mistralai3.7.0: bainistítear doiciméid leabharlainne tríclient.beta.libraries.documents(upload,list,delete). Níl na modhannaadd_document,list_documents, agusremove_documentón leagan roimhe seo ann a thuilleadh, agus téann uaslódálacha go díreach isteach sa leabharlann. Foinse: client-python.
RAG Inbhunaithe Mistral
Is córas Giniúint Fheabhsaithe le hAisghabháil (RAG) é an uirlis document_library atá tógtha go díreach isteach san API Aighne. Déanann do ghníomhaire rochtain ar dhoiciméid a d’uaslódáil tú chuig scamall Mistral, faigheann sé pasáin ábhartha, agus cumadóidh sé a fhreagra le luachan. Tá an difríocht i gcomparáid le réiteach RAG baile suntasach: ní gá duit bunachar sonraí veicteora a óstáil, píblíne leabaithe a chothabháil, ná straitéis scoilte a thionó. Níl le déanamh agat ach comhaid a uaslódáil, an uirlis a dhearbhú agus an gníomhaire á chruthú, agus ligean don mhúnla a chinneadh cathain a dhéanfar ceist ar an leabharlann.
Leabharlann Doiciméad a Chruthú
Is coimeádán é leabharlann a choinníonn do chuid doiciméad. Cruthaíonn tú é le glao API amháin sula n-uaslódálann tú aon chomhaid.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Cruthaigh leabharlann
library = client.beta.libraries.create(
name="Doiciméadú Teicniúil",
description="Láimhleabhair táirge agus sonraíochtaí teicniúla."
)
print(f"Aitheantas na Leabharlainne: {library.id}")
Tabhair faoi deara an t-aitheantas a fhilltear: is é seo a thugann tú don ghníomhaire. Níl aon aicearra ann ag baint úsáide as ainm na leabharlainne. Má bhainistíonn do fhoireann leabharlanna ar leith do HR, dlí, agus teicneolaíocht, stóráil na haitheantais seo i do chumraíocht díreach cosúil le teaghráin nasctha.
Doiciméid a Uaslódáil
Tarlaíonn an t-uaslódáil i dhá chéim: ar dtús, déantar an comhad a thaisceadh sa spás Comhaid le purpose sainráite, ansin ceanglaítear leis an leabharlann é.
# Uaslódáil PDF go díreach chuig an leabharlann
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"Doiciméad {document.id}: {document.processing_status}")
I measc na bhformáidí a dtacaítear leo tá PDF, téacs simplí, agus cineálacha coitianta eile doiciméad.
Gníomhaire a Chruthú le Leabharlann Doiciméad
agent = client.beta.agents.create(
model="mistral-medium-latest",
name="Gníomhaire Doiciméadúcháin",
instructions="""Is cúntóir doiciméadúcháin tú.
- Freagair ag baint úsáide as doiciméid ón leabharlann amháin
- Luigh pasáin ábhartha
- Mura bhfuil an fhaisnéis sna doiciméid, ráiteas é go soiléir""",
tools=[{
"type": "document_library",
"library_ids": [library.id]
}]
)
Is liosta é an paraiméadar library_ids: is féidir leat il-leabharlanna a bhaint le gníomhaire amháin. Mar shampla, d’fhéadfadh cúntóir tacaíochta úsáid a bhaint as doiciméadú táirge agus nósanna imeachta inmheánacha araon. Anseo, tá na treoracha níos mó ná rud deas le bheith agat. Gan an treoir chun freagraí a theorannú do dhoiciméid, líonfaidh an múnla bearnaí lena chuid eolais ghinearálta, agus caillfidh tú an cumas idirdhealú a dhéanamh idir an méid a thagann ó do chomhaid agus an méid a thagann ó áit eile. Is é an tríú líne—ag rá go sainráite nuair atá faisnéis in easnamh—a thiontaíonn gníomhaire cainte ina cheann iontaofa.
Ceisteanna a Chur ar na Doiciméid
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Conas a oibrí an t-ionchódóir radhairc 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" [Foinse] {chunk.title}")
Cosúil le cuardach gréasáin, tagann an fhreagra i smutání de dhá chineál. Tá an fhreagra scríofa i smutání text; tá an bunús i smutání tool_reference, agus an réimse title ag coinneáil ainm an doiciméid fhoinsí agus an réimse url ag soláthar na tagartha inmheánaí laistigh den doiciméad sin. Ligeann an deighilt seo duit an freagra a thaispeáint agus, díreach faoi, an liosta doiciméad a tháirg é.
Níl an inrianaitheacht seo maisiúil amháin. Ní mór do chomhairleoir a fhreagraíonn do chliaint bunaithe ar nós imeachta inmheánach a bheith in ann a shonrú cén nós imeachta atá á luachan acu; ní mór d’fhreastalaí dlí a bhraitheann ar chonradh a bheith in dul siar ar an gconradh sin. Gan luachan, táirgeann córas RAG maímh nach féidir a fhíorú.
Leabharlanna a Bhainistiú
# Liostaigh leabharlanna
libraries = client.beta.libraries.list()
for lib in libraries.data:
print(f"{lib.name} ({lib.id})")
# Liostaigh doiciméid i leabharlann
documents = client.beta.libraries.documents.list(library_id=library.id)
for doc in documents.data:
print(f"{doc.name} — {doc.size} beart")
# Scrios doiciméad ón leabharlann
client.beta.libraries.documents.delete(
library_id=library.id,
document_id=document.id
)
# Scrios an leabharlann
client.beta.libraries.delete(library_id=library.id)
Is é doiciméid a bhaint an oibríocht is minice a dhéantar neamhaird uirthi, agus an ceann is costasaí nuair a dhéantar dearmad air. Fanann leagan as dáta de liosta praghsanna nó de nós imeachta inúsáidte ag an ngníomhaire go deo, ag iompar gach dealramh dlisteanachta toisc go bhfuil sé foinseachta. Déan doiciméad a bhaint ina reflex gach uair a fhoilsíonn tú leagan nua.
Ó Thacaíocht Inmheánach go hanailís Chonartha
Is é an tacaíocht inmheánach an cás úsáide is láithrí: cuirim fostaithe ceisteanna HR i ngnáththeanga in ionas dul trí iontrán.
agent = client.beta.agents.create(
model="mistral-large-latest",
name="Tacaíocht Inmheánach",
instructions="Freagair ceisteanna fostaithe ag baint úsáide as bonn doiciméadúcháin HR.",
tools=[{"type": "document_library", "library_ids": [rh_library.id]}]
)
Aistríonn anailís chonartha an paraidím: ní dhéanann an gníomhaire aisghabháil amháin, déanann sé scrúdú. Anseo, déanann treoracha cur síos ar thasc, ní ar raon feidhme amháin.
agent = client.beta.agents.create(
model="mistral-large-latest",
name="Anailísí Conarthaí",
instructions="""Déan anailís ar chonarthaí uaslódáilte.
- Aithigh clásail thábhachtacha
- Brataigh rioscaí féideartha
- Déan comparáid le caighdeáin tionscail""",
tools=[{"type": "document_library", "library_ids": [contrats_library.id]}]
)
Ar deireadh, léiríonn bonn eolais táirge comhcheangal uirlisí: tá tosaíocht ag doiciméadú oifigiúil, agus líonann cuardach gréasáin na bearnaí nuair nach gcumhdaíonn na doiciméid ceist.
agent = client.beta.agents.create(
model="mistral-large-latest",
name="Saineolaí Táirge",
instructions="Freagair ceisteanna teicniúla faoinár dtáirgí bunaithe ar dhoiciméadú oifigiúil.",
tools=[
{"type": "document_library", "library_ids": [docs_library.id]},
{"type": "web_search"} # Cúlthaca mura leor na doiciméid
]
)
Foinseacha a Ullmhú, Leabharlanna a Leithlisiú
Cinntear cáilíocht RAG sula nglaonn tú ar an API fiú. Scoilteann agus aisghabhálann PDF struchtúrtha le ceanntásc soiléir, fo-cheanntásc, agus míreanna ar leith i bhfad níos fearr ná scanadh comhréidh nó doiciméad ina bhfuil gach loighic sa leagan amach. Ina theannta sin, scar do chuid leabharlanna de réir fearainn seachas buicéad gabhála-uile amháin a chruthú. Ní rioscóidh gníomhaire atá nasctha leis an leabharlann dlí amháin meo HR a luachan chun ceist conartha a fhreagairt. Bíonn tionchar ag an dá chinneadh seo—struchtúr foinse a snasú agus leabharlanna a leithlisiú—ar an toradh deiridh níos mó ná aon tiúnadh múnla.
Príomhphointí
- Is RAG inbhunaithe é
document_library—ní gá dít do bhonneagar veicteora féin a bhainistiú - Cruthaigh leabharlanna téamacha agus uaslódáil doiciméid trí API na gComhad
- Luann freagraí pasáin ábhartha ag baint úsáide as smutání
tool_reference - Is féidir leat il-leabharlanna a bhaint le gníomhaire amháin
- Comhcheangail le huirlisí eile le haghaidh clúdach cuimsitheach