Salt la conținutul principal
Română— Alege o limbă
Meniu

Configurare multi-server

Lecția 8 din 12 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Surse multiple, un singur agent
  2. Sintaxă: nimic nou, doar mai multe intrări
  3. Etichetele devin structurale
  4. Cum selectează Grok un server
  5. Un agent de suport end-to-end
  6. Puncte cheie

Surse multiple, un singur agent

MCP la distanță își atinge potențialul maxim atunci când conectați Grok la mai multe servere simultan. Fiecare aduce propriile instrumente, iar modelul arbitrează între ele în funcție de cererea primită. Aceasta este diferența dintre un agent care poate face un singur lucru și un agent capabil să conducă o investigație: verificarea stării unui serviciu, apoi a istoricului unui client, apoi a unui articol de depanare, fără ca dumneavoastră să scrieți o singură linie de cod de orchestrare.

Sintaxă: nimic nou, doar mai multe intrări

Nu există un mod „multi-server“ de activat. Pur și simplu adăugați mai multe obiecte MCP în 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"),
]

Același principiu se aplică API-ului Responses în format OpenAI, unde fiecare server devine un dicționar în listă. Această versiune adaugă descrieri, care, după cum veți observa, nu mai sunt opționale imediat ce utilizați mai mult de un 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"
    },
]

Etichetele devin structurale

server_label, până acum un simplu ajutor pentru lizibilitate, devine esențial aici. Luați un scenariu foarte comun: conectați documentația internă și DeepWiki, iar ambele expun un instrument numit search. Fără etichete distincte, două instrumente poartă același nume, iar Grok nu are cum să decidă. Cu etichete, deepwiki__search interoghează documentația GitHub, în timp ce internal-docs__search caută în baza dumneavoastră de cunoștințe – două instrumente clar separate pe care modelul le alege pe baza descrierilor și a fluxului conversației.

Trei reguli sunt suficiente pentru a nu întâlni niciodată o problemă. Fiecare etichetă trebuie să fie unică în configurație. Trebuie să reflecte sursa de date mai degrabă decât funcția tehnică, deoarece proveniența este cea care distinge serverele între ele, nu ceea ce fac. Și trebuie să rămână scurtă fără a deveni interschimbabilă. Contrastul de mai jos ilustrează decalajul dintre cele două abordări:

# Good: descriptive and distinct labels
server_label="deepwiki"
server_label="crm"
server_label="jira"

# Bad: ambiguous labels
server_label="server1"
server_label="server2"
server_label="tools"

Etichetele din a doua serie sunt o capcană latentă. Funcționează în ziua în care le scrieți, pentru că știți ce conține server1. Șase luni mai târziu, la recitirea unui jurnal de incidente, nimeni nu mai știe – iar modelul, din partea sa, nu a știut niciodată.

Cum selectează Grok un server

În fața mai multor servere, modelul corelează patru surse de informații pentru a decide. Începe cu cererea utilizatorului, adică ceea ce se cere efectiv. Apoi consultă server_description al fiecărui server, care îi indică scopul general al fiecăruia. Coboară un nivel până la numele și descrierile instrumentelor în sine, fiecare instrument purtându-le pe ale sale. Și ia în considerare contextul conversației, deoarece mesajele anterioare influențează selecția: dacă clientul v-a oferit deja numărul de cont cu trei replici mai devreme, Grok știe că poate apela crm__get_customer fără a mai întreba din nou.

Dintre aceste patru surse, a doua este cea asupra căreia aveți cel mai mult control, și tocmai de aceea descrierile devin critice în modul multi-server. Fără descrieri, Grok se bazează doar pe numele instrumentelor – un search în fața altui search, fără nicio indicație despre ce indexează. Erorile de selecție care rezultă sunt cu atât mai confuze deoarece par aleatorii: modelul alege corect jumătate din timp, din noroc.

Un agent de suport end-to-end

Această configurație reunește toate elementele de mai sus într-un caz de utilizare complet.

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"]
    ),
]

Un client scrie „serviciul meu nu mai funcționează“. Grok verifică mai întâi dacă există un incident în curs prin status__get_current_status, consultă contul clientului cu crm__get_customer pentru a ști despre ce serviciu este vorba, apoi caută un articol de depanare prin knowledge__search_articles. Această secvență nu este scrisă nicăieri în codul dumneavoastră: ea rezultă din descrieri și din întrebarea pusă. Rețineți, de asemenea, că fiecare server rămâne restricționat la operațiunile sale de citire – puterea multi-server nu elimină niciodată nevoia unei liste de permisiuni (allowlist).

Puncte cheie

  • Transmiteți mai multe obiecte MCP în lista tools pentru configurarea multi-server
  • Fiecare server trebuie să aibă un server_label unic și descriptiv
  • Valorile server_description sunt esențiale pentru a ghida Grok către serverul potrivit
  • Grok selectează automat serverul adecvat pe baza cererii și a contextului
  • Restricționați instrumentele fiecărui server cu allowed_tool_names pentru a limita zgomotul