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

Υλοποίηση με το xAI SDK

Μάθημα 5 / 14 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Το εγγενές xAI SDK
  2. Βασική ρύθμιση
  3. Αίτημα 4 πρακτόρων (γρήγορη λειτουργία)
  4. Αίτημα 16 πρακτόρων (λεπτομερής λειτουργία)
  5. Προσθήκη ενσωματωμένων εργαλείων
  6. Κρυπτογραφημένο περιεχόμενο για συνομιλίες πολλαπλών γύρων
  7. Διαχείριση σφαλμάτων
  8. Βασικά σημεία

Το εγγενές xAI SDK

Το xAI SDK αποτελεί τον πιο άμεσο τρόπο χρήσης της λειτουργίας πολλαπλών πρακτόρων (multi-agent) και είναι το μοναδικό που εκθέτει παραμέτρους όπως το agent_count, τις οποίες τα SDK τρίτων κατασκευαστών δεν διαθέτουν. Εάν ξεκινάτε χωρίς περιορισμούς οικοσυστήματος, ξεκινήστε από εδώ: θα έχετε πρόσβαση στο πλήρες σύνολο ρυθμίσεων.

xai_sdk
Επίσημο πακέτο Python
agent_count
Αποκλειστική παράμετρος
Streaming
Απόκριση σε πραγματικό χρόνο
Εργαλεία
web_search, x_search...

Βασική ρύθμιση

Η αρχικοποίηση του client περιορίζεται σε τρεις εισαγωγές και την ανάγνωση του κλειδιού API σας από το περιβάλλον:

import os
from xai_sdk import Client
from xai_sdk.chat import user

client = Client(api_key=os.getenv("XAI_API_KEY"))

Η μεταβλητή περιβάλλοντος XAI_API_KEY πρέπει να περιέχει το κλειδί API του xAI. Μην ενσωματώνετε ποτέ το κλειδί απευθείας στον κώδικα: θα κατέληγε στο αποθετήριο Git και subsequently στο ιστορικό του, από όπου η αφαίρεσή του είναι δύσκολη.

Αίτημα 4 πρακτόρων (γρήγορη λειτουργία)

Για μια γρήγορη και εστιασμένη αναζήτηση, περνάτε την παράμετρο agent_count=4 κατά τη δημιουργία της συνομιλίας:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=4
)
chat.append(user("Compare TCP and UDP in detail"))

for response, chunk in chat.stream():
    if chunk.content:
        print(chunk.content, end="", flush=True)

Σημειώστε ότι καταναλώνετε την απόκριση μέσω της chat.stream(). Αυτή είναι η συνιστώμενη μέθοδος: χωρίς αυτήν, το πρόγραμμά σας θα «παγώσει» χωρίς κανένα σημάδι ζωής για όλη τη διάρκεια της αναζήτησης και τίποτα δεν θα σας ενημερώνει εάν το αίτημα εκτελείται ακόμα ή έχει καταρρεύσει.

Αίτημα 16 πρακτόρων (λεπτομερής λειτουργία)

Η μετάβαση σε λεπτομερή λειτουργία απαιτεί μόνο την αλλαγή μιας τιμής, αλλά το αίτημα που τη συνοδεύει πρέπει να ανταποκρίνεται στην κλίμακα της ομάδας που αναπτύσσετε:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=16
)
chat.append(user(
    "Give me a complete state of the art on RAG architectures in 2026, "
    "comparing hybrid approaches, performance, and costs"
))

for response, chunk in chat.stream():
    if chunk.content:
        print(chunk.content, end="", flush=True)

Προσθήκη ενσωματωμένων εργαλείων

Προσθέτετε εργαλεία μέσω μιας απλής λίστας και το SDK παρέχει τους αντίστοιχους κατασκευαστές:

from xai_sdk.tools import web_search, x_search

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=4,
    tools=[web_search(), x_search()],
    include=["verbose_streaming"],
)

chat.append(user("What are xAI's latest announcements this week?"))

for response, chunk in chat.stream():
    if chunk.content:
        print(chunk.content, end="", flush=True)

Η παράμετρος include=["verbose_streaming"] αλλάζει το περιεχόμενο που λαμβάνετε: οι κλήσεις εργαλείων εμφανίζονται σε πραγματικό χρόνο ενώ οι πράκτορες εργάζονται, γνωρίζοντας έτσι σε τι εστιάζει η τρέχουσα αναζήτηση.

Κρυπτογραφημένο περιεχόμενο για συνομιλίες πολλαπλών γύρων

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

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=4,
    use_encrypted_content=True,
)

Το μοντέλο διατηρεί τότε την κατάσταση των υπο-πρακτόρων μεταξύ των γύρων, καθιστώντας τις εκτεταμένες ανταλλαγές πολύ πιο συνεκτικές.

Διαχείριση σφαλμάτων

Δεδομένου ότι το API βρίσκεται σε beta, ένα αίτημα μπορεί να αποτύχει χωρίς δική σας υπαιτιότητα. Περιβάλλετε την κλήση και σχεδιάστε μια εναλλακτική λύση:

try:
    chat = client.chat.create(
        model="grok-4.20-multi-agent-0309",
        agent_count=4
    )
    chat.append(user("My question"))

    for response, chunk in chat.stream():
        if chunk.content:
            print(chunk.content, end="", flush=True)
except Exception as e:
    print(f"Multi-agent error: {e}")
    # Fall back to a standard model if needed

Το σχόλιο στην τελευταία γραμμή περιμένει να αντικατασταθεί με πραγματικό κώδικα. Σε περιβάλλον παραγωγής, αυτό το μπλοκ πρέπει οπωσδήποτε να κάνει επαναφορά σε ένα τυπικό μοντέλο, διαφορετικά η λειτουργία σας θα σταματήσει να εργάζεται την πρώτη φορά που το multi-agent δεν θα είναι διαθέσιμο.

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

  • Το xAI SDK εκθέτει το agent_count για τον άμεσο έλεγχο του αριθμού των πρακτόρων
  • Χρησιμοποιείτε πάντα τη ροή δεδομένων (streaming) για multi-agent (.stream())
  • Το verbose_streaming αποκαλύπτει τις κλήσεις εργαλείων σε πραγματικό χρόνο
  • Χρησιμοποιήστε use_encrypted_content=True για συνομιλίες πολλαπλών γύρων
  • Σχεδιάζετε πάντα τη διαχείριση σφαλμάτων (λόγω beta API)