Imeachtaí MCP i gcomhráite gutha
Ar an leathanach seo
MCP san Aighne Gutha
Ligeann an Prótacal Comhthéacs Samhla (MCP) do d’aighne gutha nascadh le freastalaithe uirlisí seachtracha trí phrótacal caighdeánaithe. Nuair a chumraíonn tú uirlis MCP i do sheisiún, eisíonn API an Aighne Gutha imeachtaí sonracha do gach céim den idirghníomhaíocht leis an bhfreastalaí MCP.
Uirlis MCP a chumrú
Chun freastalaí MCP a chumasú i do sheisiún gutha, cuir leis an liosta uirlisí é:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "mcp",
"server_url": "https://mon-serveur-mcp.exemple.com/sse",
"server_label": "Internal CRM"
}
]
}
}
Tá an réimse server_url dírithe ar do fhreastalaí MCP, agus is ainm inléite é server_label a aithníonn an freastalaí sna logaí.
Fionnachtain uirlisí
Nuair a nascann an t-aighne leis an bhfreastalaí MCP, faigheann sé liosta na n-uirlisí atá ar fáil ar dtús. Trí imeacht a mharcálann an chéim seo.
mcp_list_tools.in_progress
{
"type": "mcp_list_tools.in_progress",
"server_label": "Internal CRM"
}
Tá an freastalaí MCP á cheistiú maidir lena liosta uirlisí.
mcp_list_tools.completed
{
"type": "mcp_list_tools.completed",
"server_label": "Internal CRM",
"tools": [
{
"name": "find_customer",
"description": "Finds a customer by name or email"
},
{
"name": "create_ticket",
"description": "Creates a support ticket"
}
]
}
Fuair an córas liosta na n-uirlisí go rathúil. Is féidir leis an aighne gutha iad a úsáid anois sa chomhrá.
mcp_list_tools.failed
{
"type": "mcp_list_tools.failed",
"server_label": "Internal CRM",
"error": {
"message": "Connection timeout"
}
}
Theip ar an nasc leis an bhfreastalaí MCP. Leanfaidh an t-aighne ar aghaidh leis an gcomhrá gan na huirlisí sin.
Glaoiteanna uirlisí MCP
Nuair a chinneann an t-aighne uirlis MCP a úsáid le linn an chomhrá, eisítear tuilleadh imeachtaí.
response.mcp_call_arguments.delta / .done
Cosúil leis na himeachtaí gnáthghlao feidhme, sruthlaíonn siad argóintí an ghlao:
{
"type": "response.mcp_call_arguments.delta",
"delta": "{\"name\": \"Mil"
}
{
"type": "response.mcp_call_arguments.done",
"arguments": "{\"name\": \"Miller\"}"
}
response.mcp_call.in_progress / .completed / .failed
Rianaíonn na himeachtaí seo feidhmiú an ghlao ar an bhfreastalaí MCP:
{
"type": "response.mcp_call.in_progress",
"server_label": "Internal CRM",
"tool_name": "find_customer"
}
{
"type": "response.mcp_call.completed",
"server_label": "Internal CRM",
"tool_name": "find_customer",
"result": "{\"id\": 42, \"name\": \"Miller\", \"email\": \"[email protected]\"}"
}
{
"type": "response.mcp_call.failed",
"server_label": "Internal CRM",
"tool_name": "find_customer",
"error": {
"message": "Customer not found"
}
}
Conas a dhifríonn sé ó ghlao feidhme gnáth
Ritheann uirlisí MCP ar thaobh an fhreastalaí, trí bhonneagar xAI, mar sin ní gá duit an fheidhmiú a láimhseáil tú féin. Sin an príomhdhifríocht ó ghlao feidhme gnáth, áit a gcaithfidh d’aip an fheidhm a rith agus an toradh a sheoladh ar ais.
| Gné | Glao feidhme | MCP |
|---|---|---|
| Feidhmiú | Do aip | Freastalaí MCP cianda |
| Toradh | Seolann tú ar ais é | Uathoibríoch |
| Moill | Ag brath ar do chód | Ag brath ar an bhfreastalaí MCP |
| Cumraíocht | Scéima JSON áitiúil | URL freastalaí MCP |
Imeachtaí MCP a láimhseáil i d’aip
Seo sampla de láimhseálaí iomlán d’imeachtaí MCP:
ws.on("message", (data) => {
const event = JSON.parse(data);
switch (event.type) {
case "mcp_list_tools.in_progress":
console.log(`Connecting to MCP server: ${event.server_label}`);
break;
case "mcp_list_tools.completed":
console.log(`Available tools: ${event.tools.length}`);
break;
case "mcp_list_tools.failed":
console.error(`MCP error: ${event.error.message}`);
break;
case "response.mcp_call.in_progress":
showToolIndicator(event.tool_name);
break;
case "response.mcp_call.completed":
hideToolIndicator();
break;
case "response.mcp_call.failed":
hideToolIndicator();
showError(`Tool ${event.tool_name} unavailable`);
break;
}
});
Príomhphointí
- Ligeann uirlisí MCP don aighne gutha oibriú le freastalaithe seachtracha trí phrótacal caighdeánaithe
- Tarlaíonn fionnachtain uirlisí go huathoibríoch trí na himeachtaí
mcp_list_tools - Ritheann glaoiteanna MCP ar thaobh an fhreastalaí, seachas glao feidhme gnáth
- Téann gach glao trí thrí stáit fhéideartha:
in_progress, agus ansincompletednófailed - Láimhseáil teipeanna nasctha MCP go cúramach: is féidir leis an aighne leanúint ar aghaidh gan na huirlisí