Sejħa tal-funzjonijiet bil-vuċi
F'din il-paġna
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.
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.
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.
Int tibgħat lura r-riżultat
Ibgħat `conversation.item.create` bit-tip `function_call_output` u l-`call_id`.
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:
- Solvi kull funzjoni qabel ma tirrispondi
- Ippreżenta kull riżultat, b’
conversation.item.createwieħed għal kull riżultat - Ibgħat
response.createwieħ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.updateb’schema JSON għall-parametri tagħhom - Ir-riżultat irid jintbagħat lura permezz ta’
conversation.item.createb’type: "function_call_output" - Dejjem ibgħat
response.createwara li tippreżenta r-riżultati - Għal sejħiet paralleli, stenna kull riżultat qabel ma tibgħat
response.createwieħed biss