Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Konfigūravimas keliems serveriams

Paskaita 8 iš 12 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Keli šaltiniai, vienas agentas
  2. Sintaksė: nieko naujo, tiesiog keli įrašai
  3. Žymės tampa struktūrinėmis
  4. Kaip Grok pasirenka serverį
  5. Pilnas palaikymo agentas
  6. Svarbiausi punktai

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_description reikš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ą