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

Εργαλείο web_search: Αναζήτηση στο Διαδίκτυο σε Πραγματικό Χρόνο

Μάθημα 8 / 18 Ενημερώθηκε 2 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Τα Τέσσερα Ενσωματωμένα Εργαλεία της Mistral
  2. Λεπτομέρειες για το Web Search
  3. Εκτέλεση Αναζήτησης
  4. Δομή της Απάντησης
  5. Χρήση Άμεσης Λειτουργίας (Χωρίς Πράκτορα)
  6. Βέλτιστες Πρακτικές που Κάνουν τη Διαφορά
  7. Βασικά σημεία

Τα Τέσσερα Ενσωματωμένα Εργαλεία της Mistral

Αυτό το μάθημα εγκαινιάζει την ενότητα για τα ενσωματωμένα εργαλεία. Πριν εμβαθύνουμε στο πρώτο, αφιερώστε ένα λεπτό για να επισκοπήσετε τα τέσσερα εργαλεία που διατίθενται στο Agents API και τις ανάγκες που καλύπτουν.

Εργαλείο Τύπος Περιγραφή Περίπτωση Χρήσης
Web Search web_search Αναζήτηση στο διαδίκτυο σε πραγματικό χρόνο Ειδήσεις, παρακολούθηση, επαλήθευση γεγονότων
Code Interpreter code_interpreter Εκτέλεση κώδικα Python σε απομονωμένο περιβάλλον (sandbox) Υπολογισμοί, ανάλυση δεδομένων, γραφήματα
Image Generation image_generation Δημιουργία εικόνων από κείμενο Εικονογραφήσεις, προσχέδια, δημιουργικό έργο
Document Library document_library RAG σε μεταφορτωμένα έγγραφα Ερωταποκρίσεις αρχείων, εξαγωγή, σύνοψη

Αυτά τα εργαλεία εκτελούνται στο περιβάλλον cloud της Mistral—δεν χρειάζεται να διαχειριστείτε καμία υποδομή από την πλευρά σας. Αυτή είναι μια θεμελιώδης διαφορά από την κλασική κλήση συναρτήσεων (function calling), όπου εσείς χειρίζεστε την εκτέλεση: εδώ, εσείς δηλώνετε μια δυνατότητα και ο πάροχος διαχειρίζεται το απομονωμένο περιβάλλον (sandbox), τις εξαρτήσεις και την κλιμάκωση.

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

Η διαμόρφωση ενός πράκτορα με αυτό το εργαλείο απαιτεί μόνο λίγες γραμμές κώδικα.

from mistralai.client import Mistral
import os

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

agent = client.beta.agents.create(
    model="mistral-medium-latest",
    name="Web Search Agent",
    instructions="You perform web searches to answer questions. Always cite your sources.",
    tools=[{"type": "web_search"}],
    completion_args={"temperature": 0.3, "top_p": 0.95}
)

Εκτέλεση Αναζήτησης

Κάνετε ερώτημα σε αυτόν τον πράκτορα όπως σε οποιονδήποτε άλλον: η απόφαση για αναζήτηση ανήκει στον πράκτορα.

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Who won the most recent European Football Championship?"
)

Πίσω από αυτή την απλή κλήση κρύβεται μια ολόκληρη αλυσίδα γεγονότων. Ο πράκτορας αναλύει πρώτα την ερώτηση για να καθορίσει εάν οι δικές του γνώσεις είναι επαρκείς—εδώ, η φράση «πιο πρόσφατο» υπονοεί πληροφορίες με ημερομηνία, οπότε δεν είναι. Στη συνέχεια, διαμορφώνει ένα βελτιστοποιημένο ερώτημα αναζήτησης, συχνά διαφορετικό από τη δική σας πρόταση, απαλλαγμένο από συνομιλιακές φράσεις. Εκτελεί την αναζήτηση και στη συνέχεια συνθέτει τα αποτελέσματα με συνημμένες παραπομπές. Δεν ελέγχετε κανένα από αυτά τα βήματα, αλλά μπορείτε να τα δείτε όλα στην απάντηση.

Δομή της Απάντησης

