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

Sejħa ta' funzjonijiet f'ħin reali

Lezzjoni 4 / 18 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Sejħa ta’ funzjonijiet f’ħin reali
  2. Id-dikjarazzjoni tal-għodod fis-sessjoni
  3. Il-fluss tas-sejħa tal-funzjoni
  4. Implimentazzjoni tal-immaniġġjar tal-funzjoni
  5. Integrazzjoni fil-lavanga tal-avvenimenti
  6. Punti Ewlenin

Aġġornament 2 ta’ Novembru, 2026 — Mudelli tal-awdjo. Diversi mudelli f’dan il-kors huma deprekati: tts-1, tts-1-hd, u gpt-4o-mini-tts se jieqfu jaħdmu fis-6 ta’ Jannar, 2027 (is-sostitut indikat huwa gpt-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/translations fis-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:

1

response.function_call_arguments.delta

L-argumenti tal-funzjoni jaslu permezz ta' streaming, biċċa biċċa.

2

response.function_call_arguments.done

L-argumenti huma kompluti. Issa tista' tesegwixxi l-funzjoni.

3

conversation.item.create (int)

Tibgħat ir-riżultat tal-funzjoni lura lill-mudell.

4

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.update bl-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.create bil-call_id
  • Sejjaħ response.create sabiex 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