Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Εργαλείο document_library: Ερωταποκρίσεις στα αρχεία σας

Μάθημα 11 / 18 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Ενσωματωμένο RAG της Mistral
  2. Δημιουργία Βιβλιοθήκης Εγγράφων
  3. Μεταφόρτωση Εγγράφων
  4. Δημιουργία Πράκτορα με Βιβλιοθήκη Εγγράφων
  5. Ερωτήματα στα Έγγραφα
  6. Διαχείριση Βιβλιοθηκών
  7. Από Εσωτερική Υποστήριξη σε Ανάλυση Συμβάσεων
  8. Προετοιμασία Πηγών, Απομόνωση Βιβλιοθηκών
  9. Βασικά σημεία

Το μάθημα ενημερώθηκε στις 3 Νοεμβρίου 2026 με βάση το SDK mistralai 3.7.0: τα έγγραφα της βιβλιοθήκης διαχειρίζονται μέσω του client.beta.libraries.documents (upload, list, delete). Οι μέθοδοι add_document, list_documents και remove_document της προηγούμενης έκδοσης δεν υπάρχουν πλέον, και οι μεταφορτώσεις γίνονται απευθείας στη βιβλιοθήκη. Πηγή: client-python.

Ενσωματωμένο RAG της Mistral

Το εργαλείο document_library είναι ένα σύστημα Retrieval-Augmented Generation (RAG) ενσωματωμένο απευθείας στο Agents API. Ο πράκτοράς σας αποκτά πρόσβαση σε έγγραφα που έχετε μεταφορτώσει στο cloud της Mistral, ανακτά τα σχετικά αποσπάσματα και διαμορφώνει την απάντησή του με παραπομπές. Η διαφορά σε σχέση με μια οικεία λύση RAG είναι σημαντική: δεν χρειάζεται να φιλοξενήσετε βάση δεδομένων διανυσμάτων, να συντηρήσετε αγωγό ενσωμάτωσης (embedding pipeline) ή να ρυθμίσετε στρατηγική τμηματοποίησης. Απλώς μεταφορτώνετε αρχεία, δηλώνετε το εργαλείο κατά τη δημιουργία του πράκτορα και αφήνετε το μοντέλο να αποφασίσει πότε θα κάνει ερώτημα στη βιβλιοθήκη.

Δημιουργία Βιβλιοθήκης Εγγράφων

Μια βιβλιοθήκη είναι ο περιέκτης που φιλοξενεί τα έγγραφά σας. Τη δημιουργείτε με μία μόνο κλήση API πριν μεταφορτώσετε οποιαδήποτε αρχεία.

from mistralai.client import Mistral
import os

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

# Create a library
library = client.beta.libraries.create(
    name="Technical Documentation",
    description="Product manuals and technical specifications."
)

print(f"Library ID: {library.id}")

Σημειώστε το ID που επιστρέφεται: αυτό είναι που περνάτε στον πράκτορα. Δεν υπάρχει συντόμευση χρησιμοποιώντας το όνομα της βιβλιοθήκης. Εάν η ομάδα σας διαχειρίζεται ξεχωριστές βιβλιοθήκες για Ανθρώπινο Δυναμικό, Νομικά θέματα και Τεχνικά έγγραφα, αποθηκεύστε αυτά τα IDs στη διαμόρφωσή σας ακριβώς όπως τα connection strings.

Μεταφόρτωση Εγγράφων

Η μεταφόρτωση γίνεται σε δύο βήματα: πρώτον, το αρχείο εναποτίθεται στον χώρο Files με έναν ρητό purpose, και στη συνέχεια συνδέεται με τη βιβλιοθήκη.

# Upload a PDF directly to the library
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"Document {document.id}: {document.processing_status}")

Οι υποστηριζόμενες μορφές περιλαμβάνουν PDF, απλό κείμενο και άλλους κοινούς τύπους εγγράφων.

Δημιουργία Πράκτορα με Βιβλιοθήκη Εγγράφων

agent = client.beta.agents.create(
    model="mistral-medium-latest",
    name="Documentation Agent",
    instructions="""You are a documentation assistant.
- Answer only using documents from the library
- Cite relevant passages
- If the information is not in the documents, state this clearly""",
    tools=[{
        "type": "document_library",
        "library_ids": [library.id]
    }]
)

Η παράμετρος library_ids είναι μια λίστα: μπορείτε να συνδέσετε πολλαπλές βιβλιοθήκες με έναν μόνο πράκτορα. Για παράδειγμα, ένας βοηθός υποστήριξης μπορεί να χρησιμοποιήσει τόσο την τεκμηρίωση προϊόντος όσο και τις εσωτερικές διαδικασίες. Εδώ, οι οδηγίες είναι κάτι περισσότερο από απλή πολυτέλεια. Χωρίς την εντολή να περιορίζονται οι απαντήσεις στα έγγραφα, το μοντέλο συμπληρώνει τα κενά με τις γενικές γνώσεις του και χάνετε την ικανότητα να διακρίνετε τι προέρχεται από τα αρχεία σας και τι από αλλού. Η τρίτη γραμμή—η ρητή δήλωση όταν λείπουν πληροφορίες—είναι αυτό που μετατρέπει έναν φλύαρο πράκτορα σε αξιόπιστο.

Ερωτήματα στα Έγγραφα

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="How does the Pixtral 12B vision encoder work?"
)

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"  [Source] {chunk.title}")

