Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Κλήση συναρτήσεων σε πραγματικό χρόνο

Μάθημα 4 / 18 Ενημερώθηκε 2 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Κλήση συναρτήσεων σε πραγματικό χρόνο
  2. Δήλωση εργαλείων στη συνεδρία
  3. Η ροή κλήσης συνάρτησης
  4. Υλοποίηση του χειριστή συνάρτησης
  5. Ενσωμάτωση στον βρόχο γεγονότων
  6. Βασικά σημεία

Ενημέρωση 2 Νοεμβρίου 2026 — Μοντέλα ήχου. Αρκετά μοντέλα σε αυτό το μάθημα έχουν καταργηθεί: τα tts-1, tts-1-hd και gpt-4o-mini-tts θα παύσουν να λειτουργούν στις 6 Ιανουαρίου 2027 (η υποδεικνυόμενη αντικατάσταση είναι το gpt-realtime-2.1-mini, το οποίο ο οδηγός TTS της OpenAI αναφέρει ότι δεν υποστηρίζεται από το /v1/audio/speech: η μετάβαση στη σύνθεση ομιλίας μεταφέρεται στο Realtime API)· τα gpt-realtime, gpt-4o-realtime και τα παλαιότερα μοντέλα ήχου στις 20 Ιανουαρίου 2027 (gpt-realtime-2.1, gpt-realtime-2.1-mini, gpt-audio-1.5)· τα whisper-1, gpt-4o-transcribe και το /v1/audio/translations στις 26 Φεβρουαρίου 2027 (gpt-transcribe, gpt-live-transcribe, v1/realtime/translations). Για αμφίδρομη φωνητική επικοινωνία πλήρους διπλέξ, το GPT-Live 1 είναι διαθέσιμο στο API από τις 10 Σεπτεμβρίου 2026.

Κλήση συναρτήσεων σε πραγματικό χρόνο

Η κλήση συναρτήσεων στο Realtime API επιτρέπει στον φωνητικό σας πράκτορα να εκτελεί συγκεκριμένες ενέργειες κατά τη διάρκεια μιας συνομιλίας: ερώτημα σε βάση δεδομένων, καταχώρηση παραγγελίας ή έλεγχος κατάστασης. Ο μηχανισμός είναι παρόμοιος με αυτόν του Responses API, αλλά προσαρμοσμένος για τη ροή γεγονότων μέσω WebSocket.

Δήλωση εργαλείων στη συνεδρία

Δηλώνετε τα εργαλεία στο session.update, ακριβώς όπως τις οδηγίες και τη φωνή. Κάθε εργαλείο είναι ένα σχήμα JSON που περιγράφει τις παραμέτρους του:

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"
    }
}))

Η ροή κλήσης συνάρτησης

Όταν το μοντέλο αποφασίζει να καλέσει ένα εργαλείο, η ακολουθία γεγονότων είναι η εξής:

1

response.function_call_arguments.delta

Τα ορίσματα της συνάρτησης φτάνουν μέσω ροής (streaming), τμήμα προς τμήμα.

2

response.function_call_arguments.done

Τα ορίσματα έχουν ολοκληρωθεί. Μπορείτε πλέον να εκτελέσετε τη συνάρτηση.

3

conversation.item.create (εσείς)

Στέλνετε το αποτέλεσμα της συνάρτησης πίσω στο μοντέλο.

4

response.create (εσείς)

Ζητάτε από το μοντέλο να συνεχίσει την απάντησή του με το αποτέλεσμα.

Υλοποίηση του χειριστή συνάρτησης

Ακολουθεί ένα πλήρες παράδειγμα χειρισμού κλήσεων συναρτήσεων:

import json

# Μητρώο διαθέσιμων συναρτήσεων
async def get_weather(city: str, unit: str = "celsius") -> dict:
    # Κλήση πραγματικού API καιρού
    return {"city": city, "temperature": 22, "unit": unit, "condition": "sunny"}

async def book_appointment(date: str, time: str, service: str) -> dict:
    # Λογική κράτησης
    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):
    """Επεξεργάζεται μια κλήση συνάρτησης και επιστρέφει το αποτέλεσμα."""
    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})")

        # Εκτέλεση της συνάρτησης
        func = FUNCTION_REGISTRY.get(func_name)
        if func:
            result = await func(**arguments)
        else:
            result = {"error": f"Unknown function: {func_name}"}

        # Αποστολή του αποτελέσματος πίσω στο μοντέλο
        await ws.send(json.dumps({
            "type": "conversation.item.create",
            "item": {
                "type": "function_call_output",
                "call_id": call_id,
                "output": json.dumps(result)
            }
        }))

    # Ζήτηση συνέχισης από το μοντέλο με το αποτέλεσμα
    await ws.send(json.dumps({
        "type": "response.create"
    }))

Ενσωμάτωση στον βρόχο γεγονότων

Ο χειριστής συνάρτησης ενσωματώνεται στον κύριο βρόχο σας:

async def event_loop(ws):
    """Κύριος βρόχος επεξεργασίας γεγονότων."""
    async for raw_message in ws:
        event = json.loads(raw_message)
        event_type = event["type"]

        if event_type == "response.done":
            response = event["response"]
            # Έλεγχος αν το μοντέλο κάλεσε οποιεσδήποτε συναρτήσεις
            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":
            # Αναπαραγωγή ήχου απάντησης
            audio_bytes = base64.b64decode(event["delta"])
            player.write(audio_bytes)

        elif event_type == "error":
            print(f"Error: {event['error']['message']}")

Πολλαπλές κλήσεις συναρτήσεων

Το μοντέλο μπορεί να αποφασίσει να καλέσει πολλαπλές συναρτήσεις σε μία μόνο απάντηση. Το πεδίο output του response.done μπορεί να περιέχει πολλαπλές εγγραφές τύπου function_call. Επεξεργαστείτε όλες τους πριν καλέσετε το response.create.

Βασικά σημεία

  • Τα εργαλεία δηλώνονται στο session.update χρησιμοποιώντας ένα τυπικό σχήμα JSON
  • Τα ορίσματα φτάνουν μέσω ροής (streaming) μέσω του response.function_call_arguments.delta
  • Μετά την εκτέλεση, στείλτε το αποτέλεσμα πίσω μέσω του conversation.item.create με το call_id
  • Καλέστε το response.create ώστε το μοντέλο να διατυπώσει την φωνητική του απάντηση με το αποτέλεσμα
  • Διαχειριστείτε πολλαπλές κλήσεις: το μοντέλο μπορεί να καλέσει αρκετές συναρτήσεις ταυτόχρονα