Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Għodod u sejħiet ta' funzjonijiet fil-vuċi

Lezzjoni 5 / 14 Aġġornat 29 ta’ Lulju 2026 Livell Medju
F'din il-paġna
  1. Aġent li jaġixxi, mhux biss jitkellem
  2. Il-ħames tipi ta’ għodod
  3. Iċ-ċiklu sħiħ tas-sejħa tal-funzjoni
  4. Meta diversi funzjonijiet jinħarqu fl-istess ħin
  5. Limitazzjonijiet speċifiċi għall-vuċi
  6. Punti Ewlenin

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.create waħda biss
  • Fil-vuċi, il-ħin ta’ rispons tal-funzjoni huwa kritiku: immira għal inqas minn 3 sekondi