Implementatie met de xAI SDK
Op deze pagina
De native xAI SDK
De xAI SDK is de meest directe manier om de multi-agent-modus te gebruiken en de enige die parameters zoals agent_count blootlegt, waar SDK’s van derden geen toegang toe hebben. Als u begint zonder beperkingen vanuit het ecosysteem, start dan hier: u krijgt toegang tot de volledige set instellingen.
Basisconfiguratie
Het initialiseren van de client komt neer op drie imports en het uitlezen van uw API-sleutel uit de omgeving:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
De omgevingsvariabele XAI_API_KEY moet uw xAI API-sleutel bevatten. Hardcode de sleutel nooit: deze zou anders in de Git-repository belanden, en vervolgens in de geschiedenis, waar het moeilijk is om deze te verwijderen.
Verzoek met 4 agents (snelle modus)
Voor een snelle, gerichte zoekopdracht geeft u agent_count=4 door bij het aanmaken van de chat:
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)
Merk op dat u de respons verwerkt via chat.stream(). Dit is de aanbevolen methode: zonder deze optie blijft uw programma hangen zonder enig teken van leven tijdens de volledige zoekopdracht, en weet u niet of het verzoek nog loopt of is gecrasht.
Verzoek met 16 agents (diepgaande modus)
Overschakelen naar de diepgaande modus vereist slechts het wijzigen van één waarde, maar het verzoek dat u hiermee koppelt, moet wel overeenkomen met de schaal van het team dat u inzet:
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)
Ingebouwde tools toevoegen
U voegt tools toe met een eenvoudige lijst; de SDK biedt de bijbehorende constructors:
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)
De parameter include=["verbose_streaming"] verandert wat u ontvangt: tool-aanroepen verschijnen in real-time terwijl de agents werken, en u weet waarop de huidige zoekopdracht zich richt.
Versleutelde inhoud voor conversaties met meerdere beurten
Als u van plan bent om meerdere vragen achter elkaar over hetzelfde onderwerp te stellen, schakelt u versleutelde inhoud in bij het aanmaken van de chat:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
use_encrypted_content=True,
)
Het model houdt dan de status van de sub-agents tussen de beurten door, wat uitgebreide uitwisselingen veel coherenter maakt.
Foutafhandeling
Omdat de API zich in bètafase bevindt, kan een verzoek falen zonder dat dit uw schuld is. Omkleed de aanroep en zorg voor een uitweg:
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
De opmerking op de laatste regel wacht erop vervangen te worden door echte code. In productie moet dit blok daadwerkelijk terugvallen op een standaardmodel; anders stopt uw functie met werken zodra multi-agent niet beschikbaar is.
Belangrijkste punten
- De xAI SDK stelt
agent_countbeschikbaar om het aantal agents direct te regelen - Gebruik altijd streaming voor multi-agent (
.stream()) verbose_streamingtoont tool-aanroepen in real-time- Gebruik
use_encrypted_content=Truevoor conversaties met meerdere beurten - Voorzie altijd foutafhandeling (bèta-API)