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

Konfigurazzjoni multi-server

Lezzjoni 8 / 12 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Sorsi multipli, aġent wieħed
  2. Sintassi: xejn ġdid, biss diversi entrati
  3. It-tikketti jsiru strutturali
  4. Kif Grok jagħżel server
  5. Aġent ta’ appoġġ end-to-end
  6. Punti Ewlenin

Sorsi multipli, aġent wieħed

L-MCP remot jilħaq il-potenzjal sħiħ tiegħu meta tikkonnettja lil Grok ma’ diversi servers fl-istess ħin. Kull wieħed iġib l-għodod tiegħu stess, u l-mudellarbitra bejniethom abbażi tat-talba li tidħol. Dan huwa dak li jissepara aġent li jista’ jagħmel ħaġa waħda minn aġent li jista’ jmexxi investigazzjoni: jiċċekkja l-istatus ta’ servizz, imbagħad l-istorja ta’ klijent, imbagħad artiklu ta’ soluzzjoni tal-problemi, mingħajr ma tikteb linja waħda ta’ kodiċi ta’ orkestrazzjoni.

Sintassi: xejn ġdid, biss diversi entrati

M’hemm l-ebda modalità multi-server li trid tattivaha. Sempliċiment iżżid oġġetti MCP multipli fil-lista tools.

from xai_sdk.tools import mcp

tools = [
    mcp(server_url="https://mcp.deepwiki.com/mcp", server_label="deepwiki"),
    mcp(server_url="https://your-custom-tools.com/mcp", server_label="custom"),
    mcp(server_url="https://api.example.com/tools", server_label="api-tools"),
]

L-istess prinċipju japplika għall-API tar-Risposti (Responses API) fil-format ta’ OpenAI, fejn kull server isir dizjunarju fil-lista. Din il-verżjoni żżid deskrizzjonijiet, li se tara li ma għadhomx fakultattivi hekk kif tuża aktar minn server wieħed.

tools = [
    {
        "type": "mcp",
        "server_url": "https://mcp.deepwiki.com/mcp",
        "server_label": "deepwiki",
        "server_description": "Documentation for GitHub open-source projects"
    },
    {
        "type": "mcp",
        "server_url": "https://your-custom-tools.com/mcp",
        "server_label": "custom",
        "server_description": "Internal company tools"
    },
    {
        "type": "mcp",
        "server_url": "https://api.example.com/tools",
        "server_label": "api-tools",
        "server_description": "Data and analytics API"
    },
]

It-tikketti jsiru strutturali

Is-server_label, li s’issa kien għajnuna għall-qari, isir essenzjali hawnhekk. Ħu xenarju komuni ħafna: tikkonnettja d-dokumentazzjoni interna tiegħek u DeepWiki, u t-tnejn jesponu għodda msejħa search. Mingħajr tikketti distinti, żewġ għodod ikollhom l-istess isem u Grok ma jkollu l-ebda mod kif jiddeċiedi. Bit-tikketti, deepwiki__search tistaqsi d-dokumentazzjoni ta’ GitHub filwaqt li internal-docs__search tfittex fil-bażi tal-għarfien tiegħek—żewġ għodod separati b’mod ċar li l-mudell jagħżel abbażi tad-deskrizzjonijiet u l-fluss tal-konversazzjoni.

Tliet regoli huma biżżejjed biex qatt ma tiltaqa’ ma’ problema. Kull tikketta trid tkun unika fil-konfigurazzjoni. Trid tirrifletti s-sors tad-data aktar mill-funzjoni teknika, għax il-provenjenza hija li tiddistingwi s-servers minn xulxin, mhux dak li jagħmlu. U trid tibqa’ qasira mingħajr ma ssir interkambjabbli. Il-kuntrast hawn taħt juri d-differenza bejn iż-żewġ approċċi:

# Tajjeb: tikketti deskrittivi u distinti
server_label="deepwiki"
server_label="crm"
server_label="jira"

# Ħażin: tikketti ambigwi
server_label="server1"
server_label="server2"
server_label="tools"

