Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Cumraíocht ilfhreastalaí

Ceacht 8 as 12 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Foinseanna iolracha, gníomhaire amháin
  2. Comhréir: rud ar bith nua, ach iontrálacha iolracha
  3. Éiríonn lipéid struchtúrtha
  4. Conas a roghnaíonn Grok freastalaí
  5. Gníomhaire tacaíochta end-to-end
  6. Príomhphointí

Foinseanna iolracha, gníomhaire amháin

Baineann Remote MCP a lánphoitéinseal amach nuair a nascann tú Grok le roinnt freastalaithe ag an am céanna. Tugann gach ceann a chuid uirlisí féin leis, agus déanann an tsamhail idirghabháil eatarthu bunaithe ar an iarratas isteach. Seo an rud a dhéanann idirdhealú idir gníomhaire nach féidir ach rud amháin a dhéanamh agus gníomhaire atá in ann fiosrúchán a stiúradh: stádas seirbhíse a sheiceáil, ansin stair chustaiméara, ansin alt faoi fhadhbanna a réiteach, gan duit líne ar bith de chód eagraíochta a scríobh.

Comhréir: rud ar bith nua, ach iontrálacha iolracha

Níl aon mhód ilfhreastalaí le gníomhachtú. Ní dhéanann tú ach réada MCP iolracha a chur leis an liosta 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"),
]

Baineann an prionsabal céanna leis an Responses API i bhformáid OpenAI, áit a ndéantar foclóir sa liosta de gach freastalaí. Cuireann an leagan seo tuairiscí leis, agus feicfidh tú nach roghnach a thuilleadh iad a luaithe a úsáideann tú níos mó ná freastalaí amháin.

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

Éiríonn lipéid struchtúrtha

An server_label, rud a bhí ina chabhair inléiteachta go dtí seo, éiríonn sé riachtanach anseo. Tóg cás an-choitianta: nascann tú do chuid doiciméadaithe inmheánaí agus DeepWiki, agus nochtann an dá cheann uirlis darb ainm search. Gan lipéid ar leith, bíonn an t-ainm céanna ar dhá uirlis agus níl aon bhealach ag Grok cinneadh a dhéanamh. Le lipéid, déanann deepwiki__search ceist ar dhoiciméadú GitHub agus déanann internal-docs__search cuardach i do bhunachar eolais—dhá uirlis atá scartha go soiléir a roghnaíonn an tsamhail bunaithe ar thuairiscí agus ar shreabhadh na comhrá.

Tá trí riail leordhóthanach chun fadhb a sheachaint go hiomlán. Caithfidh gach lipéad a bheith uathúil sa chumraíocht. Caithfidh sé an fhoinse sonraí a léiriú seachas an fheidhm theicniúil, toisc gurb é an bunús a dhéanann idirdhealú idir freastalaithe, ní an rud a dhéanann siad. Agus caithfidh sé fanacht gairid gan bheith inmhalartaithe. Léiríonn an chodarsnacht thíos an bhearna idir an dá chur chuige:

# Maith: lipéid thuairisciúla agus ar leith
server_label="deepwiki"
server_label="crm"
server_label="jira"

# Droch: lipéid dhébhríoch
server_label="server1"
server_label="server2"
server_label="tools"

Is gaiste latenteach iad na lipéid sa dara sraith. Oibríonn siad an lá a scríobhann tú iad, toisc go bhfuil a fhios agat cad atá i server1. Sé mhí ina dhiaidh sin, agus tú ag athléit loga teagmhais, níl a fhios ag aon duine a thuilleadh—agus an tsamhail, ina cuid féin, ní raibh a fhios aici riamh.

Conas a roghnaíonn Grok freastalaí

Agus é os comhair ilfhreastalaithe, déanann an tsamhail tras-tagairt ar cheithre fhoinse eolais chun cinneadh a dhéanamh. Tosaíonn sí leis an iarratas ón úsáideoir, is é sin, cad a iarrtar go díreach. Ansin, déanann sí comhairliúchán le server_description gach freastalaí, a insíonn di cad é cuspóir ginearálta gach ceann. Téann sí síos leibhéal amháin go dtí ainmneacha agus tuairiscí na n-uirlisí féin, agus tuairisc dírithe ag gach uirlis. Agus tugann sí aird ar chomhthéacs na comhrá, ós rud é go mbíonn tionchar ag teachtaireachtaí roimhe seo ar an roghnú: má thug an cliant a uimhir chuntais duit trí thimthriall níos luaithe, tá a fhios ag Grok gur féidir leis crm__get_customer a ghlaow gan iarraidh arís.

As na ceithre fhoinse seo, is é an dara ceann an ceann a bhfuil an rialú is mó agat air, agus sin díreach an fáth a n-éiríonn tuairiscí ríthábhachtach i mód ilfhreastalaí. Gan tuairiscí, filleann Grok ar ainmneacha na n-uirlisí amháin—search os comhair search eile, gan aon leid faoi cad a innéacsálann siad. Tá na hearráidí roghnaithe a eascraíonn as sin níos mearbhaillí fós toisc go bhfuil siad randamach ar chuma: roghnaíonn an tsamhail i gceart leath na huaire, de thoradh seans.

Gníomhaire tacaíochta end-to-end

Tugann an chumraíocht seo gach rud thuas le chéile i gcás úsáide iomlán.

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

Scríobhann custaiméir “níl mo sheirbhís ag obair a thuilleadh”. Seiceálann Grok ar dtús an bhfuil teagmhas ar siúl trí status__get_current_status, déanann sé comhairliúchán le cuntas an chustaiméara le crm__get_customer chun a fháil amach cén tseirbhís atá i gceist, ansin déanann sé cuardach d’alt faoi fhadhbanna a réiteach trí knowledge__search_articles. Níl an seicheamh seo scríofa in áit ar bith i do chód: eascraíonn sé as na tuairiscí agus an cheist a cuireadh. Tabhair faoi deara freisin go bhfanann gach freastalaí teoranta dá chuid oibríochtaí léamh amháin—ní bhaineann cumhacht an ilfhreastalaí an ghá le liosta ceadaithe (allowlist) ar bith.

Príomhphointí

  • Cuir réada MCP iolracha sa liosta tools le haghaidh ilfhreastalaí
  • Caithfidh server_label uathúil agus tuairisciúil a bheith ag gach freastalaí
  • Tá luachanna server_description riachtanach chun Grok a threorú chuig an bhfreastalaí ceart
  • Roghnaíonn Grok an freastalaí iomchuí go huathoibríoch bunaithe ar an iarratas agus ar an gcomhthéacs
  • Srian uirlisí gach freastalaí le allowed_tool_names chun torann a theorannú