Η απάντηση περιέχει πολλές διαδοχικές εγγραφές που πρέπει να επαναλάβετε με τη σειρά.

for entry in response.outputs:
    print(f"--- {entry.type} ---")

    if entry.type == "tool.execution":
        # Λεπτομέρειες της αναζήτησης που πραγματοποιήθηκε
        print(f"Tool: {entry.tool_name}")

    elif 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} — {chunk.url}")

Θα δείτε πρώτα μια εγγραφή tool.execution, η οποία μεταφέρει τα μεταδεδομένα της λειτουργίας, συμπεριλαμβανομένου του πραγματικού ερωτήματος που στάλθηκε στη μηχανή αναζήτησης. Αυτό είναι το σημείο που πρέπει να ελέγξετε όταν μια απάντηση φαίνεται εκτός θέματος, καθώς συχνά θα διαπιστώσετε ότι η διατύπωση έχει παρεκκλίνει. Η εγγραφή message.output μεταφέρει στη συνέχεια τη συνθετική απάντηση, χωρισμένη σε τμήματα text και tool_reference—εξ ου και ο εμφωλευμένος βρόχος στον παραπάνω κώδικα.

Χρήση Άμεσης Λειτουργίας (Χωρίς Πράκτορα)

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

response = client.beta.conversations.start(
    model="mistral-large-latest",
    inputs=[{"role": "user", "content": "Latest news on Mistral AI"}],
    tools=[{"type": "web_search"}]
)

Βέλτιστες Πρακτικές που Κάνουν τη Διαφορά

Ξεκινήστε κάνοντας ακριβείς ερωτήσεις. Ο πράκτορας μετατρέπει την ερώτησή σας σε ερώτημα αναζήτησης: το «πες μου για την ΤΝ» θα αποδώσει γενικά αποτελέσματα, ενώ το «ποιοι ευρωπαϊκοί κανονισμοί για την ΤΝ υιοθετήθηκαν το 2026;» στοχεύει άμεσα σε σελίδες με actionable πληροφορίες. Αυτός ο κανόνας ισχύει και για τις ερωτήσεις που κάνουν οι χρήστες σας: εάν η διεπαφή σας επιτρέπει αόριστα αιτήματα, συμπεριλάβετε ένα βήμα στις οδηγίες σας για διατύπωση εκ νέου ή ερωτήσεις διευκρίνισης.

Στη συνέχεια, ελέγξτε τη θερμοκρασία (temperature). Για εργασίες βασισμένες σε γεγονότα, μια χαμηλή τιμή—μεταξύ 0,2 και 0,4—μειώνει τις παραισθήσεις κατά τη σύνθεση των αποτελεσμάτων. Η αναζήτηση παρέχει την πρώτη ύλη, αλλά το μοντέλο κάνει ακόμα τη συγγραφή και τίποτα δεν το εμποδίζει να συμπληρώσει κενά εάν του δοθεί υπερβολική ελευθερία.

Τέλος, επαληθεύστε τις πηγές. Οι παραπομπές είναι αυτόματες, αλλά η συνάφειά τους ποικίλλει: μια ανάρτηση σε φόρουμ και ένα επίσημο κείμενο μοιάζουν παρόμοια σε μια λίστα παραπομπών. Σε κρίσιμα πλαίσια, ανοίξτε τις επιστρεφόμενες διευθύνσεις URL πριν υιοθετήσετε τις πληροφορίες—και εκθέστε τες στους χρήστες σας ώστε να μπορούν να κάνουν το ίδιο.

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

  • Το web_search παρέχει στον πράκτορα πρόσβαση στο διαδίκτυο σε πραγματικό χρόνο
  • Οι απαντήσεις περιλαμβάνουν αυτόματες παραπομπές (τίτλος + URL)
  • Το web_search_premium προσθέτει επαληθευμένες πηγές ειδήσεων
  • Το εργαλείο λειτουργεί με ή χωρίς πράκτορα (η άμεση λειτουργία είναι δυνατή)
  • Συνιστάται χαμηλή θερμοκρασία για εργασίες βασισμένες σε γεγονότα