It-tikketti fit-tieni serje huma trap latenti. Jaħdmu l-jum li tiktebhom, għax inti taf x’fih server1. Sitt xhur wara, meta terġa’ taqra reġistru ta’ inċidenti, ħadd ma jaf iktar—u l-mudell, min-naħa tiegħu, qatt ma kien jaf.

Kif Grok jagħżel server

Meta jkun quddiem servers multipli, il-mudell iqabbel erba’ sorsi ta’ informazzjoni biex jiddeċiedi. Jibda bit-talba tal-utent, jiġifieri dak li qed jintalab eżattament. Imbagħad jikkonsulta s-server_description ta’ kull server, li tgħidlu għal xiex huwa kull wieħed b’mod ġenerali. Jinżel livell ‘l isfel għall-ismijiet u d-deskrizzjonijiet tal-għodod infushom, fejn kull għodda ġġib tagħha stess. U jieħu kont tal-kuntest tal-konversazzjoni, peress li l-messaġġi preċedenti jinfluwenzaw l-għażla: jekk il-klijent diġà tawk in-numru tal-kont tiegħu tliet dawriet qabel, Grok jaf li jista’ jsejjaħ crm__get_customer mingħajr ma jistaqsi mill-ġdid.

Minn dawn l-erba’ sorsi, it-tieni wieħed huwa dak li għandek l-aktar kontroll fuqu, u eżattament għalhekk id-deskrizzjonijiet isiru kritiċi fil-modalità multi-server. Mingħajr deskrizzjonijiet, Grok jerġa’ lura għall-ismijiet tal-għodod biss—search quddiem search oħra, mingħajr l-ebda indikazzjoni ta’ x’jindiċjaw. L-iżbalji fl-għażla li jirriżultaw huma saħansitra aktar konfużi għax jidhru każwali: il-mudell jagħżel korrettament nofs il-ħin, bix-xorti.

Aġent ta’ appoġġ end-to-end

Din il-konfigurazzjoni tiġbor flimkien kollox hawn fuq f’każ ta’ użu komplet.

tools = [
    mcp(
        server_url="https://kb.monentreprise.com/mcp",
        server_label="knowledge",
        server_description="Product knowledge base. Help articles, FAQ, troubleshooting guides.",
        allowed_tool_names=["search_articles", "get_article"]
    ),
    mcp(
        server_url="https://crm.monentreprise.com/mcp",
        server_label="crm",
        server_description="CRM. Customer history, previous tickets, account information.",
        authorization=f"Bearer {os.getenv('CRM_TOKEN')}",
        allowed_tool_names=["get_customer", "search_tickets", "get_ticket"]
    ),
    mcp(
        server_url="https://status.monentreprise.com/mcp",
        server_label="status",
        server_description="Service status. Ongoing incidents, scheduled maintenance.",
        allowed_tool_names=["get_current_status", "list_incidents"]
    ),
]

Klijent jikteb “is-servizz tiegħi ma għadux jaħdem”. Grok l-ewwel jiċċekkja jekk hemmx inċident għaddej permezz ta’ status__get_current_status, jikkonsulta l-kont tal-klijent b’crm__get_customer biex jaf liema servizz huwa, imbagħad ifittex artiklu ta’ soluzzjoni tal-problemi permezz ta’ knowledge__search_articles. Din is-sekwenza mhix miktuba mkien fil-kodiċi tiegħek: tiġi mid-deskrizzjonijiet u mill-mistoqsija magħmula. Innota wkoll li kull server jibqa’ ristrett għall-operazzjonijiet ta’ qari tiegħu—il-qawwa tal-multi-server qatt ma telimina l-ħtieġa ta’ allowlist.

Punti Ewlenin

  • Għaddi oġġetti MCP multipli fil-lista tools għal multi-server
  • Kull server irid ikollu server_label uniku u deskrittiv
  • Il-valuri ta’ server_description huma essenzjali biex jiggwidaw lil Grok lejn is-server it-tajjeb
  • Grok jagħżel awtomatikament is-server xieraq abbażi tat-talba u l-kuntest
  • Irrestrinġi l-għodod ta’ kull server b’allowed_tool_names biex tillimita n-niżla