input_file και attachment_search στο Responses API
Σε αυτήν τη σελίδα
Δύο διαδρομές για το ίδιο μπλοκ
Το Responses API του Grok δέχεται ένα έγγραφο με δύο τρόπους: μέσω του file_id, που σημαίνει ένα αρχείο που έχετε ανεβάσει προηγουμένως, ή μέσω του file_url, μιας δημόσιας διεύθυνσης που το xAI ανακτά τη στιγμή του αιτήματος. Το μπλοκ χρησιμοποιεί το ίδιο όνομα και στις δύο περιπτώσεις, input_file, και η επεξεργασία downstream είναι ίδια: το Grok ενεργοποιεί το εργαλείο attachment_search και εξάγει τα αποσπάσματα που απαντούν στην ερώτησή σας. Αυτό που αλλάζει είναι ο κύκλος ζωής του εγγράφου, η εμπιστευτικότητά του και το κόστος κάθε επαναλαμβανόμενης κλήσης.
Η διαδρομή με file_id
Αφού στείλετε το αρχείο μέσω του POST /v1/files, το αναφέρετε χρησιμοποιώντας το αναγνωριστικό του, μαζί με την ερώτησή σας σε απλό κείμενο:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_id": "file_abc123"
},
{
"type": "input_text",
"text": "What are the main risks mentioned in this report?"
}
]
}
Αυτή η διαδρομή έχει νόημα σε τρεις περιπτώσεις. Η πρώτη είναι οι επαναλαμβανόμενα ερωτήματα: αν η νομική σας ομάδα υποβάλει δεκαπέντε διαδοχικές ερωτήσεις για την ίδια σύμβαση, μια μοναδική μεταφόρτωση ακολουθούμενη από δεκαπέντε αναφορές είναι προτιμότερη από δεκαπέντε μεταφορές του ίδιου PDF. Η δεύτερη είναι η εμπιστευτικότητα, όταν το έγγραφο δεν πρέπει να εκτίθεται πίσω από μια URL προσβάσιμη σε οποιονδήποτε διαθέτει τον σύνδεσμο. Η τρίτη αφορά την αρχιτεκτονική της εφαρμογής σας: αν τα αρχεία μεταφορτώνονται εκ των προτέρων κατά την nightly ingestion, τα αιτήματά σας διαχειρίζονται μόνο αναγνωριστικά.
Η διαδρομή με file_url
Όταν το έγγραφο είναι ήδη δημοσιευμένο κάπου, η μεταφόρτωση καθίσταται περιττό βήμα και μπορείτε να δείξετε απευθείας στη διεύθυνση:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_url": "https://exemple.com/specifications-api.pdf"
},
{
"type": "input_text",
"text": "Summarize the endpoints described in this documentation."
}
]
}
Τυπικές περιπτώσεις χρήσης περιλαμβάνουν ανοιχτή τεκμηρίωση που δεν έχετε λόγο να αποθηκεύσετε, ένα αρχείο φιλοξενούμενο στις δικές σας υποδομές πίσω από μια προσωρινή URL, ή ένα γρήγορο τεστ όπου θέλετε να επαληθεύσετε μια υπόθεση χωρίς να στήσετε ολόκληρη μια διαδικασία μεταφόρτωσης.
Τρεις περιορισμοί συνοδεύουν αυτή την ευκολία, και όλοι σας κοστίζουν σε περιβάλλον παραγωγής. Η URL πρέπει να είναι πραγματικά δημόσια, χωρίς κανέναν έλεγχο ταυτότητας: μια διεύθυνση προστατευμένη με token ή cookie επιστρέφει μια σελίδα σφάλματος στο xAI, την οποία το μοντέλο θα αναλύσει επιμελώς αντί για το έγγραφό σας. Η λήψη προστίθεται στον χρόνο επεξεργασίας του αιτήματος, καθιστώντας τα μεγάλα PDF σημαντικά πιο αργά σε σύγκριση με το file_id. Τέλος, δεν υπάρχει cache στην πλευρά του xAI: κάθε κλήση κατεβάζει εκ νέου το αρχείο, οπότε ένα μοναδικό έγγραφο που ερωτάται πενήντα φορές την ημέρα διασχίζει το δίκτυο πενήντα φορές.
Τι κάνει το attachment_search
Μόλις εμφανιστεί ένα input_file στο αίτημά σας, το Grok ενεργοποιεί το attachment_search χωρίς καμία δική σας ρύθμιση. Η επεξεργασία πραγματοποιείται σε τέσσερα βήματα:
- Εξαγωγή περιεχομένου από το αρχείο: κείμενο, πίνακες, δομή
- Προσωρινή ευρετηρίαση αυτού του περιεχομένου, για τη διάρκεια του αιτήματος
- Αναζήτηση σχετικών αποσπασμάτων με βάση την ερώτησή σας
- Έγχυση αποσπασμάτων στο context του μοντέλου
Εστιάστε στο επίθετο «προσωρινή» στο δεύτερο βήμα, καθώς εξηγεί μια διαφορά κόστους που πολλοί ανακαλύπτουν πολύ αργά: το ευρετήριο ξαναχτίζεται σε κάθε κλήση και εξαφανίζεται μετά. Αυτό είναι ακριβώς το πρόβλημα που λύνουν οι συλλογές (collections) με τη μόνιμη ευρετηρίαση. Σημειώστε επίσης ότι το μοντέλο παραθέτει τα αποσπάσματα που χρησιμοποίησε πραγματικά στην απάντησή του, επιτρέποντάς σας να επαληθεύσετε το έργο του αντί να το πιστέψετε στα λόγια του.
Συνδυασμός πολλαπλών εγγράφων
Τίποτα δεν σας υποχρεώνει να περιοριστείτε σε ένα αρχείο ανά αίτημα. Στοιβάζοντας πολλαπλά μπλοκ input_file, ζητάτε από το μοντέλο να συλλογιστεί πάνω στο σύνολο:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_id": "file_rapport_q1"
},
{
"type": "input_file",
"file_id": "file_rapport_q2"
},
{
"type": "input_text",
"text": "Compare the Q1 and Q2 results."
}
]
}
Το Grok αναλύει και τα δύο έγγραφα και διασταυρώνει πληροφορίες για να απαντήσει, κάτι που ανοίγει τον δρόμο για τριμηνιαίες συγκρίσεις, αναθεωρήσεις διαδοχικών εκδόσεων συμβάσεων ή αντιπαραθέσεις μεταξύ μιας προδιαγραφής και της υλοποίησής της.
Επιλογή μεταξύ των δύο
| Κριτήριο | file_id | file_url |
|---|---|---|
| Προηγούμενη μεταφόρτωση | Ναι | Όχι |
| Εμπιστευτικό αρχείο | Συνιστάται | Αποθαρρύνεται |
| Επαναλαμβανόμενα ερωτήματα | Αποδοτικό (1 μεταφόρτωση) | Αργό (επαναληπτική λήψη) |
| Δημόσιο αρχείο | Εφικτό | Ιδανικό |
| Διαχείριση κύκλου ζωής | Εσείς ελέγχετε | Εξαρτάται από τον host |
Βασικά σημεία
- Το
input_fileμεfile_idαναφέρεται σε ένα μεταφορτωμένο αρχείο, τοfile_urlσε ένα δημόσιο έγγραφο - Το εργαλείο
attachment_searchενεργοποιείται αυτόματα για την εξαγωγή σχετικού περιεχομένου - Μπορείτε να συνδυάσετε πολλαπλά αρχεία σε ένα μοναδικό αίτημα
- Προτιμήστε το
file_idγια εμπιστευτικά ή συχνά ερωτώμενα αρχεία - Προτιμήστε το
file_urlγια δημόσια έγγραφα ή γρήγορα τεστ