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

Glaoch feidhme gutha

Ceacht 13 as 16 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Feidhmeanna a rith le linn comhrá gutha
  2. Feidhm a dhearbhú
  3. Glaoch feidhme a fháil agus a láimhseáil
  4. Glaochanna feidhme comhthreomhara
  5. Dea-chleachtais
  6. Príomhphointí

Feidhmeanna a rith le linn comhrá gutha

Ligeann glaoch feidhme gutha do d’ghníomhaire gníomhartha fíor a spreagadh le linn comhrá: bunachar sonraí a fhiosrú, ordú a chur, ríomhphost a sheoladh, nó API seachtrach a ghlaodh. Cinneann an gníomhaire cathun feidhm a ghlaodh bunaithe ar an méid a deir an t-úsáideoir.

1

Aithníonn an gníomhaire an riachtanas

Deir an t-úsáideoir rud éigin a éilíonn glaoch feidhme. Gineann an gníomhaire na hargóintí.

2

Ritheann d'aip an fheidhm

Faigheann tú na hargóintí tríd an imeacht `function_call_arguments.done` agus ritheann tú do loighic gnó.

3

Seolann tú an toradh ar ais

Seol `conversation.item.create` leis an gcineál `function_call_output` agus an `call_id`.

4

Leanann an gníomhaire leis an gcomhrá

Seol `response.create` ionas go n-oibreoidh an gníomhaire an toradh isteach ina fhreagra labhartha.

Feidhm a dhearbhú

Dearbhaíonn tú feidhmeanna san eagar tools de 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"]
        }
      }
    ]
  }
}

Glaoch feidhme a fháil agus a láimhseáil

Nuair a chinneann an gníomhaire feidhm a ghlaodh, faigheann tú na hargóintí mar shruth, agus ansin go léir in aon uair amháin:

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;

      // Rith an fheidhm
      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" };
  }

  // Seol an toradh ar ais
  ws.send(JSON.stringify({
    type: "conversation.item.create",
    item: {
      type: "function_call_output",
      call_id: callId,
      output: JSON.stringify(result)
    }
  }));

  // Iarr ar an ngníomhaire leanúint ar aghaidh
  ws.send(JSON.stringify({
    type: "response.create"
  }));
}

Glaochanna feidhme comhthreomhara

Féadfaidh an gníomhaire cinneadh roinnt feidhmeanna a ghlaodh ag an am céanna. Faigheann tú roinnt imeachtaí function_call_arguments.done ansin. Is é an riail ná:

  1. Réitigh gach feidhm sula bhfreagraíonn tú
  2. Cuir gach toradh isteach, le conversation.item.create amháin in aghaidh gach tortha
  3. Seol response.create amháin ag an deireadh
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) {
    // Tá gach feidhm réitithe
    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)
        }
      }));
    }
    // Freagra.create amháin do na haschuir go léir
    ws.send(JSON.stringify({ type: "response.create" }));
    pendingCalls.clear();
  }
  break;

Dea-chleachtais

  • Cur síosanna soiléire: braitheann cáilíocht do chur síosanna feidhme ar cathun a úsáideann an gníomhaire iad
  • Feidhmiú tapa: cruthaíonn feidhm a thógann níos mó ná 2 nó 3 shoicind ciúnas míchompordach
  • Láimhseáil earráidí: seol teachtaireacht earráide inléite seachas eisceacht theicniúil
  • Deimhniú labhartha: i gcás gníomhartha íogaire (íocaíochtaí, scriosadh), iarr ar an úsáideoir deimhniú sula ritheann tú iad

Príomhphointí

  • Leanann glaoch feidhme gutha timthriall ceithre chéim: braite, feidhmithe, toradh a thabhairt ar ais, leanúnachas
  • Dearbhaíonn tú feidhmeanna i session.update le scéama JSON dá bparaiméadair
  • Ní mór an toradh a sheoladh ar ais trí conversation.item.create le type: "function_call_output"
  • Seol response.create i gcónaí tar éis na torthaí a chur isteach
  • I gcás glaochanna comhthreomhara, fan le gach toradh sula seolann tú response.create amháin