---
title: "Χρησιμοποιήστε το ThunderPhone από το Pipecat"
description: "Εκτελέστε έναν φωνητικό πράκτορα ThunderPhone ως υπηρεσία ομιλία-σε-ομιλία μέσα σε μια ροή εργασίας Pipecat, με τη δική σας μεταφορά και τηλεφωνία."
---

[Pipecat](https://github.com/pipecat-ai/pipecat) είναι ένα πλαίσιο ανοιχτού κώδικα
για τη δημιουργία φωνητικών πρακτόρων από συνθέσιμες υπηρεσίες. Το ThunderPhone ενσωματώνεται ως
**υπηρεσία LLM ομιλία-σε-ομιλία**: το Pipecat στέλνει τον ήχο του καλούντος, το ThunderPhone
επιστρέφει τη φωνή του πράκτορα, απομαγνητοφωνήσεις και κλήσεις συναρτήσεων, και η
μεταφορά του Pipecat (Daily, LiveKit, Twilio, WebRTC, ένα τοπικό μικρόφωνο) μεταφέρει τον
ήχο. Η αναγνώριση ομιλίας, το γλωσσικό μοντέλο, η φωνή, η εναλλαγή σειράς ομιλίας, 62
γλώσσες και τα εργαλεία εκτελούνται όλα στο ThunderPhone.

Οι κλήσεις που πραγματοποιούνται με αυτόν τον τρόπο εμφανίζονται στο [ιστορικό κλήσεων](/api-reference/calls) και
χρεώνονται όπως κάθε άλλη κλήση σε πραγματικό χρόνο ([τιμολόγηση](/el/guides/pricing)). Δεν
απαιτείται συνδρομή ούτε χρησιμοποιείται αριθμός τηλεφώνου ThunderPhone.

## Εγκατάσταση

```bash
pip install pipecat-thunderphone
export THUNDERPHONE_API_KEY=sk_live_...   # a secret API key
```

Το πακέτο περιβάλλει την υπηρεσία OpenAI Realtime του Pipecat, επειδή το
[Realtime WebSocket](/api-reference/realtime) του ThunderPhone μιλά το ίδιο πρωτόκολλο. Απαιτεί
`pipecat-ai` 1.8 ή νεότερο.

## Εκτέλεση αποθηκευμένου πράκτορα

Όλα όσα κάνει ο πράκτορας (προτροπή, φωνή, μηχανή, γλώσσες, εργαλεία, χαιρετισμός, έλεγχοι σιωπής) ρυθμίζονται στο ThunderPhone. Ο αγωγός μεταφέρει μόνο ήχο. Δημιουργήστε τον πράκτορα στον πίνακα ελέγχου ή ζητήστε από τον Zeus (τον AI πράκτορα που δημιουργεί, δοκιμάζει και βελτιστοποιεί πράκτορες ThunderPhone) να τον ρυθμίσει και, στη συνέχεια, περάστε εδώ το αναγνωριστικό του. Οι αλλαγές που αναπτύσσετε στο ThunderPhone εφαρμόζονται στην επόμενη κλήση χωρίς να αγγίξετε τον αγωγό σας.

```python
from pipecat.pipeline.pipeline import Pipeline
from pipecat.pipeline.worker import PipelineParams, PipelineWorker
from pipecat.processors.aggregators.llm_context import LLMContext
from pipecat.processors.aggregators.llm_response_universal import LLMContextAggregatorPair
from pipecat_thunderphone import ThunderPhoneRealtimeLLMService

llm = ThunderPhoneRealtimeLLMService(agent_id=12)

context = LLMContext()
aggregators = LLMContextAggregatorPair(context)
pipeline = Pipeline([
    transport.input(),
    aggregators.user(),
    llm,
    aggregators.assistant(),
    transport.output(),
])
worker = PipelineWorker(pipeline, params=PipelineParams(allow_interruptions=True))
```

Ένας αποθηκευμένος πράκτορας ανοίγει την κλήση με το δικό του χρονοδιάγραμμα, επομένως η υπηρεσία δεν
ζητά αρχική απάντηση από το Pipecat. Περάστε `greet_on_connect=True` αν
θέλετε μία παρ' όλα αυτά.

## Διαμόρφωση της συνεδρίας ενσωματωμένα

Χωρίς `agent_id`, οι οδηγίες και τα εργαλεία προέρχονται από το περιβάλλον Pipecat,
με τον ίδιο τρόπο όπως για το OpenAI. Το `product` επιλέγει τη μηχανή και το `voice` επιλέγει τη
φωνή ThunderPhone.

```python
from pipecat.adapters.schemas.function_schema import FunctionSchema
from pipecat.adapters.schemas.tools_schema import ToolsSchema
from pipecat.services.llm_service import FunctionCallParams

llm = ThunderPhoneRealtimeLLMService(product="bolt", voice="olivia", language="es")

async def check_availability(params: FunctionCallParams):
    slots = await calendar.free_slots(params.arguments["date"])
    await params.result_callback({"slots": slots})

llm.register_function("check_availability", check_availability)

context = LLMContext(
    messages=[{"role": "system", "content": "You are Acme Dental's receptionist."}],
    tools=ToolsSchema(standard_tools=[
        FunctionSchema(
            name="check_availability",
            description="Free appointment slots on a date",
            properties={"date": {"type": "string"}},
            required=["date"],
        )
    ]),
)
```

Οι ενσωματωμένες συνεδρίες καθοδηγούνται από τον πελάτη: ο πράκτορας μιλά πρώτος επειδή το Pipecat
ζητά απάντηση όταν φτάνει το περιβάλλον και παραμένει σιωπηλός κατά τη σιωπή,
εκτός αν προσθέσετε μήνυμα ή ζητήσετε άλλη απάντηση.

## Επιλογές

| Όρισμα | Σημασία |
|---|---|
| `api_key` | Μυστικό κλειδί (`sk_live_...`). Η προεπιλογή είναι `THUNDERPHONE_API_KEY`. |
| `agent_id` | Εκτελέστε έναν αποθηκευμένο πράκτορα. Αμοιβαία αποκλειόμενο με τα `product` και `voice`. |
| `product` | Μηχανή για ενσωματωμένες συνεδρίες: `bolt` (τα παλαιότερα `spark` και `storm` εξακολουθούν να γίνονται δεκτά). |
| `voice` | Όνομα φωνής ThunderPhone για ενσωματωμένες συνεδρίες. |
| `language` | Υπόδειξη κύριας γλώσσας για ενσωματωμένες συνεδρίες, π.χ. `es`. |
| `from_number`, `to_number` | Αριθμοί που καταγράφονται στην κλήση όταν η διοχέτευση βρίσκεται μπροστά από τηλεφωνική γραμμή. |
| `live_transcripts` | Μεταδώστε τμήματα απομαγνητοφώνησης του καλούντος κατά τη διάρκεια της εκφώνησης (επιπλέον χρέωση). |
| `greet_on_connect` | Ζητήστε μια πρώτη απόκριση μόλις η συνεδρία είναι έτοιμη. |
| `end_task_on_call_ended` | Προωθήστε `EndWorkerFrame` όταν το ThunderPhone τερματίζει την κλήση (ενεργό από προεπιλογή). |

## Συμβάντα

Το ThunderPhone προσθέτει συμβάντα πλατφόρμας πάνω από το πρωτόκολλο πραγματικού χρόνου. Η υπηρεσία
τα παραδίδει στους χειριστές:

```python
@llm.event_handler("on_call_ended")
async def on_call_ended(service, event):
    print("call ended:", event["reason"], "call id:", service.call_id)
```

Το `service.call_id` ορίζεται μόλις η συνεδρία είναι ενεργή. Χρησιμοποιήστε το με το
[`GET /v1/calls/{call_id}`](/api-reference/calls) για να ανακτήσετε την εγγραφή,
την απομαγνητοφώνηση και την αξιολόγηση μετά την κλήση.

## Περιορισμοί

- Η ανίχνευση σειράς ομιλίας γίνεται από την πλευρά του διακομιστή και είναι πάντα ενεργή· οι σειρές ομιλίας που καθοδηγούνται από το Pipecat
  (`turn_detection=False`) δεν υποστηρίζονται.
- Οι συναρτήσεις που καταχωρίζονται στην υπηρεσία εκτελούνται μόνο για ενσωματωμένες συνεδρίες. Ένας αποθηκευμένος
  πράκτορας εκτελεί τα δικά του εργαλεία στο ThunderPhone.
- Ο ήχος είναι μονοφωνικό PCM 16-bit στα 24 kHz και στις δύο κατευθύνσεις.
- Τα καρέ βίντεο αγνοούνται.

<Note>
Χρησιμοποιείτε αντί αυτού LiveKit Agents; Δείτε το
[Χρήση του ThunderPhone από LiveKit Agents](/el/guides/use-with-livekit).
</Note>
