Salt la conținutul principal
Română— Alege o limbă
Meniu

Implementare cu SDK-ul xAI

Lecția 5 din 14 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. SDK-ul nativ xAI
  2. Configurare de bază
  3. Cerere cu 4 agenți (mod rapid)
  4. Cerere cu 16 agenți (mod aprofundat)
  5. Adăugarea instrumentelor integrate
  6. Conținut criptat pentru conversații multi-tur
  7. Gestionarea erorilor
  8. Puncte cheie

SDK-ul nativ xAI

SDK-ul xAI reprezintă cea mai directă metodă de utilizare a modului multi-agent și singura care expune parametri precum agent_count, indisponibili în SDK-urile terțe. Dacă începeți fără constrângeri de ecosistem, startați de aici: veți avea acces la întregul set de configurări.

xai_sdk
Pachet oficial Python
agent_count
Parametru exclusiv
Streaming
Răspuns în timp real
Instrumente
web_search, x_search...

Configurare de bază

Inițializarea clientului se reduce la trei importuri și citirea cheii API din variabilele de mediu:

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

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

Variabila de mediu XAI_API_KEY trebuie să conțină cheia dvs. API xAI. Nu introduceți niciodată cheia direct în cod (hard-code): aceasta ar ajunge în repository-ul Git, apoi în istoricul său, de unde este greu de eliminat.

Cerere cu 4 agenți (mod rapid)

Pentru o căutare rapidă și focalizată, transmiteți agent_count=4 atunci când creați chat-ul:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=4
)
chat.append(user("Compară în detaliu TCP și UDP"))

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

Rețineți că consumați răspunsul prin chat.stream(). Aceasta este metoda recomandată: fără ea, programul dvs. se blochează fără niciun semn de activitate pe durata întregii căutări, iar nimic nu vă indică dacă cererea rulează încă sau a eșuat.

Cerere cu 16 agenți (mod aprofundat)

Trecerea la modul aprofundat necesită modificarea unei singure valori, dar cererea pe care o asociați trebuie să corespundă scalei echipei pe care o desfășurați:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=16
)
chat.append(user(
    "Oferă-mi o stare completă a tehnicii privind arhitecturile RAG în 2026, "
    "comparând abordările hibride, performanța și costurile"
))

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

Adăugarea instrumentelor integrate

Adăugați instrumente printr-o listă simplă, iar SDK-ul furnizează constructorii corespunzători:

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("Care sunt cele mai recente anunțuri xAI din această săptămână?"))

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

Parametrul include=["verbose_streaming"] modifică ceea ce primiți: apelurile de instrumente apar în timp real în timp ce agenții lucrează, știind astfel pe ce se concentrează căutarea curentă.

Conținut criptat pentru conversații multi-tur

Dacă intenționați să puneți mai multe întrebări consecutive pe aceeași temă, activați conținutul criptat atunci când creați chat-ul:

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

Modelul menține astfel starea sub-agenților între tururi, ceea ce face schimburile extinse mult mai coerente.

Gestionarea erorilor

Deoarece API-ul este în versiune beta, o cerere poate eșua fără nicio vină din partea dvs. Încadrați apelul și planificați o soluție de rezervă:

try:
    chat = client.chat.create(
        model="grok-4.20-multi-agent-0309",
        agent_count=4
    )
    chat.append(user("Întrebarea mea"))

    for response, chunk in chat.stream():
        if chunk.content:
            print(chunk.content, end="", flush=True)
except Exception as e:
    print(f"Eroare multi-agent: {e}")
    # Reveniți la un model standard dacă este necesar

Comentariul de pe ultima linie așteaptă să fie înlocuit cu cod real. În producție, acest bloc trebuie să revină efectiv la un model standard; altfel, funcționalitatea dvs. se oprește din funcționare prima dată când multi-agent nu este disponibil.

Puncte cheie

  • SDK-ul xAI expune agent_count pentru a controla direct numărul de agenți
  • Utilizați întotdeauna streaming pentru multi-agent (.stream())
  • verbose_streaming dezvăluie apelurile de instrumente în timp real
  • use_encrypted_content=True pentru conversații multi-tur
  • Planificați întotdeauna gestionarea erorilor (API beta)