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

Παράμετροι Αιτήματος

Μάθημα 3 / 16 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Έλεγχος της συμπεριφοράς του μοντέλου
  2. Παράμετροι δημιουργίας
  3. Παράμετροι συνομιλίας
  4. Παράμετροι εργαλείων
  5. Σύνοψη παραμέτρων
  6. Βασικά σημεία

Ενημερώθηκε στις 3 Νοεμβρίου 2026. Με βάση την αναφορά του Responses API και τις βέλτιστες πρακτικές της xAI: συνιστώμενη θερμοκρασία 0,7, με ανώτατο όριο το 1· top_p 0,95 ως προεπιλογή· max_output_tokens περιορισμένο στην ορατή απάντηση (128.000 προεπιλογή, ο συλλογισμός εξαιρείται)· η προσπάθεια συλλογισμού (reasoning effort) προορίζεται για τα grok-4.5 έως 4.7. Πηγές: Responses API · Βέλτιστες πρακτικές.

Έλεγχος της συμπεριφοράς του μοντέλου

Πέρα από τα model, input και instructions, το Responses API προσφέρει πολυάριθμες παραμέτρους για τη λεπτομερή ρύθμιση της συμπεριφοράς του Grok. Η κατανόηση αυτών των παραμέτρων σας επιτρέπει να λαμβάνετε απαντήσεις πιο σχετικές, συντομότερες ή πιο δημιουργικές, ανάλογα με τις ανάγκες σας.

Παράμετροι δημιουργίας

temperature

Ελέγχει την τυχαιότητα των απαντήσεων. Το API δέχεται τιμές από 0 έως 2, αλλά οποιαδήποτε τιμή άνω του 1 δειγματοληπτείται ως 1.

{
  "model": "grok-4.7",
  "input": "Write a slogan for a bakery.",
  "temperature": 0.7,
  "top_p": 0.95
}

Οι βέλτιστες πρακτικές της xAI είναι σαφείς: ορίστε το temperature στο 0,7 και μην αποκλίνετε σημαντικά από αυτό, καθώς τα μοντέλα Grok αντιδρούν αρνητικά σε άλλες ρυθμίσεις δειγματοληψίας. Για έναν πιο πραγματιστικό ή δημιουργικό τόνο, προσαρμόστε την εντολή (prompt) αντί για τη θερμοκρασία.

top_p

Δειγματοληψία πυρήνα (Nucleus sampling). Τα τρέχοντα μοντέλα κειμένου έχουν προεπιλογή το 0,95 και οποιαδήποτε τιμή υψηλότερη από την προεπιλογή του μοντέλου μειώνεται σε αυτήν.

{
  "model": "grok-4.7",
  "input": "Summarize this article.",
  "top_p": 0.95
}

Με top_p: 0.95, το μοντέλο λαμβάνει υπόψη μόνο τα tokens που αντιπροσωπεύουν το 95% της πιθανότητας. Η αναφορά του API επαναλαμβάνει την κλασική συμβουλή να προσαρμόζετε μόνο μία από τις δύο παραμέτρους· ωστόσο, οι βέλτιστες πρακτικές της xAI απαιτούν τον ρητό ορισμό και των δύο, στο 0,7 και στο 0,95 αντίστοιχα, σε κάθε αίτημα.

max_output_tokens

Περιορίζει τον αριθμό των tokens στην ορατή απάντηση· ο συλλογισμός και οι κλήσεις συναρτήσεων δεν υπολογίζονται, και η προεπιλεγμένη τιμή είναι 128.000 tokens:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Explain general relativity.",
  "max_output_tokens": 500
}

Για τα μοντέλα συλλογισμού, η προσπάθεια συλλογισμού (reasoning effort) και όχι αυτό το όριο, διέπει την εσωτερική αναστοχαστική διαδικασία. Μια απάντηση που διακόπτεται λόγω του ορίου σηματοδοτείται με την κατάσταση incomplete.

reasoning

Για μοντέλα που υποστηρίζουν συλλογισμό, μπορείτε να προσαρμόσετε την προσπάθεια:

{
  "model": "grok-4.7",
  "input": "Solve this logic problem.",
  "reasoning": {"effort": "high"}
}

Οι πιθανές τιμές είναι low, medium και high (προεπιλογή), καθώς και xhigh στα grok-4.6 και grok-4.7· η παράμετρος εφαρμόζεται στα grok-4.5 έως 4.7, ενώ το grok-4.20-0309-reasoning δεν την δέχεται. Η υψηλή προσπάθεια καταναλώνει περισσότερα tokens και ενδείκνυται για σύνθετα προβλήματα.

Παράμετροι συνομιλίας

store

Καθορίζει εάν η απάντηση αποθηκεύεται στον διακομιστή:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this contract.",
  "store": false
}
  • true: η απάντηση αποθηκεύεται για 30 ημέρες, είναι ανακτήσιμη μέσω GET και usable με previous_response_id
  • false: η απάντηση δεν αποθηκεύεται μόνιμα (ιδιωτική λειτουργία)

previous_response_id

Συνδέει ένα νέο αίτημα με μια υπάρχουσα συνομιλία (αναλύεται λεπτομερώς στο μάθημα 5).

user

Αναγνωριστικό τελικού χρήστη, χρήσιμο για την παρακολούθηση και τη διαχείριση περιεχομένου:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Hello",
  "user": "user-12345"
}

Παράμετροι εργαλείων

tools, tool_choice, parallel_tool_calls, max_turns

Αυτές οι παράμετροι ελέγχουν τη χρήση εργαλείων (web_search, code_interpreter, προσαρμοσμένες συναρτήσεις). Καλύπτονται λεπτομερώς στην ενότητα «Εργαλεία» (μαθήματα 9-12).

Σύνοψη παραμέτρων

ΠαράμετροςΤύποςΠροεπιλογήΧρήση
modelstringrequiredΑναγνωριστικό μοντέλου
inputstring/arrayrequiredΕντολή χρήστη
instructionsstringnullΕντολή συστήματος
temperaturenumber—Συνιστάται 0,7· ανώτατο όριο το 1
top_pnumber0.95Δειγματοληψία πυρήνα
max_output_tokensinteger128,000Όριο ορατής απάντησης
reasoningobjectnullΠροσπάθεια συλλογισμού
storebooleannullΜόνιμη αποθήκευση 30 ημερών
streambooleanfalseΡοή SSE
userstringnullID τελικού χρήστη

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

  • Η xAI συνιστά temperature στο 0,7 και top_p στο 0,95, με ρητό ορισμό
  • Το max_output_tokens περιορίζει μόνο την ορατή απάντηση, εξαιρώντας τον συλλογισμό
  • Το store: true διατηρεί την απάντηση για 30 ημέρες, επιτρέποντας τη συνέχιση της συνομιλίας
  • Το reasoning.effort σας επιτρέπει να κλιμακώνετε την αναστοχαστική ικανότητα του μοντέλου βάσει της πολυπλοκότητας του έργου
  • Η παράμετρος user διευκολύνει την παρακολούθηση και τη διαχείριση περιεχομένου από την πλευρά της xAI