Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Toteutus xAI SDK:lla

Oppitunti 5 / 14 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Natiivi xAI SDK
  2. Perusasetukset
  3. 4 agentin pyyntö (nopea tila)
  4. 16 agentin pyyntö (perusteellinen tila)
  5. Sisäisten työkalujen lisääminen
  6. Salattu sisältö monivaiheisille keskusteluille
  7. Virheenkäsittely
  8. Keskeiset asiat

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.

xai_sdk
Virallinen Python-paketti
agent_count
Eksklusiivinen parametri
Streaming
Reaaliaikainen vastaus
Tools
web_search, x_search...

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_count agenttien määrän suoraa hallintaa varten
  • Käytä aina streamingiä moniagenttitilassa (.stream())
  • verbose_streaming paljastaa työkalukutsut reaaliajassa
  • Käytä asetusta use_encrypted_content=True monivaiheisissa keskusteluissa
  • Suunnittele aina virheenkäsittely (beta-API)