---
title: "ThunderPhone'u LiveKit Agents ile kullanın"
description: "ThunderPhone sesli AI ajanını, LiveKit odaları, SIP ve telefon altyapısıyla çevrelenmiş bir LiveKit Agents oturumunun gerçek zamanlı (konuşmadan konuşmaya) modeli olarak çalıştırın."
---

[LiveKit Agents](https://github.com/livekit/agents), LiveKit odaları üzerinde gerçek zamanlı sesli AI ajanları için açık kaynaklı bir çerçevedir. ThunderPhone, **gerçek zamanlı model** olarak entegre olur: çerçeve katılımcının sesini gönderir, ThunderPhone ajanın sesini, transkriptleri ve fonksiyon çağrılarını döndürür; LiveKit odası, SIP trunk'ları ve telefon sistemi sesi taşır. Konuşma tanıma, dil modeli, ses, sıra alma, 62 dil ve araçların tümü ThunderPhone üzerinde çalışır.

Bu şekilde yapılan çağrılar [çağrı geçmişinde](/api-reference/calls) görünür ve diğer tüm gerçek zamanlı çağrılar gibi ücretlendirilir ([fiyatlandırma](/tr/guides/pricing)). Abonelik veya ThunderPhone telefon numarası gerekmez.

## Yükleme

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

uv ile `uv add "livekit-agents[thunderphone]~=1.8"` aynı eklentiyi yükler.
Eklenti [livekit/agents](https://github.com/livekit/agents) deposunda bulunur
ve `livekit-agents` ile birlikte yayınlanır; bu nedenle ikisini aynı sürümde
tutun. LiveKit, eklentiyi kendi
[ThunderPhone eklenti kılavuzunda](https://docs.livekit.io/agents/models/realtime/thunderphone/) belgelendirir.

Eklenti, ThunderPhone'un [Realtime WebSocket](/api-reference/realtime) özelliği aynı protokolü kullandığı için LiveKit'in OpenAI Realtime modelini sarmalar. `livekit-agents` 1.8 veya daha yeni bir sürüm gerektirir.

## Kaydedilmiş bir ajanı çalıştırma

Ajanın yaptığı her şey (istem, ses, motor, diller, araçlar, karşılama,
sessizlik yoklamaları) ThunderPhone üzerinde yapılandırılır. Oturum yalnızca sesi taşır.
Ajanı kontrol panelinde oluşturun veya ThunderPhone ajanlarını oluşturan, test eden
ve ayarlayan yapay zeka ajanı Zeus'un yapılandırmasını sağlayın; ardından kimliğini buraya iletin. ThunderPhone üzerinde yayına aldığınız değişiklikler, LiveKit kodunuza dokunmadan bir sonraki çağrıya uygulanır.

```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))
```

Kaydedilmiş bir yapay zeka ajanı ThunderPhone üzerinde karşılar ve kendi araçlarını çalıştırır; LiveKit `Agent` nesnesinin yönergeleri ve araçları gönderilmez. ThunderPhone ajanı aramayı kapattığında arama sona erer ve oturum da onunla birlikte kapanır.

## Oturumu satır içinde yapılandırma

`agent_id` olmadan, yönergeler ve araçlar OpenAI'de olduğu gibi LiveKit `Agent` üzerinden gelir. `model` motoru, `voice` ise ThunderPhone sesini seçer.

```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, arama başladığında yönergeleri ve araçları sabitler; bu nedenle `update_instructions`, `update_tools` ve bunları değiştiren ajan devirleri arama sırasında desteklenmez. Satır içi oturumlar istemci tarafından yönlendirilir: ajan, `generate_reply()` çağrıldığında veya katılımcı konuşma sırasını tamamladığında konuşur.

## Seçenekler

| Bağımsız Değişken | Anlamı |
|---|---|
| `api_key` | Gizli anahtar (`sk_live_...`). Varsayılan olarak `THUNDERPHONE_API_KEY` kullanılır. |
| `agent_id` | Kaydedilmiş bir ajanı çalıştırır. `model` ve `voice` ile birlikte kullanılamaz. |
| `model` | Satır içi oturumlar için motor: `bolt` (eski `spark` ve `storm` hâlâ kabul edilir). |
| `voice` | Satır içi oturumlar için ThunderPhone ses adı. |
| `language` | Satır içi oturumlar için birincil dil ipucu; örneğin `es`. |
| `caller_number`, `callee_number` | Oda bir telefon hattını karşıladığında aramanın telefon numaralarıdır. Arama geçmişinde kimden ve kime numaraları olarak görünürler. |
| `live_transcripts` | Konuşma devam ederken arayanın transkript parçalarını akış olarak iletir (ek ücretlendirilir). |
| `base_url` | Uç nokta geçersiz kılma adresi; varsayılan `wss://api.thunderphone.com/v1/realtime`. |

## Olaylar

ThunderPhone, gerçek zamanlı protokolün üzerine platform olayları ekler. Oturum
bu olayları gönderir:

```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`, oturum etkin olduğunda `call_id` değerini sunar. Çağrıdan
sonra kaydı, transkripti ve değerlendirmeyi almak için bunu
[`GET /v1/calls/{call_id}`](/api-reference/calls) ile kullanın. Diğer tüm
`call.*` olayları (aktarma, tuş takımı, konuşmanın yok sayılması)
`thunderphone_call_event` olarak gelir.

## Sınırlar

- Sıra algılama sunucu tarafındadır ve her zaman etkindir; çerçeve tarafındaki
  sıra algılama (`AgentSession` üzerindeki `turn_detection`) yok sayılır.
- Çağrı başladıktan sonra talimatlar ve araçlar değiştirilemez.
- Ses, her iki yönde de 24 kHz'de 16 bit mono PCM'dir.
- Video kareleri yok sayılır.

<Note>
Bunun yerine Pipecat mi kullanıyorsunuz? [Pipecat ile ThunderPhone kullanımı](/tr/guides/use-with-pipecat) bölümüne bakın.
</Note>
