Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Nástroj document_library: Otázky a odpovede na základe vašich súborov

Lekcia 11 z 18 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Vstavaný RAG od Mistralu
  2. Vytvorenie knižnice dokumentov
  3. Nahrávanie dokumentov
  4. Vytvorenie agenta s knižnicou dokumentov
  5. Dotazovanie dokumentov
  6. Správa knižníc
  7. Od internej podpory po analýzu zmlúv
  8. Príprava zdrojov a izolácia knižníc
  9. Kľúčové poznatky

Lekcia aktualizovaná 3. novembra 2026 na základe SDK mistralai 3.7.0: dokumenty v knižniciach sa spravujú prostredníctvom client.beta.libraries.documents (upload, list, delete). Metódy add_document, list_documents a remove_document z predchádzajúcej verzie už neexistujú a nahrávanie prebieha priamo do knižnice. Zdroj: client-python.

Vstavaný RAG od Mistralu

Nástroj document_library je systém Retrieval-Augmented Generation (RAG) priamo zabudovaný do Agents API. Tvoj agent pristupuje k dokumentom, ktoré si nahral do cloudu Mistral, vyhľadáva relevantné pasáže a formuluje odpoveď s citáciami. Rozdiel oproti vlastnému riešeniu RAG je zásadný: nemusíš hostiť vektorovú databázu, udržiavať pipeline pre vektory (embedding) ani ladiť stratégiu rozdelenia textu na časti (chunking). Jednoducho nahraješ súbory, pri vytváraní agenta deklaruješ tento nástroj a necháš model rozhodnúť, kedy má knižnicu dotazovať.

Vytvorenie knižnice dokumentov

Knižnica je kontajner, ktorý uchováva tvoje dokumenty. Vytvoríš ju jediným volaním API ešte pred nahraním akýchkoľvek súborov.

from mistralai.client import Mistral
import os

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

# Vytvorenie knižnice
library = client.beta.libraries.create(
    name="Technická dokumentácia",
    description="Príručky k produktom a technické špecifikácie."
)

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

Poznač si vrátené ID: to je hodnota, ktorú odovzdáš agentovi. Neexistuje žiadna skratka využívajúca názov knižnice. Ak tvoj tím spravuje oddelené knižnice pre HR, právne záležitosti a technickú dokumentáciu, ulož si tieto ID do konfigurácie rovnako ako pripojovacie reťazce.

Nahrávanie dokumentov

Nahrávanie prebieha v dvoch krokoch: najprv sa súbor uloží do priestoru Files s explicitným účelom (purpose) a následne sa pripojí ku knižnici.

# Priame nahranie PDF do knižnice
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}")

Medzi podporované formáty patria PDF, plain text a ďalšie bežné typy dokumentov.

Vytvorenie agenta s knižnicou dokumentov

agent = client.beta.agents.create(
    model="mistral-medium-latest",
    name="Agent pre dokumentáciu",
    instructions="""Si asistent pre dokumentáciu.
- Odpovedaj výlučne na základe dokumentov z knižnice
- Cituj relevantné pasáže
- Ak informácia v dokumentoch nie je, jasne to uveď""",
    tools=[{
        "type": "document_library",
        "library_ids": [library.id]
    }]
)

Parameter library_ids je zoznam: jednému agentovi môžeš priradiť viacero knižníc. Napríklad asistent podpory môže využívať produktovú dokumentáciu aj interné procedúry. Inštrukcie tu sú viac než len užitočné – sú nevyhnutné. Bez príkazu obmedziť odpovede na dokumenty model doplní medzery svojou všeobecnou znalosťou a ty stratíš schopnosť rozlíšiť, čo pochádza z tvojich súborov a čo z iných zdrojov. Tretí riadok – explicitné uvedenie chýbajúcich informácií – je tým, čo mení ukecaného agenta na spoľahlivého.

Dotazovanie dokumentov

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Ako funguje vision encoder 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"  [Zdroj] {chunk.title}")

Podobne ako pri webovom vyhľadávaní, odpoveď prichádza v častiach dvoch typov. Časti text obsahujú písanú odpoveď; časti tool_reference obsahujú pôvod údajov, pričom pole title drží názov zdrojového dokumentu a pole url poskytuje interný odkaz v rámci tohto dokumentu. Toto oddelenie ti umožňuje zobraziť odpoveď a hneď pod ňou zoznam dokumentov, ktoré ju vygenerovali.

