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

Imeachtaí MCP i gcomhráite gutha

Ceacht 12 as 16 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. MCP san Aighne Gutha
  2. Uirlis MCP a chumrú
  3. Fionnachtain uirlisí
  4. Glaoiteanna uirlisí MCP
  5. Conas a dhifríonn sé ó ghlao feidhme gnáth
  6. Imeachtaí MCP a láimhseáil i d’aip
  7. Príomhphointí

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 feidhmeMCP
FeidhmiúDo aipFreastalaí MCP cianda
ToradhSeolann tú ar ais éUathoibríoch
MoillAg brath ar do chódAg brath ar an bhfreastalaí MCP
CumraíochtScéima JSON áitiúilURL 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 ansin completed nó failed
  • Láimhseáil teipeanna nasctha MCP go cúramach: is féidir leis an aighne leanúint ar aghaidh gan na huirlisí