Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Monipalvelinkokoonpano

Oppitunti 8 / 12 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Useita lähteitä, yksi agentti
  2. Syntaksi: ei mitään uutta, vain useita merkintöjä
  3. Tunnisteista tulee rakenteellisia
  4. Miten Grok valitsee palvelimen
  5. End-to-end-tukipalveluagentti
  6. Keskeiset asiat

Useita lähteitä, yksi agentti

Remote MCP saavuttaa täyden potentiaalinsa, kun yhdistät Grokin useisiin palvelimiin samanaikaisesti. Jokainen tuo mukanaan omat työkalunsa, ja malli toimii välittäjänä niiden välillä saapuvan pyynnön perusteella. Tämä erottaa agentin, joka osaa tehdä vain yhden asian, agentista, joka pystyy suorittamaan tutkimuksen: se tarkistaa palvelun tilan, sitten asiakashistorian ja lopuksi vianetsintäartikkelin ilman, että sinun tarvitsee kirjoittaa riviäkään orkestrointikoodia.

Syntaksi: ei mitään uutta, vain useita merkintöjä

Erillistä monipalvelintilaa ei tarvitse ottaa käyttöön. Sinun tarvitsee vain lisätä useita MCP-olioita tools-luetteloon.

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

Sama periaate pätee OpenAI-muotoiseen Responses APIiin, jossa jokainen palvelin muuttuu luettelossa olevaksi sanakirjaksi. Tässä versiossa lisätään kuvaukset, jotka eivät ole enää valinnaisia, heti kun käytät useampaa kuin yhtä palvelinta.

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

Tunnisteista tulee rakenteellisia

server_label, joka tähän asti oli vain luettavuutta parantava apuväline, muuttuu tässä yhteydessä välttämättömäksi. Tarkastellaan hyvin yleistä skenaariota: yhdistät sisäisen dokumentaatiojärjestelmäsi ja DeepWikin, ja molemmat tarjoavat työkalun nimeltä search. Ilman erillisiä tunnisteita kahdella työkalulla on sama nimi, eikä Grokilla ole keinoa tehdä valintaa. Tunnisteiden avulla deepwiki__search hakee GitHub-dokumentaatiosta, kun taas internal-docs__search etsii tietokannastasi – kaksi selkeästi erotettua työkalua, joiden välillä malli valitsee kuvausten ja keskustelun kulun perusteella.

Kolme sääntöä riittää varmistamaan, ettet kohtaa ongelmia. Jokaisen tunnisteen on oltava kokoonpanossa ainutlaatuinen. Sen on heijastettava tietolähdettä eikä teknistä toimintoa, sillä alkuperä erottaa palvelimet toisistaan, ei se, mitä ne tekevät. Ja sen on pysyttävä lyhyenä muuttumatta kuitenkaan keskenään vaihdettavaksi. Alla oleva vertailu havainnollistaa eroa näiden kahden lähestymistavan välillä:

# Hyvä: kuvaavat ja erilliset tunnisteet
server_label="deepwiki"
server_label="crm"
server_label="jira"

# Huono: epäselvät tunnisteet
server_label="server1"
server_label="server2"
server_label="tools"

Toisen sarjan tunnisteet ovat piilevä ansa. Ne toimivat kirjoitushetkellä, koska tiedät, mitä server1 sisältää. Kuusi kuukautta myöhemmin, kun luet tapahtumalokia, kukaan ei enää tiedä – eikä mallikaan ole koskaan tiennyt.

Miten Grok valitsee palvelimen

Kohtaamalla useita palvelimia malli ristiviittaa neljää tietolähdettä tehdäkseen päätöksen. Se aloittaa käyttäjän pyynnöstä, eli siitä, mitä itse asiassa kysytään. Seuraavaksi se tarkistaa kunkin palvelimen server_description-kentän, joka kertoo, mitä varten kukin palvelin yleisesti ottaen on. Se siirtyy alemmalle tasolle tarkastelemaan itse työkalujen nimiä ja kuvauksia, sillä jokaisella työkalulla on omansa. Lopuksi se ottaa huomioon keskustelukontekstin, koska aiemmat viestit vaikuttavat valintaan: jos asiakas on antanut tilinumeronsa jo kolme vuoroa aiemmin, Grok tietää voivansa kutsua crm__get_customer-funktiota kysymättä sitä uudelleen.

Näistä neljästä lähteestä toinen on se, johon sinulla on eniten vaikutusvaltaa, ja juuri siksi kuvauksista tulee kriittisiä monipalvelintilassa. Ilman kuvauksia Grok turvautuu pelkkiin työkalujen nimiin – search toista search-työkalua vasten, ilman vihjettä siitä, mitä ne indeksoivat. Tästä aiheutuvat valintavirheet ovat sitä hämmentävämpiä, koska ne vaikuttavat satunnaisilta: malli valitsee oikein vain puolet ajasta, pelkän onnen nojassa.

End-to-end-tukipalveluagentti

Tämä kokoonpano yhdistää kaikki edellä mainitut seikat yhdeksi kokonaiseksi käyttötapaukseksi.

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

Asiakas kirjoittaa “palveluni ei enää toimi”. Grok tarkistaa ensin, onko käynnissä olevia häiriöitä komennolla status__get_current_status, konsultoi asiakkaan tiliä komennolla crm__get_customer selvittääkseen, mistä palvelusta on kyse, ja etsii lopuksi vianetsintäartikkelin komennolla knowledge__search_articles. Tätä sekvenssiä ei ole kirjoitettu mihinkään koodiisi: se syntyy kuvausten ja esitetyn kysymyksen perusteella. Huomaa myös, että jokainen palvelin on rajoitettu vain lukutoimintoihinsa – monipalvelimen voima ei poista tarvetta sallituslistalle.

Keskeiset asiat

  • Välitä useita MCP-olioita tools-luettelossa monipalvelinkäyttöä varten
  • Jokaisella palvelimella on oltava ainutlaatuinen ja kuvaava server_label
  • server_description-arvot ovat välttämättömiä Grokin ohjaamiseksi oikealle palvelimelle
  • Grok valitsee automaattisesti sopivan palvelimen pyynnön ja kontekstin perusteella
  • Rajoita kunkin palvelimen työkaluja allowed_tool_names-parametrilla kohinan vähentämiseksi