Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Vanjski alati i podržani SDK-ovi

Lekcija 3 od 12 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Tri ulazne točke za isti mehanizam
  2. Izvorni xAI SDK
  3. Responses API, kompatibilan s OpenAI-jem
  4. Voice Agent API
  5. Što se ne mijenja kroz sučelja
  6. Ključne točke

Tri ulazne točke za isti mehanizam

xAI izlaže udaljeni MCP kroz tri sučelja. Svako od njih cilja različite developere: jedno za nove projekte, drugo za migrirane projekte, a treće za specifične kontekste upotrebe. Ponašanje MCP-a potpuno je isto u sva tri slučaja; mijenjaju se samo sintaksa konfiguracije i pomoćni alati. Tvoj izbor stoga ovisi o tvom postojećem tehnološkom stacku, a ne o mogućnostima samog protokola.

Izvorni xAI SDK

Ovo je metoda koju xAI preporučuje. Ona nudi pomoćnu funkciju mcp() koja sažima konfiguraciju u jedan poziv funkcije.

from xai_sdk import Client
from xai_sdk.tools import mcp

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

chat = client.chat.create(
    model="grok-4.20-0309-reasoning",
    tools=[
        mcp(server_url="https://mcp.deepwiki.com/mcp")
    ],
    include=["verbose_streaming"],
)

Pomoćna funkcija mcp() prihvaća sve parametre MCP konfiguracije – URL, oznaku, opis, dopuštene alate, autentifikaciju – i sama se brine za njihovo ispravno formatiranje za API. Ovo je najsažetija sintaksa i, što je ključno, ona u kojoj je najmanja vjerojatnost greške jer su nazivi ključeva i struktura ugniježđenosti automatski riješeni za tebe. Odaberi ovaj put za novi projekt bez ograničenja kompatibilnosti, za brzo prototipiranje i kad god koristiš značajke specifične za xAI, poput gore prikazanog detaljnog striminga (verbose streaming).

Responses API, kompatibilan s OpenAI-jem

Ovo sučelje prihvaća točno isti format kao OpenAI API. Postoji iz specifičnog razloga: kako tim koji je već napisao svoju aplikaciju u tom formatu ne bi morao sve prepisivati samo da bi isprobao Grok. Promjena se svodi na API ključ i osnovni URL (base URL).

from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input=[{"role": "user", "content": "Explain the React project"}],
    tools=[{
        "type": "mcp",
        "server_url": "https://mcp.deepwiki.com/mcp",
        "server_label": "deepwiki",
    }],
)

Ovdje se MCP poslužitelj deklarira kao element polja tools, s tipom "mcp" i parametrima kao parovi ključ-vrijednost unutar istog objekta. Nema pomoćne funkcije: rječnik pišeš ručno, što ostavlja više prostora za tipfeler u nazivu ključa.

Ova kompatibilnost ima svoju cijenu koju moraš znati prije nego što gradiš na njoj. Dva parametra dostupna u izvornom SDK-u ovdje nisu dostupna: require_approval, koji ti omogućuje da zahtijevaš ljudsku potvrdu prije izvršavanja MCP alata, i connector_id, koji upravlja OpenAI konektorima. Ako tvoj agent rukuje osjetljivim operacijama i računao si na ručnu validaciju, ovo ograničenje je blokirajuće i trebalo bi te usmjeriti natrag na izvorni xAI SDK. Responses API ipak ostaje pravi izbor za migraciju s OpenAI-ja bez prepisivanja koda, za projekte s više pružatelja usluga gdje izmjenjuješ Grok i druge modele, te za timove koji su već upoznati s ovim formatom.

Voice Agent API

Treće sučelje dizajnirano je za glasovne agente. Tipičan scenarij je telefonski asistent koji usred razgovora treba konzultirati bazu znanja, provjeriti status narudžbe ili upitati vanjski sustav – a da pozivatelj ne doživi neobjašnjivu tišinu.

Konfiguracija MCP-a prati isti format kao i u drugim SDK-ovima, s istim parametrima server_url, server_label i ostalima. Razlika leži u onome što se događa nakon poziva alata: rezultat se integrira u tijek glasovne sinteze umjesto da se prikaže kao tekst. To oblikuje način na koji pišeš opise svojih alata i formuliraš njihove odgovore, jer korisnik nikada neće vidjeti tablicu ili popis – on će ih samo čuti.

Što se ne mijenja kroz sučelja

Bez obzira na SDK, slijed je uvijek isti. Grok otkriva alate koje izlaže MCP poslužitelj, odabire onaj koji odgovara zahtjevu, formulira poziv s ispravnim parametrima, a zatim integrira rezultat u svoj odgovor. Nijedno od triju sučelja ne čini model sposobnijim ili nesposobnijim za odabir alata.

Razlike su dakle drugdje: u sažetosti sintakse, u dostupnim pomoćnim značajkama – detaljni striming u xAI SDK-u, kompatibilnost formata u Responses API-ju, glasovna sinteza u Voice Agentu – te u dva parametra koja nedostaju u OpenAI formatu. Odluči se na temelju ovih kriterija i nećeš pogriješiti.

Ključne točke

  • Izvorni xAI SDK s mcp() najjednostavnija je i najpotpunija metoda
  • Responses API (OpenAI format) olakšava migraciju, ali ne podržava require_approval ni connector_id
  • Voice Agent API povezuje glasovne agente s MCP alatima
  • Ponašanje MCP-a identično je u sva tri slučaja; mijenja se samo sintaksa
  • Odabir temelji na svom postojećem stacku i specifičnim potrebama