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

input_file και attachment_search στο Responses API

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

Δύο διαδρομές για το ίδιο μπλοκ

Το 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: κάθε κλήση κατεβάζει εκ νέου το αρχείο, οπότε ένα μοναδικό έγγραφο που ερωτάται πενήντα φορές την ημέρα διασχίζει το δίκτυο πενήντα φορές.

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

  1. Εξαγωγή περιεχομένου από το αρχείο: κείμενο, πίνακες, δομή
  2. Προσωρινή ευρετηρίαση αυτού του περιεχομένου, για τη διάρκεια του αιτήματος
  3. Αναζήτηση σχετικών αποσπασμάτων με βάση την ερώτησή σας
  4. Έγχυση αποσπασμάτων στο 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_idfile_url
Προηγούμενη μεταφόρτωσηΝαιΌχι
Εμπιστευτικό αρχείοΣυνιστάταιΑποθαρρύνεται
Επαναλαμβανόμενα ερωτήματαΑποδοτικό (1 μεταφόρτωση)Αργό (επαναληπτική λήψη)
Δημόσιο αρχείοΕφικτόΙδανικό
Διαχείριση κύκλου ζωήςΕσείς ελέγχετεΕξαρτάται από τον host

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

  • Το input_file με file_id αναφέρεται σε ένα μεταφορτωμένο αρχείο, το file_url σε ένα δημόσιο έγγραφο
  • Το εργαλείο attachment_search ενεργοποιείται αυτόματα για την εξαγωγή σχετικού περιεχομένου
  • Μπορείτε να συνδυάσετε πολλαπλά αρχεία σε ένα μοναδικό αίτημα
  • Προτιμήστε το file_id για εμπιστευτικά ή συχνά ερωτώμενα αρχεία
  • Προτιμήστε το file_url για δημόσια έγγραφα ή γρήγορα τεστ