Glaoch feidhme gutha
Ar an leathanach seo
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.
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í.
Ritheann d'aip an fheidhm
Faigheann tú na hargóintí tríd an imeacht `function_call_arguments.done` agus ritheann tú do loighic gnó.
Seolann tú an toradh ar ais
Seol `conversation.item.create` leis an gcineál `function_call_output` agus an `call_id`.
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á:
- Réitigh gach feidhm sula bhfreagraíonn tú
- Cuir gach toradh isteach, le
conversation.item.createamháin in aghaidh gach tortha - Seol
response.createamhá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.updatele scéama JSON dá bparaiméadair - Ní mór an toradh a sheoladh ar ais trí
conversation.item.createletype: "function_call_output" - Seol
response.createi gcónaí tar éis na torthaí a chur isteach - I gcás glaochanna comhthreomhara, fan le gach toradh sula seolann tú
response.createamháin