Għodod u sejħiet ta' funzjonijiet fil-vuċi
F'din il-paġna
Aġent li jaġixxi, mhux biss jitkellem
Assistent tal-vuċi li jista’ biss jiddiskuti malajr jilħaq ħajt: iwieġeb “Fejn hu l-ordni tiegħi?” b’mod polite, mingħajr ma jaf xejn. Il-valur reali tal-Aġent tal-Vuċi jinsab fil-kapaċità tiegħu li jieħu azzjoni f’nofs konversazzjoni (jistaqsi database, iħaddem tfittxija fuq il-web, isejjaħ API tan-negozju, jilħaq server MCP) u jaqra r-riżultat daqslikieku ma ġara xejn.
Il-ħames tipi ta’ għodod
It-tiftix fuq il-web, fl-aktar forma sempliċi tiegħu, ma jeħtieġ l-ebda parametru:
{ "type": "web_search" }
L-aġent imbagħad ifittex il-web ħaj, li jkopri mistoqsijiet fattwali, l-aħbarijiet, u kwalunkwe data li tinbidel wisq spiss biex tgħix f’prompt.
It-tiftix fuq X jaħdem bl-istess mod, bl-għażla li tillimitah għal ċerti kontijiet:
{
"type": "x_search",
"allowed_x_handles": ["corsen_ai"]
}
Il-parametru allowed_x_handles huwa opzjonali, iżda jbiddel x’inhi l-għodda. Mingħajru, l-aġent ifittex il-pjattaforma kollha; bih, l-aġent isir kelliem li jikkwota biss il-postijiet uffiċjali tiegħek.
It-tiftix tal-fajls jistaqsi ġabriet ta’ dokumenti vettorizzati, bħall-manwali tiegħek, il-proċeduri, u d-dokumentazzjoni tal-prodott:
{
"type": "file_search",
"vector_store_ids": ["vs_abc123"],
"max_num_results": 10
}
Il-funzjonijiet personalizzati jiftħu l-bieb għas-sistemi tiegħek stess. Dan huwa t-tip ta’ għodda li se tuża l-aktar, u jiswa li tiddikjarah bir-reqqa:
{
"type": "function",
"name": "check_order",
"description": "Checks the status of a customer order",
"parameters": {
"type": "object",
"properties": {
"order_number": {
"type": "string",
"description": "The order number, in the format CMD-XXXX"
}
},
"required": ["order_number"]
}
}
Tista’ tikkonnettja CRM, ERP, kalendarju, jew database interna bl-istess mod. Fl-aħħar nett, is-servers MCP jagħtu aċċess għal għodod standardizzati permezz tal-Model Context Protocol, sabiex ma jkollokx tikteb mill-ġdid integrazzjoni għal kull servizz:
{
"type": "mcp",
"server_url": "https://mcp.example.com/sse",
"server_label": "My MCP server"
}
Iċ-ċiklu sħiħ tas-sejħa tal-funzjoni
Meta l-aġent jiddeċiedi li jsejjaħ funzjoni, ma jħaddimhiex hu: jitlob lilek tagħmel hekk, u l-app tiegħek tagħmel ix-xogħol. L-argumenti l-ewwel jgħaddu b’mod kontinwu permezz ta’ response.function_call_arguments.delta. Imbagħad l-avveniment response.function_call_arguments.done jimmarka t-tmiem tat-talba u jagħtik il-call_id flimkien mal-argumenti sħaħ. Huwa f’idejk li tħaddem il-funzjoni, imbagħad tirritorna r-riżultat bħala conversation.item.create tat-tip function_call_output:
{
"type": "conversation.item.create",
"item": {
"type": "function_call_output",
"call_id": "call_abc123",
"output": "{\"status\": \"shipped\", \"delivery_date\": \"2026-04-05\"}"
}
}
Pass wieħed finali huwa essenzjali, u huwa dak li n-nies jinsu: ibgħat response.create sabiex l-aġent jinkludi r-riżultat fir-risposta mitkellma tiegħu. Mingħajru, ir-riżultat jilħaq il-konversazzjoni iżda xejn ma jiġri. L-utent jisma’ s-skiet, u inti tmur tfittex il-bug fil-post żbaljat.
Meta diversi funzjonijiet jinħarqu fl-istess ħin
Il-mudell jista’ sewwa jiddeċiedi li jsejjaħ żewġ jew tliet funzjonijiet fl-istess ħin, pereżempju biex jiċċekkja ordni u jfittex l-iskeda tal-konsenja. Int imbagħad tirċievi diversi avvenimenti function_call_arguments.done, kull wieħed bil-call_id tiegħu stess. Ħaddimhom kollha, paralleli jekk tista’ sabiex il-latencies ma jingħaddux, ippreżenta kull riżultat fil-conversation.item.create tiegħu stess, u ibgħat response.create waħda biss fl-aħħar nett. response.create waħda għal kull funzjoni tkun ttriggerja daqshekk risponsi tal-vuċi kompetittivi, u l-aġent jibda jitkellem fuq xulxin.
// Irċievi u ħaddem il-funzjonijiet kollha
const results = await Promise.all(
pendingCalls.map(call => executeFunction(call))
);
// Ippreżenta r-riżultati kollha
for (const result of results) {
ws.send(JSON.stringify({
type: "conversation.item.create",
item: {
type: "function_call_output",
call_id: result.callId,
output: JSON.stringify(result.data)
}
}));
}
// Itriggerja r-rispons
ws.send(JSON.stringify({ type: "response.create" }));
Limitazzjonijiet speċifiċi għall-vuċi
Dak li jgħaddi inosservat f’interfaċċja tat-test isir evidenti fil-kliem, li jibda bil-ħin. Ħadd ma jistenna aktar minn tlieta sa ħames sekondi f’nofs konversazzjoni. Lil hinn minn hekk, l-utenti jaħsbu li l-linja waqgħet u jibdew jitkellmu. Jekk il-funzjoni tiegħek tistaqsi sistema bil-mod, għid lill-aġent jgħid frażi ta’ stennija waqt is-sejħa minflok ma tħalli arja mejta.
Id-daqs tar-riżultati jimpatta daqstant ieħor. L-aġent irid jgħaqqad fil-qosor kull ma tagħtih, u lista ta’ erbgħin ordni tipproduċi jew reċital bla tmiem jew sommarju rough. Irritorna data strutturata, iżda żommha għal dak li jimpotta. Oqgħod attent ukoll għad-deskrizzjoni ta’ kull funzjoni, peress li hija l-uniku ħaġa li l-mudell jiddependi fuqha biex jagħżel: deskrizzjoni vaga bħal “tittratta l-ordnijiet” tagħmlu jittarda jew jagħżel l-għodda żbaljata. U ippjana għall-falliment. Meta funzjoni taqa’, irritorna messaġġ ta’ żball espliċitu f’output minflok xejn, inkella l-aġent se jimprowviża tweġiba mingħajr ma jaf li s-sejħa falliet.
Punti Ewlenin
- L-Aġent tal-Vuċi jappoġġja ħames tipi ta’ għodod: tiftix fuq il-web, tiftix fuq X, tiftix tal-fajls, funzjonijiet, u MCP
- Sejħa ta’ funzjoni tgħaddi minn erba’ passi: irċievi l-argumenti, ħaddem il-funzjoni, irritorna r-riżultat, u triggerja r-rispons
- Sejħiet paralleli huma possibbli: ħaddem kollox, ippreżenta kollox, imbagħad ibgħat
response.createwaħda biss - Fil-vuċi, il-ħin ta’ rispons tal-funzjoni huwa kritiku: immira għal inqas minn 3 sekondi