collections_search και file_search στο Responses API
Σε αυτήν τη σελίδα
Ενσωμάτωση της αναζήτησης απευθείας στις συνομιλίες
Το endpoint POST /v1/documents/search λειτουργεί καλά για μεμονωμένες ερωτήσεις, αλλά σας αφήνει όλο το έργο της ενορχήστρωσης: διατύπωση του ερωτήματος, ανάκτηση αποσπασμάτων, έγχυσή τους σε ένα prompt και κλήση του μοντέλου. Το Responses API αντιστρέφει αυτό το βάρος. Δηλώνοντας τις συλλογές σας ως εργαλείο, επιτρέπετε στο Grok να αποφασίσει πότε θα κάνει αναζήτηση, τι θα ψάξει και πώς θα το μετατρέψει σε απάντηση. Μεταβαίνετε από μια διαδικασία που οδηγείτε εσείς, σε έναν βοηθό που αναζητά ο ίδιος στα έγγραφά σας.
Το εργαλείο collections_search
Αρκεί να προσθέσετε ένα αντικείμενο στη λίστα 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, θα κρατήσει τις παραγράφους από τη συλλογική σύμβαση της εταιρείας και θα επιστρέψει τον αριθμό των ημερών μαζί με την πηγή τους, χωρίς εσείς να γράψετε ούτε μία γραμμή λογικής ανάκτησης.
Το εργαλείο file_search
Το αντίστοιχο υπάρχει για μεμονωμένα αρχεία, εκείνα που δεν είναι αποθηκευμένα σε συλλογή. Δεν χρειάζεται να το δηλώσετε: ενεργοποιείται αυτόματα μόλις το αίτημά σας περιέχει ένα 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_search | file_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 επιλέγει αυτόματα ποια εργαλεία θα χρησιμοποιήσει με βάση την ερώτηση