Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Orodje document_library: odgovori na vprašanja na podlagi vaših datotek

Lekcija 11 od 18 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Mistralovo vgrajeno RAG
  2. Ustvari knjižnico dokumentov
  3. Naloži dokumente
  4. Ustvari agenta s knjižnico dokumentov
  5. Poizveduj po dokumentih
  6. Upravljaj knjižnice
  7. Od interne podpore do analize pogodb
  8. Pripravi vire, izoliraj knjižnice
  9. Ključne ugotovitve

Lekcija posodobljena 3. novembra 2026 na podlagi SDK mistralai 3.7.0: dokumenti v knjižnici se upravljajo prek client.beta.libraries.documents (upload, list, delete). Metode add_document, list_documents in remove_document iz prejšnje različice ne obstajajo več, nalaganje pa poteka neposredno v knjižnico. Vir: client-python.

Mistralovo vgrajeno RAG

Orodje document_library je sistem za generiranje z augmentacijo pridobivanja (RAG), vgrajen neposredno v Agents API. Tvoj agent dostopa do dokumentov, ki si jih naložil v Mistralov oblak, pridobi ustrezne odlomke in oblikuje odgovor z navedbo virov. Razlika v primerjavi z lastno razvito rešitvijo RAG je bistvena: ni ti treba gostiti vektorske baze podatkov, vzdrževati cevovoda za vdelave ali uglaševati strategije razdeljevanja na dele. Datoteke preprosto naložiš, ob ustvarjanju agenta deklariraš orodje in prepustiš modelu, da sam odloči, kdaj poizvedovati v knjižnici.

Ustvari knjižnico dokumentov

Knjižnica je vsebnik, ki hrani tvoje dokumente. Ustvariš jo z enim samim klicem API-ja, preden naložiš kakršne koli datoteke.

from mistralai.client import Mistral
import os

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

# Ustvari knjižnico
library = client.beta.libraries.create(
    name="Tehnična dokumentacija",
    description="Priročniki za izdelke in tehnične specifikacije."
)

print(f"ID knjižnice: {library.id}")

Zapiši si vrnjeni ID: to je tisto, kar posreduješ agentu. Bližnjic z uporabo imena knjižnice ni. Če tvoja ekipa upravlja ločene knjižnice za kadre, pravne zadeve in tehniko, te ID-je shrani v svojo konfiguracijo, prav tako kot povezavne nize.

Naloži dokumente

Nalaganje poteka v dveh korakih: najprej se datoteka deponira v prostor Files z eksplicitnim purpose, nato pa se pripne knjižnici.

# Naloži PDF neposredno v knjižnico
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}")

Podprte oblike vključujejo PDF, navadno besedilo in druge običajne vrste dokumentov.

Ustvari agenta s knjižnico dokumentov

agent = client.beta.agents.create(
    model="mistral-medium-latest",
    name="Agent za dokumentacijo",
    instructions="""Si asistent za dokumentacijo.
- Odgovarjaj izključno z uporabo dokumentov iz knjižnice
- Navajaj ustrezne odlomke
- Če informacij v dokumentih ni, to jasno navedi""",
    tools=[{
        "type": "document_library",
        "library_ids": [library.id]
    }]
)

Parameter library_ids je seznam: enemu agentu lahko povežeš več knjižnic. Na primer, asistent za podporo lahko uporablja tako dokumentacijo o izdelkih kot interne postopke. Tu navodila niso le lepa dodana vrednost. Brez direktive, da omeji odgovore na dokumente, bo model vrzeli zapolnil s svojim splošnim znanjem in izgubil boš možnost razlikovanja med tem, kar izvira iz tvojih datotek, in tem, kar prihaja od drugod. Tretja vrstica – eksplicitno navajanje, kdaj informacije manjkajo – je tista, ki iz klepetavega agenta naredi zanesljivega.

Poizveduj po dokumentih

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Kako deluje vizualni enkoder 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"  [Vir] {chunk.title}")

