Għodod Esterni u SDKs Appoġġjati
F'din il-paġna
Tliet punti ta’ dħul għall-istess mekkaniżmu
xAI jesponi l-MCP remot permezz ta’ tliet interfaċċi. Dawn huma mmirati lejn żviluppaturi differenti: waħda għal proġetti ġodda, oħra għal proġetti mċaqalqa (migrated), u t-tielet għal kuntesti ta’ użu speċifiċi. L-imġiba tal-MCP hija eżattament l-istess fit-tliet każijiet; biss is-sintassi tal-konfigurazzjoni u l-għodod periferali jinbidlu. Għalhekk, l-għażla tiegħek tiddependi fuq l-istack eżistenti tiegħek, mhux fuq il-kapaċitajiet tal-protokoll.
L-SDK nattiva ta’ xAI
Dan huwa l-metodu rrakkomandat minn xAI. Jipprovdi helper mcp() li jikkondensa l-konfigurazzjoni f’sejħa waħda ta’ funzjoni.
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"],
)
L-helper mcp() jaċċetta l-parametri kollha tal-konfigurazzjoni tal-MCP—URL, tikketta, deskrizzjoni, għodod permessi, awtentikazzjoni—u jittratta l-iffurmat tagħhom b’mod korrett għall-API. Din hija s-sintassi l-iqsar, u l-aktar waħda importanti fejn huwa inqas probabbli li tagħmel żball, peress li l-ismijiet tal-klavijiet u t-tbejjit (nesting) jiġu ġestiti għalik. Agħżel din it-triq għal proġett ġdid mingħajr restrizzjonijiet ta’ kompatibbiltà, għal kwalunkwe prototipar rapidu, u kull meta tuża karatteristiċi speċifiċi ta’ xAI bħall-verbose streaming viżibbli hawn fuq.
L-API tar-Risposti, kompatibbli ma’ OpenAI
Din l-interfaċċi taċċetta eżattament il-format tal-API ta’ OpenAI. teżisti għal raġuni speċifika: biex timma li diġà kitbet l-applikazzjoni tagħha f’dan il-format ma jkollhiex terġa’ tikteb kollox biex tipprova Grok. Il-bidla hija limitata għaċ-ċavetta tal-API u l-URL bażi.
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",
}],
)
Hawnhekk, is-server MCP huwa ddikjarat bħala element tal-array tools, bit-tip "mcp" u l-parametri bħala pari key-value fl-istess oġġett. L-ebda helper: tikteb id-dizzjunarju bl-idejn, li jħalli aktar spazju għal żball ta’ tipa (typo) f’isem ta’ ċavetta.
Din il-kompatibbiltà għandha prezz, u għandek tkun tafih qabel ma tibni fuqha. Żewġ parametri disponibbli fl-SDK nattiva mhumiex disponibbli hawn: require_approval, li jħallik titlob validazzjoni umana qabel ma teżegwixxi għodda MCP, u connector_id, li jimmaniġġja l-konnetturi ta’ OpenAI. Jekk l-aġent tiegħek jittratta operazzjonijiet sensittivi u kont tiddependi fuq il-validazzjoni manwali, din il-limitazzjoni hija blokk u għandha terġa’ tmur lura lejn l-SDK nattiva ta’ xAI. L-API tar-Risposti tibqa’ l-għażla t-tajba għal migrazzjoni minn OpenAI mingħajr ma terġa’ tikteb, għal proġett multi-fornitur fejn tibdel bejn Grok u mudelli oħra, u għal tim diġà familjari ma’ dan il-format.
L-API tal-Aġent Vuwkali (Voice Agent)
It-tielet interfaċċi hija ddisinjata għal aġenti vuwkali. Ix-xenarju tipiku huwa assistent tat-telefon li, f’nofs konversazzjoni, jeħtieġ jikkonsulta bażi tal-għarfien, jiċċekkja l-istatus ta’ ordni, jew jistaqsi sistema esterna—mingħajr ma ċ-ċempelatur jesperjenza silenzju mhux spjegat.
Il-konfigurazzjoni tal-MCP issegwi l-istess format bħall-SDKs l-oħra, bl-istess parametri server_url, server_label u oħrajn. Id-differenza tinsab f’dak li jiġri wara s-sejħa tal-għodda: ir-riżultat huwa integrat fil-fluss tas-sinteżi vuwkali minflok ma jiġi rrenderjat bħala test. Dan jifforma kif tikteb id-deskrizzjonijiet tal-għodod tiegħek u tqafas ir-risposti tagħhom, peress li l-utent qatt ma se jara tabella jew lista—huwa se jismagħhom biss.
X’inhu li ma jinbidilx bejn l-interfaċċi
Ikun xi jkun l-SDK, is-sekwenza hija l-istess. Grok jiskopri l-għodod esposti mis-server MCP, jagħżel dik li taqbel mat-talba, jifformula s-sejħa bil-parametri korretti, imbagħad jintegra r-riżultat fir-risposta tiegħu. L-ebda waħda mit-tliet interfaċċi ma tagħmel il-mudell aktar jew inqas kapaci li jagħżel għodda.
Għalhekk id-differenzi jinsabu band’oħra: il-konċiżjoni tas-sintassi, il-karatteristiċi periferali disponibbli—verbose streaming fuq l-SDK ta’ xAI, kompatibbiltà tal-format fuq l-API tar-Risposti, sinteżi vuwkali fuq l-Aġent Vuwkali—u ż-żewġ parametri nieqsa mill-format ta’ OpenAI. Iddeċiedi abbażi ta’ dawn il-kriterji, u ma tmurx żball.
Punti Ewlenin
- L-SDK nattiva ta’ xAI b’
mcp()hija l-metodu l-aktar sempliċi u sħiħ - L-API tar-Risposti (format OpenAI) tiffaċilita l-migrazzjoni iżda ma tappoġġjax
require_approvaljewconnector_id - L-API tal-Aġent Vuwkali tikkonnettja l-aġenti vuwkali mal-għodod MCP
- L-imġiba tal-MCP hija identika fit-tliet każijiet; biss is-sintassi tinbidel
- Agħżel abbażi tal-istack eżistenti tiegħek u l-ħtiġijiet speċifiċi tiegħek