Όπως και στην αναζήτηση ιστού, η απάντηση φτάνει σε τμήματα δύο τύπων. Τα τμήματα text περιέχουν τη γραπτή απάντηση· τα τμήματα tool_reference περιέχουν την προέλευση, με το πεδίο title να κρατά το όνομα του πηγιαίου εγγράφου και το πεδίο url να παρέχει την εσωτερική αναφορά μέσα σε εκείνο το έγγραφο. Αυτός ο διαχωρισμός σάς επιτρέπει να εμφανίζετε την απάντηση και, ακριβώς από κάτω, τη λίστα των εγγράφων που την παρήγαγαν.

Αυτή η ιχνηλασιμότητα δεν είναι απλώς διακοσμητική. Ένας σύμβουλος που απαντά σε έναν πελάτη βάσει μιας εσωτερικής διαδικασίας πρέπει να μπορεί να specifies ποια διαδικασία επικαλείται· ένας δικηγόρος που βασίζεται σε μια σύμβαση πρέπει να μπορεί να εντοπίσει πίσω σε εκείνη τη σύμβαση. Χωρίς παραπομπές, ένα σύστημα RAG παράγει μη επαληθεύσιμους ισχυρισμούς.

Διαχείριση Βιβλιοθηκών

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

# List documents in a library
documents = client.beta.libraries.documents.list(library_id=library.id)
for doc in documents.data:
    print(f"{doc.name} — {doc.size} bytes")

# Delete a document from the library
client.beta.libraries.documents.delete(
    library_id=library.id,
    document_id=document.id
)

# Delete the library
client.beta.libraries.delete(library_id=library.id)

Η αφαίρεση εγγράφων είναι η πιο συχνά παραβλεπόμενη λειτουργία και η πιο δαπανηρή όταν ξεχνιέται. Μια ξεπερασμένη έκδοση ενός τιμοκαταλόγου ή μιας διαδικασίας παραμένει διαθέσιμη για παράθεση από τον πράκτορα επ’ αόριστον, φέροντας όλα τα προσχήματα νομιμότητας επειδή προέρχεται από πηγή. Κάντε την αφαίρεση ενός εγγράφου αντανακλαστική κίνηση κάθε φορά που δημοσιεύετε μια νέα έκδοση.

Από Εσωτερική Υποστήριξη σε Ανάλυση Συμβάσεων

Η εσωτερική υποστήριξη είναι η πιο άμεση περίπτωση χρήσης: οι εργαζόμενοι κάνουν ερωτήσεις στο Τμήμα Ανθρώπινου Δυναμικού σε φυσική γλώσσα αντί να ψάχνουν σε ένα intranet.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Internal Support",
    instructions="Answer employee questions using the HR documentation base.",
    tools=[{"type": "document_library", "library_ids": [rh_library.id]}]
)

Η ανάλυση συμβάσεων αλλάζει το παράδειγμα: ο πράκτορας δεν απλώς ανακτά, αλλά εξετάζει. Εδώ, οι οδηγίες περιγράφουν μια εργασία, όχι απλώς ένα πεδίο εφαρμογής.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Contract Analyst",
    instructions="""Analyze uploaded contracts.
- Identify important clauses
- Flag potential risks
- Compare against industry standards""",
    tools=[{"type": "document_library", "library_ids": [contrats_library.id]}]
)

Τέλος, μια βάση γνώσεων προϊόντων illustrates τον συνδυασμό εργαλείων: η επίσημη τεκμηρίωση έχει προτεραιότητα και η αναζήτηση ιστού καλύπτει τα κενά όταν η τεκμηρίωση δεν απαντά σε μια ερώτηση.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Product Expert",
    instructions="Answer technical questions about our products based on official documentation.",
    tools=[
        {"type": "document_library", "library_ids": [docs_library.id]},
        {"type": "web_search"}  # Fallback if docs are insufficient
    ]
)

Προετοιμασία Πηγών, Απομόνωση Βιβλιοθηκών

Η ποιότητα του RAG καθορίζεται πριν καν καλέσετε το API. Ένα δομημένο PDF με σαφείς επικεφαλίδες, υπο-επικεφαλίδες και διακριτές παραγράφους τμηματοποιείται και ανακτάται πολύ καλύτερα από ένα επίπεδο σαρωμένο αρχείο ή ένα έγγραφο όπου όλη η λογική resides στη διάταξη. Στη συνέχεια, διαχωρίστε τις βιβλιοθήκες σας ανά τομέα αντί να δημιουργήσετε έναν μόνο κάδο για όλα. Ένας πράκτορας συνδεδεμένος μόνο στη νομική βιβλιοθήκη δεν θα ρισκάρει να παραθέσει ένα σημείωμα του Τμήματος Ανθρώπινου Δυναμικού για να απαντήσει σε ερώτηση σύμβασης. Αυτές οι δύο αποφάσεις—η βελτίωση της δομής της πηγής και η απομόνωση των βιβλιοθηκών—επηρεάζουν το τελικό αποτέλεσμα περισσότερο από οποιαδήποτε ρύθμιση του μοντέλου.

Βασικά σημεία

  • Το document_library είναι ενσωματωμένο RAG—δεν χρειάζεται να διαχειριστείτε τη δική σας υποδομή διανυσμάτων
  • Δημιουργήστε θεματικές βιβλιοθήκες και μεταφορτώστε έγγραφα μέσω του Files API
  • Οι απαντήσεις παραθέτουν σχετικά αποσπάσματα χρησιμοποιώντας τμήματα tool_reference
  • Μπορείτε να συνδέσετε πολλαπλές βιβλιοθήκες με έναν μόνο πράκτορα
  • Συνδυάστε με άλλα εργαλεία για ολοκληρωμένη κάλυψη