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

collections_search και file_search στο Responses API

Μάθημα 11 / 16 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Ενσωμάτωση της αναζήτησης απευθείας στις συνομιλίες
  2. Το εργαλείο collections_search
  3. Το εργαλείο file_search
  4. Δύο μηχανισμοί, δύο δομές κόστους
  5. Συνδυασμός πολλαπλών εργαλείων
  6. Βελτιστοποίηση της συμπεριφοράς των εργαλείων
  7. Βασικά σημεία

Ενσωμάτωση της αναζήτησης απευθείας στις συνομιλίες

Το endpoint POST /v1/documents/search λειτουργεί καλά για μεμονωμένες ερωτήσεις, αλλά σας αφήνει όλο το έργο της ενορχήστρωσης: διατύπωση του ερωτήματος, ανάκτηση αποσπασμάτων, έγχυσή τους σε ένα prompt και κλήση του μοντέλου. Το Responses API αντιστρέφει αυτό το βάρος. Δηλώνοντας τις συλλογές σας ως εργαλείο, επιτρέπετε στο Grok να αποφασίσει πότε θα κάνει αναζήτηση, τι θα ψάξει και πώς θα το μετατρέψει σε απάντηση. Μεταβαίνετε από μια διαδικασία που οδηγείτε εσείς, σε έναν βοηθό που αναζητά ο ίδιος στα έγγραφά σας.

Αρκεί να προσθέσετε ένα αντικείμενο στη λίστα tools για να ενεργοποιήσετε αυτή την πρόσβαση:

response = await client.responses.create(
    model="grok-4.5",
    input="What is our paternity leave policy?",
    tools=[
        {
            "type": "collections_search",
            "collection_ids": ["col_rh_policies"]
        }
    ]
)

Πίσω από αυτή την απλή κλήση, το Grok αναλύει την ερώτηση, διατυπώνει ένα ερώτημα αναζήτησης προσαρμοσμένο στη συλλογή, ανακτά τα σχετικά αποσπάσματα, τα συνοψίζει και παραθέτει τα έγγραφα που χρησιμοποιήθηκαν. Στην πράξη, για την παραπάνω ερώτηση, θα μεταφράσει το «paternity leave» σε μια αναζήτηση στο col_rh_policies, θα κρατήσει τις παραγράφους από τη συλλογική σύμβαση της εταιρείας και θα επιστρέψει τον αριθμό των ημερών μαζί με την πηγή τους, χωρίς εσείς να γράψετε ούτε μία γραμμή λογικής ανάκτησης.

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

response = await client.responses.create(
    model="grok-4.5",
    input=[
        {
            "type": "input_file",
            "file_id": "file_contrat_abc"
        },
        {
            "type": "input_text",
            "text": "Does this contract contain a non-compete clause?"
        }
    ]
)

Είναι το εργαλείο attachment_search, ισοδύναμο με το file_search, που ενεργοποιείται στο παρασκήνιο. Αυτή η υπονοούμενη συμπεριφορά εξηγεί μια συχνή σύγχυση: οι χρήστες αναρωτιούνται γιατί η δήλωση του file_search στα tools φαίνεται να μην έχει κανένα αποτέλεσμα, όταν στην πραγματικότητα είναι απλώς περιττή.

Δύο μηχανισμοί, δύο δομές κόστους

Πτυχήcollections_searchfile_search / attachment_search
ΠηγήΕυρετηριασμένη/-ες συλλογή/-έςΜεμονωμένο/-α αρχείο/-α
ΔήλωσηΡητή στα toolsΑυτόματη με input_file
ΕυρετηρίασηΠρο-υπολογισμένηΕν κινήσει (On the fly)
Κόστος$2.50 / 1.000$10 / 1.000
ΑπόδοσηΓρήγορη (υφιστάμενο ευρετήριο)Πιο αργή (ευρετηρίαση σε πραγματικό χρόνο)
ΧρήσηΜόνιμη βάση γνώσεωνΕφάπαξ ανάλυση

