Cumraíocht ilfhreastalaí
Ar an leathanach seo
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
toolsle haghaidh ilfhreastalaí - Caithfidh
server_labeluathúil agus tuairisciúil a bheith ag gach freastalaí - Tá luachanna
server_descriptionriachtanach 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_nameschun torann a theorannú