Tako kot pri spletnem iskanju tudi tu odgovor prispe v delčkih dveh vrst. Delčki text vsebujejo pisni odgovor; delčki tool_reference vsebujejo provenienco, pri čemer polje title vsebuje ime izvornega dokumenta, polje url pa zagotavlja interno referenco znotraj tega dokumenta. Ta ločitev ti omogoča, da prikažeš odgovor in tik pod njim seznam dokumentov, ki so ga proizvedli.

Ta sledljivost ni le okrasna. Svetovalec, ki odgovarja stranki na podlagi internega postopka, mora biti sposoben navesti, na kateri postopek se sklicuje; odvetnik, ki se opira na pogodbo, mora biti sposoben slediti nazaj do te pogodbe. Brez navedbe virov sistem RAG proizvaja nepreverljive trditve.

Upravljaj knjižnice

# Izpiši knjižnice
libraries = client.beta.libraries.list()
for lib in libraries.data:
    print(f"{lib.name} ({lib.id})")

# Izpiši dokumente v knjižnici
documents = client.beta.libraries.documents.list(library_id=library.id)
for doc in documents.data:
    print(f"{doc.name} — {doc.size} bajtov")

# Izbriši dokument iz knjižnice
client.beta.libraries.documents.delete(
    library_id=library.id,
    document_id=document.id
)

# Izbriši knjižnico
client.beta.libraries.delete(library_id=library.id)

Odstranjevanje dokumentov je najbolj spregledana operacija in najbolj draga, če jo pozabiš. Zastarela različica cenika ali postopka ostane za agenta citabilna za nedoločen čas in nosi vso podobo legitimnosti, ker ima vir. Naj bo odstranjevanje dokumenta refleks vsakič, ko objaviš novo različico.

Od interne podpore do analize pogodb

Interna podpora je najbolj neposreden primer uporabe: zaposleni postavljajo kadrovska vprašanja v naravnem jeziku, namesto da bi brskali po intranetu.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Interna podpora",
    instructions="Odgovarjaj na vprašanja zaposlenih z uporabo baze kadrovske dokumentacije.",
    tools=[{"type": "document_library", "library_ids": [rh_library.id]}]
)

Analiza pogodb premika paradigmo: agent ne le pridobiva, temveč tudi preučuje. Tu navodila opisujejo nalogo, ne le obsega.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Analitik pogodb",
    instructions="""Analiziraj naložene pogodbe.
- Identificiraj pomembne klavzule
- Označi potencialna tveganja
- Primerjaj s standardi v industriji""",
    tools=[{"type": "document_library", "library_ids": [contrats_library.id]}]
)

Nazadnje, baza znanja o izdelkih ponazarja kombinacijo orodij: uradna dokumentacija ima prednost, spletno iskanje pa zapolni vrzeli, ko dokumentacija ne pokriva določenega vprašanja.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Strokovnjak za izdelke",
    instructions="Odgovarjaj na tehnična vprašanja o naših izdelkih na podlagi uradne dokumentacije.",
    tools=[
        {"type": "document_library", "library_ids": [docs_library.id]},
        {"type": "web_search"}  # Nadomestilo, če dokumentacija ni zadostna
    ]
)

Pripravi vire, izoliraj knjižnice

Kakovost RAG je določena, še preden sploh pokličeš API. Strukturiran PDF z jasnimi naslovi, podnaslovi in ločenimi odstavki se veliko bolje razdeli na dele in pridobi kot sploščen sken ali dokument, kjer vsa logika tiči v postavitvi. Nato loči svoje knjižnice po domenah, namesto da bi ustvaril eno samo zajemalno vedro. Agent, povezan samo s pravno knjižnico, ne bo tvegal citiranja kadrovskega dopisa pri odgovoru na vprašanje o pogodbi. Ti dve odločitvi – izboljšanje strukture virov in izolacija knjižnic – vplivata na končni rezultat bolj kot katero koli uglaševanje modela.

Ključne ugotovitve

  • document_library je vgrajen RAG – ni treba upravljati lastne vektorske infrastrukture
  • Ustvari tematske knjižnice in naloži dokumente prek API-ja Files
  • Odgovori navajajo ustrezne odlomke z uporabo delčkov tool_reference
  • Enemu agentu lahko povežeš več knjižnic
  • Kombiniraj z drugimi orodji za celovito pokritost