Ρόλοι: system, developer, user και assistant
Σε αυτήν τη σελίδα
Οι τέσσερις ρόλοι μηνυμάτων
Κάθε μήνυμα που στέλνετε στο endpoint Chat Completions περιλαμβάνει ένα πεδίο role, το οποίο καθορίζει πώς το μοντέλο Grok θα το ερμηνεύσει. Η κατανόηση αυτών των ρόλων είναι απαραίτητη για τη δομή των συνομιλιών σας και τη λήψη ποιοτικών απαντήσεων.
Το API της xAI αναγνωρίζει τέσσερις ρόλους: system, developer, user και assistant. Ο καθένας έχει συγκεκριμένη θέση και χρήση μέσα στον πίνακα μηνυμάτων.
Ο ρόλος system (ή developer)
Το μήνυμα system έρχεται πρώτο στον πίνακα μηνυμάτων. Ορίζει τη συνολική συμπεριφορά του μοντέλου για ολόκληρη τη συνομιλία: τόνο, μορφή απάντησης, όρια, προσωπικότητα, γλώσσα κ.ο.κ.
{
"role": "system",
"content": "You are a cybersecurity expert. Always respond in English, concisely and technically. If you do not know the answer, state it clearly."
}
Ο ρόλος developer αποτελεί ψευδώνυμο για το system. Οι δύο είναι εναλλάξιμοι στο API της xAI. Η OpenAI εισήγαγε το developer για να αντικατοπτρίζει καλύτερα την πρόθεση: αυτές είναι οι οδηγίες του προγραμματιστή, όχι του «συστήματος».
Βέλτιστες πρακτικές για το μήνυμα system
- Να είστε συγκεκριμένοι: Το «Απαντήστε σε το πολύ 3 προτάσεις» είναι πιο αποτελεσματικό από το «Να είστε συνοπτικοί».
- Ορίστε τη μορφή: Προσδιορίστε αν αναμένετε JSON, Markdown ή λίστες με κουκκίδες.
- Θέστε όρια: Υποδείξτε τι δεν πρέπει να κάνει το μοντέλο.
- Παρέχετε πλαίσιο: Δώστε επιχειρηματικό πλαίσιο («Είστε βοηθός για μια κτηνιατρική κλινική»).
Ο ρόλος user
Τα μηνύματα user αντιπροσωπεύουν την είσοδο του τελικού χρήστη. Αυτές είναι οι ερωτήσεις, τα αιτήματα ή οι οδηγίες που στέλνει το άτομο που αλληλεπιδρά με την εφαρμογή σας.
{
"role": "user",
"content": "What are the 3 most common web vulnerabilities?"
}
Ένα μήνυμα user μπορεί να εμφανιστεί οπουδήποτε στη συνομιλία μετά το μήνυμα system. Σε μια συνομιλία πολλαπλών γύρων, εναλλάσσετε συνήθως μεταξύ μηνυμάτων user και assistant.
Ο ρόλος assistant
Τα μηνύματα assistant αντιπροσωπεύουν τις προηγούμενες απαντήσεις του μοντέλου. Όταν στέλνετε πίσω ένα ιστορικό συνομιλίας, κάθε απάντηση από το Grok επισημαίνεται με αυτόν τον ρόλο.
{
"role": "assistant",
"content": "The three most common web vulnerabilities are:\n1. SQL Injection\n2. Cross-Site Scripting (XSS)\n3. Broken Authentication"
}
Μπορείτε επίσης να χρησιμοποιήσετε τον ρόλο assistant για few-shot prompting: την έγχυση παραδειγμάτων επιθυμητών απαντήσεων πριν από το πραγματικό μήνυμα του χρήστη.
{
"messages": [
{"role": "system", "content": "Classify the sentiment: positive, negative, or neutral."},
{"role": "user", "content": "I love this product!"},
{"role": "assistant", "content": "positive"},
{"role": "user", "content": "Customer service is deplorable."},
{"role": "assistant", "content": "negative"},
{"role": "user", "content": "The delivery arrived yesterday."}
]
}
Σε αυτό το παράδειγμα, οι δύο πρώτες ανταλλαγές user/assistant λειτουργούν ως επίδειξη. Το μοντέλο κατανοεί την αναμενόμενη μορφή και θα εφαρμόσει την ίδια λογική στο τρίτο μήνυμα.
Πλήρης δομή αιτήματος
Ακολουθεί ένα τυπικό αίτημα που συνδυάζει και τους τρεις ρόλους σε μια συνομιλία πολλαπλών γύρων:
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{
"role": "system",
"content": "You are a teaching assistant specialized in mathematics. Explain concepts step by step."
},
{
"role": "user",
"content": "What is a derivative?"
},
{
"role": "assistant",
"content": "A derivative measures the instantaneous rate of change of a function..."
},
{
"role": "user",
"content": "Give me a concrete example."
}
]
}
Η σειρά είναι πάντα η ίδια: πρώτα το system, κατόπιν εναλλαγή user/assistant, με το τελευταίο μήνυμα να είναι υποχρεωτικά user (αυτή είναι η ερώτηση στην οποία πρέπει να απαντήσει το μοντέλο).
Βασικά σημεία
- system/developer: Οδηγίες προγραμματιστή, πάντα πρώτα, ορίζουν τη συνολική συμπεριφορά.
- user: Μηνύματα τελικού χρήστη, ενεργοποιούν τη δημιουργία απάντησης.
- assistant: Προηγούμενες απαντήσεις μοντέλου, χρήσιμες για το ιστορικό και το few-shot prompting.
- Οι ρόλοι
systemκαιdeveloperείναι εναλλάξιμοι στο API της xAI. - Το τελευταίο μήνυμα στον πίνακα πρέπει να είναι μήνυμα
user.