Ārējie rīki un atbalstītie SDK
Šajā lapā
Trīs ieejas punkti vienam un tam pašam mehānismam
xAI piedāvā attālo MCP, izmantojot trīs saskarnes. Tās ir paredzētas dažādiem izstrādātājiem: viena jauniem projektiem, otra migrētiem projektiem un trešā konkrētiem lietojuma kontekstiem. MCP darbība visos trīs gadījumos ir pilnīgi identiska; mainās tikai konfigurācijas sintakse un papildu rīki. Tava izvēle tāpēc ir atkarīga no esošās tehnoloģiju kaudzes, nevis no protokola iespējām.
Natīvais xAI SDK
Šo metodi xAI iesaka vispirms. Tā nodrošina mcp() palīgfunkciju, kas apkopo konfigurāciju vienā funkcijas izsaukumā.
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"],
)
mcp() palīgfunkcija pieņem visus MCP konfigurācijas parametrus — URL, etiķeti, aprakstu, atļautos rīkus, autentifikāciju — un pareizi noformē tos API izsaukumam. Šī ir viskoncīzākā sintakse, un, kas ir vēl svarīgāk, tā ir metode, kurā kļūdīties ir visgrūtāk, jo atslēgvārdu nosaukumus un ligzdošanu sistēma apstrādā tavā vietā. Izvēlies šo ceļu jauniem projektiem bez saderības ierobežojumiem, jebkurai ātrai prototipēšanai un ikreiz, kad izmantoji xAI specifiskas funkcijas, piemēram, iepriekš redzamo detalizēto straumēšanu (verbose streaming).
Responses API, saderīgs ar OpenAI
Šī saskarne pieņem tieši OpenAI API formātu. Tā pastāv konkrēta iemesla dēļ: lai komandai, kas jau ir uzrakstījusi savu lietotni šajā formātā, nebūtu viss jāpārraksta, lai izmēģinātu Grok. Izmaiņas aprobežojas ar API atslēgu un bāzes 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",
}],
)
Šeit MCP serveris tiek deklarēts kā elements tools masīvā ar tipu "mcp" un parametriem kā atslēgu-vērtību pāriem tajā pašā objektā. Nav palīgfunkcijas: vārdnīcu raksti ar roku, kas atstāj lielāku vietu kļūdām atslēgvārdu nosaukumos.
Šai saderībai ir sava cena, un tev tā ir jāzina pirms būvēšanas uz tās pamata. Divi parametri, kas pieejami natīvajā SDK, šeit nav pieejami: require_approval, kas ļauj pieprasīt cilvēka apstiprinājumu pirms MCP rīka izpildes, un connector_id, kas pārvalda OpenAI konektorus. Ja tavs aģents veic sensitīvas operācijas un paļāvies uz manuālu apstiprinājumu, šis ierobežojums ir šķērslis, un tam tev vajadzētu atgriezties pie natīvā xAI SDK. Responses API joprojām ir pareizā izvēle migrācijai no OpenAI bez pārrakstīšanas, daudzu piegādātāju projektam, kur pārslēdzies starp Grok un citiem modeļiem, un komandai, kas jau ir iepazīšanās ar šo formātu.
Voice Agent API
Trešā saskarne ir paredzēta balss aģentiem. Tipisks scenārijs ir telefona asistents, kam sarunas vidū jākonsultējas ar zināšanu bāzi, jāpārbauda pasūtījuma statuss vai jāveic vaicājums ārējai sistēmai — nepieļaujot, ka zvanītājs dzirdētu neizskaidrojamu klusumu.
MCP konfigurācija seko tam pašam formātam kā citos SDK, ar tiem pašiem server_url, server_label un citiem parametriem. Atšķirība slēpjas tajā, kas notiek pēc rīka izsaukuma: rezultāts tiek integrēts balss sintēzes plūsmā, nevis attēlots kā teksts. Tas ietekmē to, kā raksti savu rīku aprakstus un noformē to atbildes, jo lietotājs nekad neredzēs tabulu vai sarakstu — viņš tos tikai dzirdēs.
Kas nemainās neatkarīgi no saskarnes
Neatkarīgi no SDK secība ir viena un tā pati. Grok atklāj MCP servera eksponētos rīkus, atlasa to, kas atbilst pieprasījumam, noformē izsaukumu ar pareizajiem parametriem un pēc tam integrē rezultātu savā atbildē. Neviena no trim saskarnēm nepadara modeli prasmīgāku vai neprasmīgāku rīka izvēlē.
Tātad atšķirības slēpjas citur: sintakses koncizumā, pieejamajās papildu funkcijās — detalizētā straumēšana xAI SDK, formāta saderība Responses API, balss sintēze Voice Agent — un divos parametros, kas trūkst OpenAI formātā. Lem, balstoties uz šiem kritērijiem, un nekļūdīsies.
Galvenās atziņas
- Natīvais xAI SDK ar
mcp()ir vienkāršākā un vispilnīgākā metode - Responses API (OpenAI formāts) atvieglo migrāciju, bet neatbalsta
require_approvalvaiconnector_id - Voice Agent API savieno balss aģentus ar MCP rīkiem
- MCP darbība visos trīs gadījumos ir identiska; mainās tikai sintakse
- Izvēlies, balstoties uz esošo tehnoloģiju kaudzi un specifiskajām vajadzībām