Toteutus xAI SDK:lla
Tällä sivulla
Natiivi xAI SDK
xAI SDK on suoraviivaisin tapa hyödyntää moniagenttitilaa ja ainoa, joka paljastaa parametreja kuten agent_count, joita kolmansien osapuolien SDK:t eivät tarjoa. Jos aloitat ilman ekosysteemirajoitteita, aloita tästä: saat käyttöösi koko asetusten kirjon.
Perusasetukset
Asiakasohjelman alustus tiivistyy kolmeen tuontiin ja API-avaimen lukemiseen ympäristömuuttujasta:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
Ympäristömuuttujan XAI_API_KEY on sisällettävä xAI API-avaimesi. Älä koskaan koodaa avainta suoraan lähdekoodiin: se päätyisi Git-varastoon ja sen historiaan, josta sen poistaminen on vaikeaa.
4 agentin pyyntö (nopea tila)
Nopeaa ja kohdennettua hakua varten välität parametrin agent_count=4 luodessasi keskustelun:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Vertaa TCP:tä ja UDP:tä yksityiskohtaisesti"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Huomaa, että kulutat vastauksen metodin chat.stream() kautta. Tämä on suositeltu tapa: ilman sitä ohjelmasi jumittuu ilman elonmerkkejä koko haun ajan, etkä saa tietää, onko pyyntö vielä käynnissä vai kaatunut.
16 agentin pyyntö (perusteellinen tila)
Vaihto perusteelliseen tilaan vaatii vain yhden arvon muuttamista, mutta siihen yhdistettävän pyynnön on vastattava käyttöönotetun tiimin mittakaavaa:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=16
)
chat.append(user(
"Anna kattava katsaus RAG-arkkitehtuurien huipputasoon vuonna 2026, "
"verraten hybridi lähestymistapoja, suorituskykyä ja kustannuksia"
))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Sisäisten työkalujen lisääminen
Lisäät työkalut yksinkertaisella listalla, ja SDK tarjoaa vastaavat muodostimet:
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("Mitkä ovat xAI:n uusimmat ilmoitukset tällä viikolla?"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Parametri include=["verbose_streaming"] muuttaa vastaanottamaasi dataa: työkalukutsut näkyvät reaaliajassa agenttien työskennellessä, joten tiedät, mihin nykyinen haku keskittyy.
Salattu sisältö monivaiheisille keskusteluille
Jos aiot esittää useita peräkkäisiä kysymyksiä samasta aiheesta, ota salattu sisältö käyttöön keskustelua luodessasi:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
use_encrypted_content=True,
)
Malli pitää tällöin alagenttien tilan yllä vuorojen välillä, mikä tekee laajoista vuorovaikutuksista huomattavasti johdonmukaisempia.
Virheenkäsittely
Koska API on beta-vaiheessa, pyyntö voi epäonnistua ilman omaa syytäsi. Kääri kutsu ja suunnitele varasuunnitelma:
try:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Kysymykseni"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
except Exception as e:
print(f"Moniagenttivirhe: {e}")
# Palaa tarvittaessa vakiomalliin
Viimeisen rivin kommentti odottaa korvaamista oikealla koodilla. Tuotantoympäristössä tämän lohkon on todellakin palattava vakiomalliin, muuten ominaisuutesi lakkaa toimimasta heti, kun moniagenttitila ei ole saatavilla.
Keskeiset asiat
- xAI SDK paljastaa parametrin
agent_countagenttien määrän suoraa hallintaa varten - Käytä aina streamingiä moniagenttitilassa (
.stream()) verbose_streamingpaljastaa työkalukutsut reaaliajassa- Käytä asetusta
use_encrypted_content=Truemonivaiheisissa keskusteluissa - Suunnittele aina virheenkäsittely (beta-API)