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

Sejħa tal-funzjonijiet bil-vuċi

Lezzjoni 13 / 16 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Eżegwixxi funzjonijiet minn konversazzjoni bil-vuċi
  2. Iddikjara funzjoni
  3. Irċievi u pproċessa sejħa ta’ funzjoni
  4. Sejħiet paralleli ta’ funzjonijiet
  5. L-aħjar prattiki
  6. Punti Ewlenin

Eżegwixxi funzjonijiet minn konversazzjoni bil-vuċi

Is-sejħa tal-funzjonijiet bil-vuċi tippermetti lill-aġent tiegħek jattiva azzjonijiet reali waqt konversazzjoni: tista’ tikkonsulta bażi tad-data, tpoġġi ordni, tibgħat email, jew isejjaħ API esterna. L-aġent jiddeċiedi meta jsejjaħ funzjoni abbażi ta’ dak li jgħid l-utent.

1

L-aġent jidentifika l-ħtieġa

L-utent jgħid xi ħaġa li teħtieġ sejħa ta' funzjoni. L-aġent jiġġenera l-argumenti.

2

L-app tiegħek teħdem il-funzjoni

Int tirċievi l-argumenti permezz tal-avveniment `function_call_arguments.done` u teħdem il-loġika tan-negozju tiegħek.

3

Int tibgħat lura r-riżultat

Ibgħat `conversation.item.create` bit-tip `function_call_output` u l-`call_id`.

4

L-aġent ikompli l-konversazzjoni

Ibgħat `response.create` biex l-aġent jinkorpora r-riżultat fir-risposta mitkellma tiegħu.

Iddikjara funzjoni

Int tiddikjara l-funzjonijiet fl-arra tools ta’ session.update:

{
  "type": "session.update",
  "session": {
    "tools": [
      {
        "type": "function",
        "name": "get_balance",
        "description": "Gets the balance of a customer's bank account",
        "parameters": {
          "type": "object",
          "properties": {
            "client_id": {
              "type": "string",
              "description": "Customer ID"
            }
          },
          "required": ["client_id"]
        }
      }
    ]
  }
}

Irċievi u pproċessa sejħa ta’ funzjoni

Meta l-aġent jiddeċiedi li jsejjaħ funzjoni, int tirċievi l-argumenti bħala fluss, imbagħad kollha f’daqqa:

let functionArgs = "";

ws.on("message", (data) => {
  const event = JSON.parse(data);

  switch (event.type) {
    case "response.function_call_arguments.delta":
      functionArgs += event.delta;
      break;

    case "response.function_call_arguments.done":
      const args = JSON.parse(event.arguments);
      const callId = event.call_id;
      const functionName = event.name;

      // Eżegwixxi l-funzjoni
      handleFunctionCall(functionName, args, callId);
      break;
  }
});

async function handleFunctionCall(name, args, callId) {
  let result;

  switch (name) {
    case "get_balance":
      result = await getBalance(args.client_id);
      break;
    default:
      result = { error: "Unknown function" };
  }

  // Ibgħat lura r-riżultat
  ws.send(JSON.stringify({
    type: "conversation.item.create",
    item: {
      type: "function_call_output",
      call_id: callId,
      output: JSON.stringify(result)
    }
  }));

  // Itlob lill-aġent biex ikompli
  ws.send(JSON.stringify({
    type: "response.create"
  }));
}

Sejħiet paralleli ta’ funzjonijiet

L-aġent jista’ jiddeċiedi li jsejjaħ diversi funzjonijiet f’daqqa. Int imbagħad tirċievi diversi avvenimenti function_call_arguments.done. Ir-regola hija:

  1. Solvi kull funzjoni qabel ma tirrispondi
  2. Ippreżenta kull riżultat, b’conversation.item.create wieħed għal kull riżultat
  3. Ibgħat response.create wieħed biss fl-aħħar
const pendingCalls = new Map();
let expectedCalls = 0;

case "response.function_call_arguments.done":
  const result = await executeFunction(event.name, event.arguments);
  pendingCalls.set(event.call_id, result);

  if (pendingCalls.size === expectedCalls) {
    // Kull funzjoni ġiet solvuta
    for (const [callId, output] of pendingCalls) {
      ws.send(JSON.stringify({
        type: "conversation.item.create",
        item: {
          type: "function_call_output",
          call_id: callId,
          output: JSON.stringify(output)
        }
      }));
    }
    // response.create wieħed biss għall-output kollha
    ws.send(JSON.stringify({ type: "response.create" }));
    pendingCalls.clear();
  }
  break;

L-aħjar prattiki

  • Deskrizzjonijiet ċari: il-kwalità tad-deskrizzjonijiet tal-funzjonijiet tiegħek tiddetermina meta l-aġent jużahom
  • Eżekuzzjoni mgħaġġla: funzjoni li tieħu aktar minn 2 jew 3 sekondi toħloq silenzju imbarazzanti
  • Ġestjoni tal-iżbalji: irritorna messaġġ ta’ żball li jista’ jinqara minflok eċċezzjoni teknika
  • Konferma mitkellma: għal azzjonijiet sensittivi (pagamenti, tħassir), itlob lill-utent jikkonferma qabel ma teħdimehom

Punti Ewlenin

  • Is-sejħa tal-funzjonijiet bil-vuċi ssegwi ċiklu ta’ erba’ passi: detezzjoni, eżekuzzjoni, ritorn tar-riżultat, kontinwazzjoni
  • Int tiddikjara l-funzjonijiet f’session.update b’schema JSON għall-parametri tagħhom
  • Ir-riżultat irid jintbagħat lura permezz ta’ conversation.item.create b’type: "function_call_output"
  • Dejjem ibgħat response.create wara li tippreżenta r-riżultati
  • Għal sejħiet paralleli, stenna kull riżultat qabel ma tibgħat response.create wieħed biss