Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Implementálás az xAI SDK-val

5. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. A natív xAI SDK
  2. Alapbeállítás
  3. 4 ügynökös kérés (gyors mód)
  4. 16 ügynökös kérés (mélyreható mód)
  5. Beépített eszközök hozzáadása
  6. Titkosított tartalom többmenetes beszélgetésekhez
  7. Hibakezelés
  8. Főbb megállapítások

A natív xAI SDK

Az xAI SDK a legközvetlenebb módja a többügynökös mód használatának, és ez az egyetlen, amely olyan paramétereket tesz elérhetővé, mint az agent_count, amelyeket a harmadik féltől származó SDK-k nem támogatnak. Ha nincs kötve konkrét ökoszisztémához, kezdj itt: így hozzáférész a beállítások teljes készletéhez.

xai_sdk
Hivatalos Python csomag
agent_count
Kizárólagos paraméter
Streaming
Valós idejű válasz
Eszközök
web_search, x_search...

Alapbeállítás

A kliens inicializálása három importálásból és az API-kulcs környezeti változóból történő beolvasásából áll:

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

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

Az XAI_API_KEY környezeti változónak tartalmaznia kell az xAI API-kulcsodat. Soha ne kódold be közvetlenül a kulcsot: így belekerülne a Git tárolóba, majd annak előzményeibe is, ahonnan nehéz eltávolítani.

4 ügynökös kérés (gyors mód)

Egy gyors, fókuszált kereséshez add meg az agent_count=4 értéket a csevegés létrehozásakor:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=4
)
chat.append(user("Hasonlítsd össze részletesen a TCP-t és az UDP-t"))

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

Vedd észre, hogy a választ a chat.stream() metóduson keresztül fogyasztod el. Ez az ajánlott módszer: enélkül a programod életjel nélkül lógna a teljes keresés ideje alatt, és semmi sem jelezné, hogy a kérés még fut, vagy összeomlott-e.

16 ügynökös kérés (mélyreható mód)

A mélyreható módra való váltáshoz csak egyetlen értéket kell megváltoztatnod, de a hozzá társított kérésnek összhangban kell lennie a bevetett csapat méretével:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=16
)
chat.append(user(
    "Adj egy teljes állapotfelmérést a RAG architektúrákról 2026-ban, "
    "összehasonlítva a hibrid megközelítéseket, a teljesítményt és a költségeket"
))

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

Beépített eszközök hozzáadása

Az eszközöket egy egyszerű listával adhatod hozzá, és az SDK biztosítja a megfelelő konstruktort:

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("Mik az xAI legfrissebb bejelentései ezen a héten?"))

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

Az include=["verbose_streaming"] paraméter megváltoztatja, mit kapsz vissza: az eszközlehívások valós időben jelennek meg, miközben az ügynökök dolgoznak, így látod, mire fókuszál az aktuális keresés.

Titkosított tartalom többmenetes beszélgetésekhez

Ha ugyanarról a témáról szeretnél egymás után több kérdést feltenni, engedélyezd a titkosított tartalmat a csevegés létrehozásakor:

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

A modell így megőrzi az alügynökök állapotát a menetek között, ami sokkal koherensebbé teszi a hosszabb beszélgetéseket.

Hibakezelés

Mivel az API még béta verzióban van, a kérés a te hibádon kívül is meghiúsulhat. Csomagold be a hívást, és tervezz ki menekülő útvonalat:

try:
    chat = client.chat.create(
        model="grok-4.20-multi-agent-0309",
        agent_count=4
    )
    chat.append(user("A kérdésem"))

    for response, chunk in chat.stream():
        if chunk.content:
            print(chunk.content, end="", flush=True)
except Exception as e:
    print(f"Többügynökös hiba: {e}")
    # Szükség esetén térj vissza egy szabványos modellre

Az utolsó sorban lévő megjegyzés arra vár, hogy valódi kódra cseréld. Éles környezetben ennek a blokknak ténylegesen vissza kell térnie egy szabványos modellhez, különben a funkcióod már az első alkalommal leáll, amikor a többügynökös mód nem elérhető.

Főbb megállapítások

  • Az xAI SDK elérhetővé teszi az agent_count paramétert az ügynökök számának közvetlen vezérléséhez
  • Többügynökös módban mindig használd a streaminget (.stream())
  • A verbose_streaming valós időben fedi fel az eszközlehívásokat
  • Használd a use_encrypted_content=True értéket többmenetes beszélgetésekhez
  • Mindig tervezz hibakezelést (béta API)