Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Għodod Esterni u SDKs Appoġġjati

Lezzjoni 3 / 12 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Tliet punti ta’ dħul għall-istess mekkaniżmu
  2. L-SDK nattiva ta’ xAI
  3. L-API tar-Risposti, kompatibbli ma’ OpenAI
  4. L-API tal-Aġent Vuwkali (Voice Agent)
  5. X’inhu li ma jinbidilx bejn l-interfaċċi
  6. Punti Ewlenin

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_approval jew connector_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