Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Implementatie met de xAI SDK

Les 5 van 14 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. De native xAI SDK
  2. Basisconfiguratie
  3. Verzoek met 4 agents (snelle modus)
  4. Verzoek met 16 agents (diepgaande modus)
  5. Ingebouwde tools toevoegen
  6. Versleutelde inhoud voor conversaties met meerdere beurten
  7. Foutafhandeling
  8. Belangrijkste punten

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.

xai_sdk
Officieel Python-pakket
agent_count
Exclusieve parameter
Streaming
Real-time respons
Tools
web_search, x_search...

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_count beschikbaar om het aantal agents direct te regelen
  • Gebruik altijd streaming voor multi-agent (.stream())
  • verbose_streaming toont tool-aanroepen in real-time
  • Gebruik use_encrypted_content=True voor conversaties met meerdere beurten
  • Voorzie altijd foutafhandeling (bèta-API)