Cur síos agus Uirlisí Ceadaithe
Ar an leathanach seo
Dhá ghiaráil roghnacha, dhá éifeacht an-difriúil
Tá an URL agus an lipéad sách chun an nasc a bhunú, ach ní insíonn siad do Ghrok conas an freastalaí a úsáid. Líonann dhá pharaiméadar roghnacha an bhearna seo agus forlíonann siad a chéile: míníonn server_description cén fáth a bhfuil an freastalaí ann, agus cinneann allowed_tools—nó allowed_tool_names ag brath ar an SDK—céard atá ceadaithe dó teagmháil a dhéanamh leis. Treoraíonn an chéad cheann, agus cuireann an dara ceann srian air.
server_description: comhthéacs a thabhairt don mhúnla
Soláthraíonn an paraiméadar seo cur síos i ngnáththeanga ar chumas an fhreastalaí do Ghrok. Úsáideann an múnla é chun breithiúnas a dhéanamh: ar chóir dó ceist a chur ar an bhfreastalaí seo, ar cheann eile, nó ar cheann ar bith?
mcp(
server_url="https://api.example.com/mcp",
server_label="docs",
server_description="Technical documentation server. Lets you search articles, consult guides, and get code examples for the internal API."
)
Gan an cur síos seo, níl ag Grok ach ainmneacha agus cur síosanna na n-uirlisí aonair a nochtar. Oibríonn sé, ach déanann an múnla réasúnaíocht gan an pictiúr mór a fheiceáil: feiceann sé bailiúchán uirlisí gan a fhios cad a chruthaíonn siad le chéile. Tugann cur síos maith trí rud dó nach féidir le hainm uirlise a chur in iúl: cathain atá an freastalaí seo ábhartha seachas ceann eile, an cineál iarratas le seoladh ann, agus—rud a dhéantar dearmad go minic ach atá cinntitheach go minic—cad nach ndéanann an freastalaí, rud a sheachnaíonn glaonna atá chun teipthe ón tús.
Scríobh an cur síos seo amhail is dá mbeifeá ag míniú an tseirbhís do chomhghleacaí atá ag teacht isteach sa tionscadal. Bí sonrach: tá “Bunachar sonraí do dhoiciméadacht theicniúil táirgí” úsáideach nuair nach bhfuil “Doiciméadacht”. Ainmnigh na gníomhaíochtaí atá indéanta go díreach, mar shampla “ligeann sé duit ticéid a chuardach, a léamh, agus a nuashonrú.” Agus má tá an raon feidhme teoranta, ráiteas go soiléir é: “rochtain inléite amháin, gan athruithe” a shábhálfaidh an múnla ó iarracht theipthe.
allowed_tools: an raon feidhme a chúngú
Go réamhshocraithe, nuair a nascann tú Grok le freastalaí MCP, instealltar gach uirlis a nochtann an freastalaí sin i gcomhthéacs an mhúnla, gan eisceacht. Ar CRM, ciallaíonn sé seo go bhfuil teagmhálaithe a chruthú, a mhodhnú, agus a scriosadh chomh hinrochtana céanna le cuardach a dhéanamh orthu.
mcp(server_url="https://api.example.com/mcp",
server_label="crm")
# Grok sees ALL tools: create_contact, update_contact,
# delete_contact, search_contacts, export_data, etc.
Aisiompúnn an paraiméadar allowed_tool_names an iompraíocht seo trí liosta bán sainráite a bhunú. Éiríonn aon rud nach bhfuil air dofheicthe don mhúnla.
mcp(server_url="https://api.example.com/mcp",
server_label="crm",
allowed_tool_names=["search_contacts", "get_contact_details"])
# Grok sees only search_contacts and get_contact_details
Cén fáth srian a chur, fiú nuair a oibríonn gach rud
Is é an chéad chúis ná slándáil, agus leanann sé prionsabal na pribhléide is lú. Mura bhfuil de dhíth ar d’iarratas ach léamh, ná fág uirlisí modhnaithe nó scriosta laistigh de reach an mhúnla. Ní féidir le instealladh leid mailíseach—instrucáid dhíobhálach sleamhnaithe isteach i ndoiciméad a ndéanann Grok anailís air—delete_contact a spreagadh nár nochtadh riamh. Tiontaíonn an liosta bán eachtra fhéideartha ina neamh-imeacht.
# Read-only for a public chatbot
allowed_tool_names=["search_database", "get_record", "format_data"]
Is é an dara cúis ná feidhmíocht. Glacann gach uirlis nochtaithe spás sa bhfuinneog comhthéacs, ós rud é go gcaithfidh a hainm, a cur síos, agus a scéama paraiméadair oiriúnú ann. Itheann freastalaí MCP a fhoilsíonn caoga uirlis toirt mhór sula bhfuil an t-úsáideoir tar éis fiú a cheist a chur. Trí titim síos go dtí cúig uirlis atá fíor-úsáideach, faigheann tú an spás sin ar ais don rud is tábhachtaí: an comhrá féin.
Is é an tríú cúis ná cruinneas. Dá fhorleithne an catalóg, is ea is mó a leathanaíonn an múnla idir uirlisí cosúla—agus cruthaíonn dhá uirlis le cur síosanna cosúla roghanna éagobhsaí ó rith amháin go ceann eile. Déanann catalóg atá teanntaithe timpeall do chás úsáide an roghnú i bhfad níos iontaofa.
An dá cheann a oibriú le chéile
Éiríonn an toradh an-ghlan nuair a chomhcheanglaíonn tú an dá pharaiméadar, ar choinníoll go n-insíonn siad an scéal céanna.
mcp(
server_url="https://api.example.com/mcp",
server_label="crm",
server_description="Read-only CRM. Search and view contacts and companies.",
allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)
Anseo, fógraíonn an cur síos rochtain inléite amháin agus ráthaíonn an liosta bán é go teicniúil. Bí ar an airdeall maidir leis an staid mhalairt, a tharlaíonn níos minice ná a shílfeá: cur síos a fuarthas ó leagan roimhe seo a gheallann cumais scríofa atá bainte anois ón liosta bán. Déanfaidh an múnla iarracht an glao a dhéanamh, teipfidh air, agus caithfidh tú am ag lorg fabht nach bhfuil ann. Déan athbhreithniú ar an dá pharaiméadar seo le chéile i gcónaí, ní ar leithligh riamh.
Príomhphointí
- Cabhraíonn
server_descriptionle Grok a thuiscint cathain ba chóir an freastalaí MCP seo a úsáid - Gan
allowed_tools, instealltar gach uirlis freastalaí isteach sa chomhthéacs - Neartaíonn srian a chur le huirlisí slándáil, feidhmíocht, agus cruinneas
- Comhcheangail cur síos agus srian chun rialú optamach a fháil
- Scríobh an cur síos mar mhíniú i ngnáththeanga ar chumas an fhreastalaí