Η γραμμή «Ευρετηρίαση» καθορίζει όλες τις άλλες. Μια συλλογή ευρετηριάζεται μία και μόνο φορά, οπότε κάθε ερώτηση επαναχρησιμοποιεί αυτή την εργασία: είναι γρήγορη και χρεώνεται με $2.50 ανά χίλιες κλήσεις. Ένα συνημμένο αρχείο ευρετηριάζεται με κάθε αίτημα, εξ ου και η πρόσθετη καθυστέρηση και τα $10 ανά χίλια. Η σύμβαση που ο νομικός σας σύμβουλος αναλύει μία φορά εμπίπτει στη δεύτερη κατηγορία· το αρχείο HR που ερωτάται εκατό φορές την ημέρα εμπίπτει προφανώς στην πρώτη.

Συνδυασμός πολλαπλών εργαλείων

Το πραγματικό όφελος αυτής της προσέγγισης εμφανίζεται όταν δίνετε στο Grok πολλά από αυτά, επιτρέποντάς του να επιλέξει εκείνα που εξυπηρετούν την ερώτηση.

response = await client.responses.create(
    model="grok-4.5",
    input="Compare our internal policy with the latest European regulations on the subject.",
    tools=[
        {
            "type": "collections_search",
            "collection_ids": ["col_politiques_internes"]
        },
        {
            "type": "web_search"
        }
    ]
)

Αυτή η ερώτηση απαιτεί δύο διαδοχικές κινήσεις: το Grok πρώτα ερωτά τη συλλογή για να βρει την εσωτερική σας πολιτική, στη συνέχεια εκκινεί μια αναζήτηση στο διαδίκτυο για τους ισχύοντες ευρωπαϊκούς κανονισμούς και τέλος αντιπαραβάλλει τα δύο στην απάντησή του. Καμία ενορχήστρωση από την πλευρά σας, καμία εντολή if για να αποφασίσετε ποια από τις δύο πηγές είναι σχετική—και αν η ερώτηση εστίαζε αποκλειστικά στην εσωτερική σας πολιτική, το διαδίκτυο δεν θα χρησιμοποιούνταν.

Βελτιστοποίηση της συμπεριφοράς των εργαλείων

Τρεις παράμετροι σας επιτρέπουν να αυστηροποιήσετε την αναζήτηση που δηλώνεται στα tools.

tools=[
    {
        "type": "collections_search",
        "collection_ids": ["col_docs_1", "col_docs_2"],
        "max_results": 10,
        "retrieval_mode": "hybrid"
    }
]
  • collection_ids: ερώτημα πολλαπλών συλλογών ταυτόχρονα
  • max_results: περιορισμός του αριθμού των αποτελεσμάτων για μείωση του injected context
  • retrieval_mode: επιλογή της λειτουργίας αναζήτησης (υβριδική/hybrid από προεπιλογή)

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

Τιμολόγηση με ημερομηνία 5 Αυγούστου 2026 — οι τιμές αλλάζουν τακτικά: πριν υπολογίσετε οποιονδήποτε προϋπολογισμό, ελέγξτε την τρέχουσα τιμολόγηση στη επίσημη σελίδα μοντέλων και τιμολόγησης της xAI.

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

  • Το collections_search επιτρέπει στο Grok να ερωτά αυτόματα τις συλλογές σας κατά τη διάρκεια μιας συνομιλίας
  • Το file_search / attachment_search ενεργοποιείται αυτόματα για μεμονωμένα αρχεία
  • Οι συλλογές είναι τέσσερις φορές φθηνότερες και ταχύτερες από τα συνημμένα αρχεία
  • Μπορείτε να συνδυάσετε το collections_search με το web_search και άλλα εργαλεία
  • Το Grok επιλέγει αυτόματα ποια εργαλεία θα χρησιμοποιήσει με βάση την ερώτηση