MCP-tapahtumat äänikeskusteluissa
Tällä sivulla
MCP ääniagentissa
Model Context Protocol (MCP) mahdollistaa ääniagenttisi yhdistämisen ulkoisiin työkalupalvelimiin standardoidun protokollan kautta. Kun määrität MCP-työkalun istuntoosi, Voice Agent API lähettää erityisiä tapahtumia jokaiselle MCP-palvelimen kanssa käydyn vuorovaikutuksen vaiheelle.
MCP-työkalun määrittäminen
Ottaaksesi MCP-palvelimen käyttöön ääni-istunnossasi, lisää se työkalujen luetteloon:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "mcp",
"server_url": "https://mon-serveur-mcp.exemple.com/sse",
"server_label": "Internal CRM"
}
]
}
}
Kenttä server_url osoittaa MCP-palvelimesi sijaintiin, ja server_label on luettava nimi, joka tunnistaa palvelimen lokeissa.
Työkalujen etsintä
Kun agentti muodostaa yhteyden MCP-palvelimeen, se hakee ensin saatavilla olevien työkalujen luettelon. Kolme tapahtumaa merkitsee tätä vaihetta.
mcp_list_tools.in_progress
{
"type": "mcp_list_tools.in_progress",
"server_label": "Internal CRM"
}
MCP-palvelimelta haetaan sen työkalujen luetteloa.
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"
}
]
}
Työkalujen luettelo haettiin onnistuneesti. Ääniagentti voi nyt käyttää niitä keskustelussa.
mcp_list_tools.failed
{
"type": "mcp_list_tools.failed",
"server_label": "Internal CRM",
"error": {
"message": "Connection timeout"
}
}
Yhteys MCP-palvelimeen epäonnistui. Agentti jatkaa keskustelua ilman kyseisiä työkaluja.
MCP-työkalukutsut
Kun agentti päättää käyttää MCP-työkalua keskustelun aikana, lisää tapahtumia lähetetään.
response.mcp_call_arguments.delta / .done
Kuten tavallisissa funktiokutsutapahtumissa, nämä suoratoistavat kutsun argumentit:
{
"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
Nämä tapahtumat seuraavat kutsun suorittamista MCP-palvelimella:
{
"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"
}
}
Miten tämä eroaa tavallisesta funktiokutsusta
MCP-työkalut suoritetaan palvelinpuolella xAI:n infrastruktuurin kautta, joten sinun ei tarvitse huolehtia suorittamisesta itse. Tämä on tärkein ero tavalliseen funktiokutsuun, jossa sovelluksesi täytyy suorittaa funktio ja lähettää tulos takaisin.
| Näkökohta | Funktiokutsu | MCP |
|---|---|---|
| Suoritus | Sovelluksesi | Etä-MCP-palvelin |
| Tulos | Lähetät sen takaisin | Automaattinen |
| Viive | Riippuu koodistasi | Riippuu MCP-palvelimesta |
| Määrittely | Paikallinen JSON-skeema | MCP-palvelimen URL-osoite |
MCP-tapahtumien käsittely sovelluksessasi
Tässä on esimerkki täydellisestä käsittelijästä MCP-tapahtumille:
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;
}
});
Keskeiset asiat
- MCP-työkalut mahdollistavat ääniagentin työskentelyn ulkoisten palvelimien kanssa standardoidun protokollan kautta
- Työkalujen etsintä tapahtuu automaattisesti
mcp_list_tools-tapahtumien kautta - MCP-kutsut suoritetaan palvelinpuolella, toisin kuin tavallisessa funktiokutsussa
- Jokainen kutsu käy läpi kolme mahdollista tilaa:
in_progress, jonka jälkeen jokocompletedtaifailed - Käsittele MCP-yhteysvirheet hallitusti: agentti pystyy jatkamaan toimintaa ilman työkaluja