Għaqqad l-MCP u l-Għodod Integrati
F'din il-paġna
Żewġ familji ta’ għodod, katalogu wieħed
L-MCP mhix l-unika mod biex tagħti kapaċitajiet lil Grok. L-API ta’ xAI tinkludi għodod nattivi, imsejħa għodod integrati (built-in tools), li l-mudell jista’ jsejjaħ mingħajr ma jinvolvi ebda server estern. M’għandekx għalfejn tagħżel bejn iż-żewġ familji: tiddikjarahom fl-istess post u tgħaqqadhom liberament f’konfigurazzjoni waħda.
Erba’ għodod nattivi jkopru l-biċċa l-kbira tal-ħtiġijiet.
- Tiftix fil-web: tiftix fil-web f’ħin reali
- Eżekuzzjoni tal-kodiċi: eżekuzzjoni ta’ kodiċi Python f’sandbox
- Analiżi tal-immaġni: analiżi u deskrizzjoni tal-immaġni
- Parsing tal-fajls: qari u estrazzjoni tal-kontenut tal-fajls
Tiddikjarahom fl-array tools bit-tip biss, mingħajr URL jew tikketta—li jagħmel sens, peress li m’hemm l-ebda server remot li għandu jiġi ddeżinjat.
Taħlit tagħhom: xejn extra biex titgħallem
Is-sintassi ma teħtieġ l-ebda kostruzzjoni speċjali. Tpoġġi oġġetti MCP u oġġetti nattivi ħdejn xulxin fl-istess array.
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=[
# Għodda MCP remota
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Documentation for GitHub projects"
),
# Għodda nattiva: tiftix fil-web
{"type": "web_search"},
],
)
L-API tar-Risposti (Responses API) fil-format OpenAI ssegwi l-istess loġika, bl-għodda MCP tieħu sempliċement il-forma tad-dizzjunju ttipjat tagħha.
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input=[{"role": "user", "content": "Compare React and Vue based on the official docs and current trends"}],
tools=[
{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki"
},
{"type": "web_search"},
],
)
L-orkestrazzjoni sseħħ awtomatikament
Mill-perspettiva tal-mudell, l-għodod MCP u dawk nattivi jiffurmaw katalogu wieħed. Grok ma jagħmilx distinzjoni bejn għodda li tmur fuq in-netwerk lejn server ta’ parti terza u waħda eżegwita mill-infrastruttura ta’ xAI: huwa jara kapaċitajiet, b’ismijiet u deskrizzjonijiet, u jagħżel dik li tavvanza r-risposta f’kull pass.
Ħu l-mistoqsija “qabbel il-konfigurazzjoni tar-routing f’Next.js mal-aħjar prattiki attwali”. Grok l-ewwel isejjaħ deepwiki__search biex jaqra d-dokumentazzjoni tar-routing fir-repożitorju ta’ Next.js, imbagħad web_search biex isib artikoli riċenti dwar il-prattiki attwali, u finalment jissintetizza ż-żewġ sorsi f’risposta koerenti. F’ebda mument ma speċifikajt dan l-ordni, jew anke li dawn iż-żewġ għodod għandhom jintużaw flimkien. Il-mudell jiddeċiedi s-sekwenza waħdu, u m’għandek l-ebda loġika ta’ orkestrazzjoni biex tikteb.
Żewġ kompożizzjonijiet tipiċi
Aġent ta’ riċerka teknika jisfrutta dokumentazzjoni ta’ referenza, aċċess għall-web, u kapaċitajiet ta’ verifika tal-kodiċi.
tools = [
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Documentation and source code for GitHub projects"
),
{"type": "web_search"},
{"type": "code_interpreter"},
]
Dan it-triju jħallik tikkonsulta d-dokumentazzjoni tal-proġett, tfittex informazzjoni addizzjonali online, u mbagħad tesegwixxi kodiċi biex tivvalida soluzzjoni qabel ma tipproponiha. It-tielet għodda tbiddel in-natura tar-risposta: minflok ma ssostni li framment ta’ kodiċi jaħdem, l-aġent jivverifikah.
Assistent tekniku intern isegwi loġika differenti, fejn żewġ servers privati jżommu l-għarfien tal-kumpanija u l-web isservi biss bħala backup.
tools = [
mcp(
server_url="https://kb.monentreprise.com/mcp",
server_label="kb",
server_description="Internal knowledge base",
authorization=f"Bearer {os.getenv('KB_TOKEN')}"
),
mcp(
server_url="https://jira.monentreprise.com/mcp",
server_label="jira",
server_description="Jira tickets and projects",
authorization=f"Bearer {os.getenv('JIRA_TOKEN')}",
allowed_tool_names=["search_issues", "get_issue"]
),
{"type": "web_search"},
]
L-assistent ifittex fil-bażi tal-għarfien, jikkonsulta t-tikketti relatati ta’ Jira, u jissupplimenta b’tiftix fil-web jekk l-informazzjoni tkun nieqsa internament. Innota r-restrizzjoni fuq Jira, limitata għal aċċess ta’ qari biss: mingħajrha, istruzzjoni malizzjuża li tiżżerreq fil-korp ta’ tikketta tista’ timbotta lill-mudell lejn operazzjoni ta’ kitba.
L-ispiża moħbija tal-abbondanza
Kull għodda miżjuda, kemm jekk MCP kif ukoll nattiva, tieħu spazju fit-tieqa tal-kuntest (context window) biex taħżen id-definizzjoni tagħha. Għalhekk, konfigurazzjoni ġeneruża tiswikek f’termini ta’ spazju disponibbli għall-konversazzjoni, ħin tal-ipproċessar, u preċiżjoni tas-selezzjoni.
Tliet drawwiet biżżejjed biex iżżomm dan taħt kontroll. Illimita n-numru totali ta’ għodod, u rreżisti t-tentazzjoni li tikkonnettja ħames servers b’ħamsin għodda meta l-każ ta’ użu tiegħek jeħtieġ għaxra. Applika allowed_tool_names fuq kull server MCP biex iżżomm biss l-għodod rilevanti. U żżidx għodda nattiva “għal kull każ”: jekk l-aġent tiegħek m’għandux raġuni biex jesegwixxi kodiċi, code_interpreter mhix għażla bla ħlas, hija kuntest ikkunsmat u opportunità addizzjonali biex tagħżel l-għodda żbaljata.
Punti Ewlenin
- L-għodod MCP u l-għodod nattivi (tiftix fil-web, eżekuzzjoni tal-kodiċi) jikkoegżistu fl-istess array
tools - Grok awtomatikament jorkestra s-sejħiet bejn l-għodod MCP u dawk nattivi abbażi tal-mistoqsija
- Il-kombinazzjoni tħallik toħloq aġenti qawwija li jisfruttaw kemm sorsi interni (MCP) kif ukoll sorsi esterni (tiftix fil-web)
- Illimita n-numru totali ta’ għodod biex tippreżerva l-kuntest u l-preċiżjoni tal-mudell
- Uża
allowed_tool_namesgħal kull server MCP biex tnaqqas l-istorbju