---
title: "Gunakan ThunderPhone dari LiveKit Agents"
description: "Jalankan agen suara ThunderPhone sebagai model realtime (ucapan-ke-ucapan) dalam sesi LiveKit Agents, dengan room LiveKit, SIP, dan teleponi di sekelilingnya."
---

[LiveKit Agents](https://github.com/livekit/agents) adalah framework sumber terbuka
untuk agen suara realtime di atas room LiveKit. ThunderPhone terintegrasi sebagai
**model realtime**: framework mengirim audio peserta, ThunderPhone
mengembalikan suara agen, transkrip, dan pemanggilan fungsi, sementara room LiveKit,
trunk SIP, dan teleponi membawa audio. Pengenalan suara, model bahasa,
suara, pengambilan giliran, 62 bahasa, dan alat semuanya berjalan di ThunderPhone.

Panggilan yang dilakukan dengan cara ini muncul di [riwayat panggilan](/api-reference/calls) dan
ditagihkan seperti panggilan realtime lainnya ([harga](/id/guides/pricing)). Tidak ada
langganan maupun nomor telepon ThunderPhone yang terlibat.

## Instal

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

Dengan uv, `uv add "livekit-agents[thunderphone]~=1.8"` menginstal plugin yang sama. Plugin ini tersedia di repositori [livekit/agents](https://github.com/livekit/agents) dan dirilis bersama `livekit-agents`, jadi pertahankan keduanya pada versi yang sama. LiveKit mendokumentasikannya dalam [panduan plugin ThunderPhone](https://docs.livekit.io/agents/models/realtime/thunderphone/).

Plugin ini membungkus model OpenAI Realtime LiveKit, karena
[Realtime WebSocket](/api-reference/realtime) ThunderPhone menggunakan protokol yang sama. Plugin ini
memerlukan `livekit-agents` versi 1.8 atau yang lebih baru.

## Jalankan agen tersimpan

Semua yang dilakukan agen (Prompt, suara, engine, bahasa, alat, sapaan, pemeriksaan saat hening) dikonfigurasi di ThunderPhone. Sesi hanya memindahkan audio. Buat agen di dasbor, atau minta Zeus (agen AI yang membuat, menguji, dan menyetel agen ThunderPhone) untuk menyiapkannya, lalu teruskan ID-nya di sini. Perubahan yang Anda deploy di ThunderPhone berlaku pada panggilan berikutnya tanpa menyentuh kode LiveKit Anda.

```python
from livekit.agents import Agent, AgentSession, JobContext, WorkerOptions, cli
from livekit.plugins import thunderphone


async def entrypoint(ctx: JobContext):
    session = AgentSession(llm=thunderphone.RealtimeModel(agent_id=12))
    await session.start(agent=Agent(instructions=""), room=ctx.room)


if __name__ == "__main__":
    cli.run_app(WorkerOptions(entrypoint_fnc=entrypoint))
```

Agen tersimpan menyapa dan menjalankan alatnya sendiri di ThunderPhone; instruksi
dan alat `Agent` LiveKit tidak dikirim. Panggilan berakhir saat agen
ThunderPhone menutup panggilan, dan sesi ditutup bersamanya.

## Konfigurasikan sesi secara inline

Tanpa `agent_id`, instruksi dan alat berasal dari `Agent` LiveKit, sama seperti pada OpenAI. `model` memilih mesin dan `voice` memilih suara ThunderPhone.

```python
from livekit.agents import Agent, AgentSession, RunContext, function_tool
from livekit.plugins import thunderphone


class Receptionist(Agent):
    def __init__(self):
        super().__init__(instructions="You are Acme Dental's receptionist. Be brief.")

    @function_tool
    async def check_availability(self, context: RunContext, date: str) -> dict:
        """Free appointment slots on a date."""
        return {"slots": await calendar.free_slots(date)}


async def entrypoint(ctx: JobContext):
    session = AgentSession(
        llm=thunderphone.RealtimeModel(model="bolt", voice="olivia", language="es"),
    )
    await session.start(agent=Receptionist(), room=ctx.room)
    await session.generate_reply()   # the agent speaks first
```

ThunderPhone mengunci instruksi dan alat saat panggilan dimulai, sehingga
`update_instructions`, `update_tools`, dan pengalihan agen yang mengubahnya
tidak didukung di tengah panggilan. Sesi inline dikendalikan oleh klien: agen berbicara
saat Anda memanggil `generate_reply()` atau saat peserta menyelesaikan satu giliran.

## Opsi

| Argumen | Arti |
|---|---|
| `api_key` | Kunci rahasia (`sk_live_...`). Secara default menggunakan `THUNDERPHONE_API_KEY`. |
| `agent_id` | Jalankan agen yang disimpan. Saling eksklusif dengan `model` dan `voice`. |
| `model` | Mesin untuk sesi inline: `bolt` (`spark` dan `storm` yang lebih lama masih didukung). |
| `voice` | Nama suara ThunderPhone untuk sesi inline. |
| `language` | Petunjuk bahasa utama untuk sesi inline, misalnya `es`. |
| `caller_number`, `callee_number` | Nomor telepon panggilan saat room terhubung ke saluran telepon. Nomor tersebut muncul sebagai nomor dari dan ke dalam riwayat panggilan. |
| `live_transcripts` | Streaming fragmen transkrip penelepon di tengah ujaran (dikenakan biaya tambahan). |
| `base_url` | Override endpoint, default `wss://api.thunderphone.com/v1/realtime`. |

## Peristiwa

ThunderPhone menambahkan peristiwa platform di atas protokol realtime. Sesi
mengeluarkannya:

```python
@session.llm.session.on("thunderphone_call_ended")  # or on the RealtimeSession you hold
def on_call_ended(event):
    print("call ended:", event["reason"])
```

`RealtimeSession` mengekspos `call_id` setelah sesi aktif. Gunakan dengan
[`GET /v1/calls/{call_id}`](/api-reference/calls) untuk mengambil rekaman,
transkrip, dan nilai setelah panggilan. Setiap peristiwa `call.*` lainnya (transfer,
keypad, ucapan diabaikan) tiba sebagai `thunderphone_call_event`.

## Batasan

- Deteksi giliran dilakukan di sisi server dan selalu aktif; deteksi giliran
  di sisi framework (`turn_detection` pada `AgentSession`) diabaikan.
- Instruksi dan tools tidak dapat diubah setelah panggilan dimulai.
- Audio menggunakan PCM mono 16-bit pada 24 kHz di kedua arah.
- Frame video diabaikan.

<Note>
Membangun dengan Pipecat? Lihat [Gunakan ThunderPhone dari Pipecat](/id/guides/use-with-pipecat).
</Note>
