Išoriniai įrankiai ir palaikomi SDK
Šiame puslapyje
Trys įėjimo taškai į tą patį mechanizmą
xAI pateikia nuotolinį MCP per tris sąsajas. Jos skirtos skirtingiems kūrėjams: viena – naujiems projektams, kita – migruojamiems projektams, o trečioji – specifiniams naudojimo kontekstams. Visais trimis atvejais MCP elgsena yra visiškai identiška; keičiasi tik konfigūracijos sintaksė ir pagalbiniai įrankiai. Todėl tavo pasirinkimas priklauso nuo esamos technologijų krūvos, o ne nuo paties protokolo galimybių.
Gimtasis xAI SDK
Tai yra xAI rekomenduojamas būdas. Jis suteikia pagalbinę funkciją mcp(), kuri sutraukia visą konfigūraciją į vieną funkcijos kvietimą.
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"],
)
Pagalbinė funkcija mcp() priima visus MCP konfigūracijos parametrus – URL, etiketę, aprašymą, leidžiamus įrankius, autentifikavimą – ir pati juos teisingai suformatuoja API užklausai. Tai glaustiausia sintaksė ir, kas svarbiausia, joje mažiausiai tikėtina padaryti klaidą, nes raktų pavadinimai ir jų įdėjimas (nesting) tvarkomi automatiškai. Rinkis šį kelią naujiems projektams be suderinamumo apribojimų, bet kokiam greitai prototipų kūrimui ir visada, kai naudoji xAI specifines funkcijas, pavyzdžiui, aukščiau matomą išsamų srautinį perdavimą (verbose streaming).
„Responses“ API, suderinamas su „OpenAI“
Ši sąsaja priima tiksliai tą patį formatą kaip ir „OpenAI“ API. Ji sukurta dėl vienos konkrečios priežasties: kad komanda, jau parašiusi savo programą šiuo formatu, galėtų išbandyti Grok neperrašydama viso kodo. Pokytis apsiriboja tik API raktu ir baziniu 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",
}],
)
Čia MCP serveris deklaruojamas kaip tools masyvo elementas, nurodant tipą "mcp" ir parametrus kaip raktų ir reikšmių poras tame pačiame objekte. Nėra pagalbinės funkcijos: žodyną rašai rankiniu būdu, todėl lieka daugiau erdvės klaidoms raktų pavadinimuose.
Šis suderinamumas turi savo kainą, kurią turi žinoti prieš pradėdamas kurti ant jo. Du parametrai, prieinami gimtajame SDK, čia neveikia: require_approval, leidžiantis reikalauti žmogaus patvirtinimo prieš vykdant MCP įrankį, ir connector_id, valdantis „OpenAI“ jungtis. Jei tavo agentas atlieka jautrias operacijas ir tikėjaisi rankinio patvirtinimo, šis apribojimas tampa kliūtimi ir turėtų nukreipti tave atgal prie gimtojo xAI SDK. „Responses“ API išlieka tinkamu pasirinkimu migruojant iš „OpenAI“ be perrašymo, daugi tiekėjų projektams, kuriuose keičiama tarp Grok ir kitų modelių, bei komandoms, jau įpratusioms prie šio formato.
Balso agento API
Trečioji sąsaja sukurta specialiai balso agentams. Tipiškas scenarijus – telefono asistentas, kuris pokalbio viduryje turi pasitikrinti žinių bazę, patikrinti užsakymo būseną arba užklausti išorinę sistemą, nepertraukdamas skambintojo nepaaiškinama tyla.
MCP konfigūracija laikosi to paties formato kaip ir kituose SDK, su tais pačiais parametrais server_url, server_label ir kitais. Skirtumas slypi tame, kas vyksta po įrankio iškvietimo: rezultatas integruojamas į balso sintezės srautą, o ne atvaizduojamas kaip tekstas. Tai formuoja tai, kaip rašai savo įrankių aprašymus ir suformuluoji jų atsakymus, nes naudotojas niekada nematys lentelės ar sąrašo – jis juos tik išgirs.
Kas nesikeičia naudojant skirtingas sąsajas
Nesvarbu, kurį SDK pasirinksi, seka lieka ta pati. Grok atranda MCP serverio eksponuojamus įrankius, pasirenka tą, kuris atitinka užklausą, suformuluoja kvietimą su teisingais parametrais ir integruoja rezultatą į savo atsakymą. Nė viena iš trijų sąsajų nedaro modelio geresniu ar blogesniu pasirenkant įrankius.
Taigi skirtumai slypi kitur: sintaksės glaustume, prieinamose papildomose funkcijose (išsamus srautinis perdavimas xAI SDK, formato suderinamumas „Responses“ API, balso sintezė „Voice Agent“) ir dviejuose parametruose, kurių trūksta „OpenAI“ formate. Spręsk remdamasis šiais kriterijais ir nenusižengsi.
Svarbiausi punktai
- Gimtasis xAI SDK su
mcp()yra paprasčiausias ir išsamiausias metodas - „Responses“ API („OpenAI“ formatas) palengvina migraciją, tačiau nepalaiko
require_approvalarbaconnector_id - Balso agento API sujungia balso agentus su MCP įrankiais
- MCP elgsena visais trimis atvejais yra identiška; keičiasi tik sintaksė
- Rinkis pagal savo esamą technologijų krūvą ir specifinius poreikius