Konfigūravimas keliems serveriams
Šiame puslapyje
Keli šaltiniai, vienas agentas
„Remote MCP“ visiškai atsiskleidžia, kai prie Grok prijungi kelis serverius vienu metu. Kiekvienas jų turi savo įrankius, o modelis, atsižvelgdamas į gaunamą užklausą, parenka tinkamiausią. Būtent tai atskiria agentą, gebantį atlikti tik vieną veiksmą, nuo agento, galinčio vesti visą tyrimą: patikrinti tarnybos būseną, tada peržiūrėti kliento istoriją, galiausiai – trikčių šalinimo straipsnį, ir visa tai tau nereikia rašyti nė vienos orchestracijos kodo eilutės.
Sintaksė: nieko naujo, tiesiog keli įrašai
Nėra jokio specialaus „kelių serverių“ režimo, kurį reikėtų įjungti. Tiesiog į sąrašą tools įtrauki kelis MCP objektus.
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"),
]
Tas pats principas taikomas ir „Responses API“ OpenAI formatu: kiekvienas serveris tampa žodynu sąraše. Šioje versijoje pridėti aprašymai, kurie, kaip pamatysi, tampa privalomi, kai naudoji daugiau nei vieną serverį.
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"
},
]
Žymės tampa struktūrinėmis
server_label, iki šiol buvusi tik skaitomumo priemonė, čia tampa būtina. Įsivaizduok labai dažną scenarijų: prijungi savo vidinę dokumentaciją ir „DeepWiki“, ir abu pateikia įrankį pavadinimu search. Be skirtingų žymių, du įrankiai turės tą patį pavadinimą, ir Grok neturės kaip pasirinkti. Naudojant žymes, deepwiki__search kreipiasi į „GitHub“ dokumentaciją, o internal-docs__search ieško tavo žinių bazėje – tai du aiškiai atskirti įrankiai, kuriuos modelis pasirenka pagal aprašymus ir pokalbio eigą.
Užtenka trijų taisyklių, kad niekada nekiltų problemų. Kiekviena žymė konfigūracijoje turi būti unikali. Ji turi atspindėti duomenų šaltinį, o ne techninę funkciją, nes būtent kilmė skiria serverius vieną nuo kito, o ne tai, ką jie daro. Ir ji turi išlikti trumpa, bet netapti keičiama. Toliau pateiktas kontrastas iliustruoja skirtumą tarp dviejų požiūrių:
# Gerai: aprašomosios ir skirtingos žymės
server_label="deepwiki"
server_label="crm"
server_label="jira"
# Blogai: dviprasmiškos žymės
server_label="server1"
server_label="server2"
server_label="tools"
Antrosios serijos žymės yra paslėpta spąstai. Jos veikia tą dieną, kai jas parašai, nes žinai, ką turi server1. Po šešių mėnesių, perskaitant incidentų žurnalą, niekas jau nebežinos – o pats modelis to niekada ir nežinojo.
Kaip Grok pasirenka serverį
Susidūręs su keliais serveriais, modelis sprendimui priimti sugretina keturis informacijos šaltinius. Jis pradeda nuo naudotojo užklausos, tai yra, nuo to, ko iš tikrųjų prašoma. Tada jis peržiūri kiekvieno serverio server_description, kuris nurodo bendrą kiekvieno paskirtį. Jis leidžiasi žemiau iki pačių įrankių pavadinimų ir aprašymų – kiekvienas įrankis turi savus. Ir jis atsižvelgia į pokalbio kontekstą, nes ankstesni pranešimai daro įtaką pasirinkimui: jei klientas jau prieš tris žingsnius pateikė savo sąskaitos numerį, Grok žino, kad gali iškviesti crm__get_customer neklausdamas iš naujo.
Iš šių keturių šaltinių antrasis yra tas, kurį tu kontroliuoji labiausiai, ir būtent todėl aprašymai tampa kritiškai svarbūs veikiant kelių serverių režimu. Be aprašymų Grok remiasi tik įrankių pavadinimais – vienas search prieš kitą search, be jokios nuorodos, ką jie indeksuoja. Dėl to kylantančios pasirinkimo klaidos yra dar labiau gluminančios, nes atrodo atsitiktinės: modelis pusę atvejų pasirenka teisingai tiesiog dėl sėkmės.
Pilnas palaikymo agentas
Ši konfigūracija sujungia visa tai, kas išdėstyta aukščiau, į vieną pilną naudojimo atvejį.
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"]
),
]
Klientas parašo „mano tarnyba nebeveikia“. Grok pirmiausia patikrina, ar nėra vykstančio incidento, naudodamas status__get_current_status, tada peržiūri kliento paskyrą su crm__get_customer, kad sužinotų, apie kurią tarnybą kalbama, ir galiausiai ieško trikčių šalinimo straipsnio naudodamas knowledge__search_articles. Ši seka tavo kode niekur nėra užrašyta: ji išplaukia iš aprašymų ir užduoto klausimo. Taip pat atkreipk dėmesį, kad kiekvienas serveris lieka apribotas tik savo skaitymo operacijomis – kelių serverių galia nepanaikina būtinybės naudoti leidimų sąrašo (allowlist).
Svarbiausi punktai
- Perdavus kelis MCP objektus sąraše
tools, sukonfigūruoji darbą su keliais serveriais - Kiekvienas serveris privalo turėti unikalią ir aprašomąją
server_label server_descriptionreikšmės yra būtinos, kad Grok nukreiptų į tinkamą serverį- Grok automatiškai pasirenka tinkamą serverį, atsižvelgdamas į užklausą ir kontekstą
- Apribok kiekvieno serverio įrankius naudodamas
allowed_tool_names, kad sumažintum triukšmą