Δημιουργία και διαχείριση συλλογών
Σε αυτήν τη σελίδα
Από μεμονωμένα αρχεία σε βάση γνώσεων
Μέχρι τώρα, κάθε έγγραφο στεκόταν μόνο του: το ανεβάζατε, το αναφέρατε και ο ευρετηριασμός που δημιουργούνταν για την περίσταση εξαφανιζόταν μαζί με το ερώτημα. Οι συλλογές αλλάζουν την κλίμακα: ομαδοποιούν τα αρχεία σας σε δομημένες βάσεις γνώσεων, οι οποίες ευρετηριάζονται μία φορά και μπορούν να αναζητηθούν επ’ αόριστον. Αυτή είναι η βάση του RAG (Retrieval-Augmented Generation) με το Grok, και η διαφορά γίνεται αντιληπτή μόλις μια ομάδα υποστήριξης αναζητήσει σε διακόσια φύλλα προϊόντων αντί για ένα μόνο PDF.
Σκεφτείτε μια συλλογή ως έναν έξυπνο φάκελο. Αποθέτετε έγγραφα, το xAI τα ευρετηριάζει για σημασιολογική αναζήτηση και το Grok αναζητά σε αυτή τη βάση για να απαντήσει με ακρίβεια, αντλώντας τα τρία χρήσιμα αποσπάσματα από χιλιάδες.
Ένα ξεχωριστό API και ο λόγος
Δεν διαχειρίζεστε τις συλλογές από το API που χρησιμοποιούσατε από την αρχή του μαθήματος. Αυτές εμπίπτουν στο Management API, το οποίο φιλοξενείται στο management-api.x.ai, με τη βασική διεύθυνση URL:
https://management-api.x.ai/v1
Αυτός ο διαχωρισμός δεν είναι αρχιτεκτονική ιδιοτροπία. Η δημιουργία, η τροποποίηση ή η διαγραφή μιας συλλογής αποτελούν διοικητικές λειτουργίες με σοβαρές συνέπειες και το xAI απαιτεί ένα αφιερωμένο κλειδί για αυτές: ένα Management API Key, με την άδεια AddFileToCollection. Το όφελος είναι άμεσο για τις ομάδες: η υπηρεσία που αναζητά στη βάση από τη δημόσια εφαρμογή σας λαμβάνει το τυπικό κλειδί και δεν μπορεί να καταστρέψει τίποτα· μόνο ο αγωγός εισαγωγής δεδομένων (ingestion pipeline) σας κατέχει το κλειδί διαχείρισης.
Δημιουργήστε την πρώτη σας συλλογή
Η δημιουργία ανάγεται σε μια απλή κλήση με ένα όνομα:
curl -X POST https://management-api.x.ai/v1/collections \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"collection_name": "technical-docs"}'
Η απόκριση επιστρέφει το αναγνωριστικό που πρέπει να κρατήσετε:
{
"collection_id": "col_xyz789",
"collection_name": "technical-docs",
"created_at": "2026-04-01T10:00:00Z"
}
Επιλέξτε αυτό το όνομα προσεκτικά: θα εμφανίζεται σε όλες τις λίστες σας και, έξι μήνες αργότερα, θα είναι η μόνη ένδειξη που θα σας επιτρέπει να διακρίνετε δύο γειτονικές βάσεις. Το technical-docs επιτελεί αυτόν τον ρόλο· το test2 όχι. Υιοθετήστε μια σύμβαση από την πρώτη συλλογή, επειδή η μετονομασία μιας βάσης στην οποία αναφέρονται ήδη τρεις εφαρμογές κοστίζει περισσότερο από το να της δώσετε ένα καλό όνομα εξαρχής.
Οι πέντε διαθέσιμες λειτουργίες
Το Management API εκθέτει ένα πλήρες σύνολο CRUD για τις συλλογές:
| Λειτουργία | Μέθοδος | Τερματικό σημείο (Endpoint) |
|---|---|---|
| Δημιουργία | POST | /v1/collections |
| Λίστα | GET | /v1/collections |
| Λεπτομέρειες | GET | /v1/collections/{collection_id} |
| Ενημέρωση | PUT | /v1/collections/{collection_id} |
| Διαγραφή | DELETE | /v1/collections/{collection_id} |
Η λίστα των συλλογών σας γίνεται χωρίς παραμέτρους και παρέχει μια χρήσιμη επισκόπηση πριν από οποιαδήποτε λειτουργία συντήρησης:
curl https://management-api.x.ai/v1/collections \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Η διαγραφή ακολουθεί την ίδια λογική, ορίζοντας το αναγνωριστικό που αποκτήθηκε κατά τη δημιουργία:
curl -X DELETE https://management-api.x.ai/v1/collections/col_xyz789 \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Ένα πράγμα πρέπει να σας καθησυχάζει όταν εκτελείτε αυτή την εντολή: η διαγραφή μιας συλλογής αφαιρεί τον ευρετηριασμό, όχι τα αρχεία. Τα έγγραφά σας παραμένουν προσβάσιμα μέσω του Files API και μπορούν να ευρετηριαστούν εκ νέου αλλού. Χάνετε τη δομή αναζήτησης, όχι την πρώτη ύλη—γεγονός που καθιστά την ανοικοδόμηση μιας κακώς οργανωμένης βάσης πολύ λιγότερο επικίνδυνη από ό,τι φαίνεται.
Βασικά σημεία
- Οι συλλογές ομαδοποιούν τα αρχεία σας σε ευρετηριασμένες βάσεις γνώσεων για RAG
- Η διαχείριση γίνεται μέσω του Management API (
management-api.x.ai), όχι του τυπικού API - Απαιτείται ένα Management API Key με την άδεια
AddFileToCollection - Τα όρια είναι 100.000 αρχεία και 100 GB ανά λογαριασμό
- Οι πέντε λειτουργίες CRUD καλύπτουν τη δημιουργία, την ανάγνωση, την ενημέρωση και τη διαγραφή