Táto vysledovateľnosť nie je len ozdobná. Poradca odpovedajúci klientovi na základe internej procedúry musí byť schopný špecifikovať, ktorú procedúru cituje; právnik spoliehajúci sa na zmluvu musí byť schopný dohľadať späť k tejto zmluve. Bez citácií produkuje systém RAG neoveriteľné tvrdenia.

Správa knižníc

# Zoznam knižníc
libraries = client.beta.libraries.list()
for lib in libraries.data:
    print(f"{lib.name} ({lib.id})")

# Zoznam dokumentov v knižnici
documents = client.beta.libraries.documents.list(library_id=library.id)
for doc in documents.data:
    print(f"{doc.name} — {doc.size} bajtov")

# Vymazanie dokumentu z knižnice
client.beta.libraries.documents.delete(
    library_id=library.id,
    document_id=document.id
)

# Vymazanie knižnice
client.beta.libraries.delete(library_id=library.id)

Odstraňovanie dokumentov je najčastejšie prehliadanou operáciou a v prípade zabudnutia tou najdrahšou. Zastaraná verzia cenníka alebo procedúry zostáva pre agenta navždy citovateľná a nesie všetky znaky legitímnosti, pretože pochádza zo zdroja. Urob si z odstraňovania dokumentu reflex vždy, keď publikuješ novú verziu.

Od internej podpory po analýzu zmlúv

Interná podpora je najbezprostrednejším prípadom použitia: zamestnanci kladú otázky týkajúce sa HR v prirodzenom jazyku namiesto prehrabávania sa intranetom.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Interná podpora",
    instructions="Odpovedaj na otázky zamestnancov využívajúc databázu HR dokumentácie.",
    tools=[{"type": "document_library", "library_ids": [rh_library.id]}]
)

Analýza zmlúv mení paradigmu: agent nielen vyhľadáva, ale aj skúma. Inštrukcie tu opisujú úlohu, nielen rozsah.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Analytik zmlúv",
    instructions="""Analyzuj nahrané zmluvy.
- Identifikuj dôležité klauzuly
- Označ potenciálne riziká
- Porovnávaj s priemyselnými štandardmi""",
    tools=[{"type": "document_library", "library_ids": [contrats_library.id]}]
)

Nakoniec, znalostná báza produktov ilustruje kombináciu nástrojov: oficiálna dokumentácia má prednosť a webové vyhľadávanie vypĺňa medzery tam, kde dokumentácia otázku nepokrýva.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Produktový expert",
    instructions="Odpovedaj na technické otázky týkajúce sa našich produktov na základe oficiálnej dokumentácie.",
    tools=[
        {"type": "document_library", "library_ids": [docs_library.id]},
        {"type": "web_search"}  # Záložné riešenie, ak dokumentácia nestačí
    ]
)

Príprava zdrojov a izolácia knižníc

Kvalita RAG je určená skôr, než vôbec zavoláš API. Štruktúrované PDF s jasnými nadpismi, podnadpismi a odlišnými odsekmi sa oveľa lepšie rozdeľuje na časti a vyhľadáva než plochý sken alebo dokument, kde celá logika spočíva v rozložení stránky. Ďalej oddeľuj svoje knižnice podľa domény namiesto vytvárania jedného všeobecného úložiska. Agent pripojený iba k právnej knižnici nebude riskovať citovanie HR memoranda pri odpovedi na otázku týkajúcu sa zmluvy. Tieto dve rozhodnutia – vylepšenie štruktúry zdrojov a izolácia knižníc – majú na konečný výsledok väčší vplyv než akékoľvek ladenie modelu.

Kľúčové poznatky

  • document_library je vstavaný RAG – nemusíš spravovať vlastnú vektorovú infraštruktúru
  • Vytváraj tematické knižnice a nahrávaj dokumenty prostredníctvom Files API
  • Odpovede citujú relevantné pasáže pomocou častí tool_reference
  • Jednému agentovi môžeš priradiť viacero knižníc
  • Kombinuj s inými nástrojmi pre komplexné pokrytie