Sejħa ta' funzjonijiet f'ħin reali
F'din il-paġna
Aġġornament 2 ta’ Novembru, 2026 — Mudelli tal-awdjo. Diversi mudelli f’dan il-kors huma deprekati:
tts-1,tts-1-hd, ugpt-4o-mini-ttsse jieqfu jaħdmu fis-6 ta’ Jannar, 2027 (is-sostitut indikat huwagpt-realtime-2.1-mini, li l-gwida tat-TTS ta’ OpenAI tiddikjara li mhux appoġġjata minn/v1/audio/speech: il-migrazzjoni tas-sinteżi tal-kelma tmur lejn ir-Realtime API);gpt-realtime,gpt-4o-realtime, u mudelli tal-awdjo legacy fl-20 ta’ Jannar, 2027 (gpt-realtime-2.1,gpt-realtime-2.1-mini,gpt-audio-1.5);whisper-1,gpt-4o-transcribe, u/v1/audio/translationsfis-26 ta’ Frar, 2027 (gpt-transcribe,gpt-live-transcribe,v1/realtime/translations). Għal-leħen full-duplex, GPT-Live 1 kien disponibbli fl-API mill-10 ta’ Settembru, 2026.
Sejħa ta’ funzjonijiet f’ħin reali
Is-sejħa ta’ funzjonijiet fir-Realtime API tippermetti lill-aġent bil-leħen tiegħek iwettaq azzjonijiet konkreti waqt konversazzjoni: tistaqsi bażi tad-data, tpoġġi ordni, jew tiċċekkja status. Il-mekkaniżmi huma simili għar-Responses API, iżda adattati għall-fluss ta’ avvenimenti WebSocket.
Id-dikjarazzjoni tal-għodod fis-sessjoni
Tiddikjara l-għodod f’session.update, eżattament bħall-istruzzjonijiet u l-leħen. Kull għodda hija skema JSON li tiddeskrivi l-parametri tagħha:
tools = [
{
"type": "function",
"name": "get_weather",
"description": "Get the current weather for a given city",
"parameters": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "Name of the city"
},
"unit": {
"type": "string",
"enum": ["celsius", "fahrenheit"],
"description": "Temperature unit"
}
},
"required": ["city"]
}
},
{
"type": "function",
"name": "book_appointment",
"description": "Book an appointment",
"parameters": {
"type": "object",
"properties": {
"date": {"type": "string", "description": "Date in YYYY-MM-DD format"},
"time": {"type": "string", "description": "Time in HH:MM format"},
"service": {"type": "string", "description": "Type of service"}
},
"required": ["date", "time", "service"]
}
}
]
await ws.send(json.dumps({
"type": "session.update",
"session": {
"type": "realtime",
"output_modalities": ["audio"],
"instructions": "You are a voice assistant. Use the available tools.",
"audio": {"output": {"voice": "marin"}},
"tools": tools,
"tool_choice": "auto"
}
}))
Il-fluss tas-sejħa tal-funzjoni
Meta l-mudell jiddeċiedi li jsejjaħ għodda, is-sekwenza tal-avvenimenti hija kif ġej:
response.function_call_arguments.delta
L-argumenti tal-funzjoni jaslu permezz ta' streaming, biċċa biċċa.
response.function_call_arguments.done
L-argumenti huma kompluti. Issa tista' tesegwixxi l-funzjoni.
conversation.item.create (int)
Tibgħat ir-riżultat tal-funzjoni lura lill-mudell.
response.create (int)
Titlob lill-mudell biex ikompli r-risposta tiegħu bir-riżultat.
Implimentazzjoni tal-immaniġġjar tal-funzjoni
Hawnhekk hemm eżempju sħiħ ta’ kif timmaniġġja s-sejħiet tal-funzjonijiet:
import json
# Reġistru tal-funzjonijiet disponibbli
async def get_weather(city: str, unit: str = "celsius") -> dict:
# Sejjaħ API reali tat-temp
return {"city": city, "temperature": 22, "unit": unit, "condition": "sunny"}
async def book_appointment(date: str, time: str, service: str) -> dict:
# Loġika tal-booking
return {"confirmed": True, "date": date, "time": time, "reference": "RDV-2026-0042"}
FUNCTION_REGISTRY = {
"get_weather": get_weather,
"book_appointment": book_appointment,
}
async def handle_function_call(ws, event):
"""Jipproċessa sejħa ta' funzjoni u jirritorna r-riżultat."""
response = event["response"]
for output in response.get("output", []):
if output["type"] != "function_call":
continue
func_name = output["name"]
call_id = output["call_id"]
arguments = json.loads(output["arguments"])
print(f"Calling function: {func_name}({arguments})")
# Esegwixxi l-funzjoni
func = FUNCTION_REGISTRY.get(func_name)
if func:
result = await func(**arguments)
else:
result = {"error": f"Unknown function: {func_name}"}
# Ibghat ir-riżultat lura lill-mudell
await ws.send(json.dumps({
"type": "conversation.item.create",
"item": {
"type": "function_call_output",
"call_id": call_id,
"output": json.dumps(result)
}
}))
# Itlob lill-mudell biex ikompli bir-riżultat
await ws.send(json.dumps({
"type": "response.create"
}))
Integrazzjoni fil-lavanga tal-avvenimenti
L-immaniġġjar tal-funzjoni jintegra fil-lavanga prinċipali tiegħek:
async def event_loop(ws):
"""Lavanga prinċipali tal-ipproċessar tal-avvenimenti."""
async for raw_message in ws:
event = json.loads(raw_message)
event_type = event["type"]
if event_type == "response.done":
response = event["response"]
# Iċċekkja jekk il-mudell sejjaħ xi funzjonijiet
has_function_calls = any(
o["type"] == "function_call"
for o in response.get("output", [])
)
if has_function_calls:
await handle_function_call(ws, event)
elif event_type == "response.output_audio.delta":
# Doqq l-awdjo tar-risposta
audio_bytes = base64.b64decode(event["delta"])
player.write(audio_bytes)
elif event_type == "error":
print(f"Error: {event['error']['message']}")
Sejħiet multipli ta’ funzjonijiet
Il-mudell jista’ jiddeċiedi li jsejjaħ funzjonijiet multipli f’risposta waħda. Il-qasam output ta’ response.done jista’ jkun fih diversi entrati tat-tip function_call. Ipproċessahom kollha qabel ma ssejjaħ response.create.
Punti Ewlenin
- L-għodod huma ddikjarati f’
session.updatebl-użu ta’ skema JSON standard - L-argumenti jaslu permezz ta’ streaming permezz ta’
response.function_call_arguments.delta - Wara l-eżekuzzjoni, ibgħat ir-riżultat lura permezz ta’
conversation.item.createbil-call_id - Sejjaħ
response.createsabiex il-mudell ikun jista’ jifformula r-risposta bil-leħen tiegħu bir-riżultat - Immaniġġja sejħiet multipli: il-mudell jista’ jsejjaħ diversi funzjonijiet f’daqqa