---
title: "Pipecat'ten ThunderPhone kullanın"
description: "Kendi aktarım ve telefon altyapınızla, bir Pipecat işlem hattı içinde konuşmadan konuşmaya hizmet olarak bir ThunderPhone sesli AI ajanı çalıştırın."
---

[Pipecat](https://github.com/pipecat-ai/pipecat), birleştirilebilir hizmetlerden sesli AI ajanları oluşturmak için açık kaynaklı bir çerçevedir. ThunderPhone, bir **konuşmadan konuşmaya LLM hizmeti** olarak bağlanır: Pipecat arayanın sesini gönderir, ThunderPhone ajanın sesini, transkriptleri ve işlev çağrılarını döndürür; Pipecat'in aktarım katmanı (Daily, LiveKit, Twilio, WebRTC, yerel mikrofon) 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 aramalar [arama geçmişinde](/api-reference/calls) görünür ve diğer tüm gerçek zamanlı aramalar gibi ücretlendirilir ([fiyatlandırma](/tr/guides/pricing)). Abonelik veya ThunderPhone telefon numarası gerekmez.

## Kurun

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

Paket, ThunderPhone'un [Realtime WebSocket](/api-reference/realtime) hizmeti aynı protokolü kullandığı için Pipecat'in OpenAI Realtime hizmetini sarmalar. `pipecat-ai` 1.8 veya daha yeni bir sürümü gerekir.

## Kaydedilmiş bir ajanı çalıştırın

Ajanın yaptığı her şey (istem, ses, motor, diller, araçlar, karşılama,
sessizlik kontrol mesajları) ThunderPhone üzerinde yapılandırılır. İş hattı yalnızca sesi taşır.
Ajanı kontrol panelinde oluşturun veya ThunderPhone ajanlarını oluşturan, test eden ve ince ayar yapan 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, iş hattınıza dokunmadan sonraki aramaya uygulanır.

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

Kaydedilmiş bir ajan aramayı kendi programına göre başlatır; bu nedenle hizmet Pipecat'ten ilk yanıt istemez. Yine de bir yanıt istiyorsanız `greet_on_connect=True` geçirin.

## Oturumu satır içi yapılandırın

`agent_id` olmadan, talimatlar ve araçlar OpenAI'de olduğu gibi Pipecat bağlamından gelir. `product` altyapıyı, `voice` ise ThunderPhone sesini seçer.

```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"],
        )
    ]),
)
```

Satır içi oturumlar istemci tarafından yönlendirilir: Pipecat, bağlam ulaştığında yanıt istediği için ajan ilk konuşan olur; siz bir mesaj eklemediğiniz veya başka bir yanıt istemediğiniz sürece sessizlik sırasında sessiz kalır.

## 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 yapay zeka ajanını çalıştırın. `product` ve `voice` ile karşılıklı olarak dışlayıcıdır. |
| `product` | Satır içi oturumlar için motor: `bolt` (`spark` ve `storm` adlı eski sürümler 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; ör. `es`. |
| `from_number`, `to_number` | İşlem hattı bir telefon hattının önünde çalıştığında aramada kaydedilecek numaralar. |
| `live_transcripts` | Arayanın transkript parçalarını ifade sırasında akış olarak iletin (ek ücretlendirilir). |
| `greet_on_connect` | Oturum hazır olur olmaz ilk yanıtı isteyin. |
| `end_task_on_call_ended` | ThunderPhone aramayı sonlandırdığında `EndWorkerFrame` gönderin (varsayılan olarak açık). |

## Olaylar

ThunderPhone, gerçek zamanlı protokolün üzerine platform olayları ekler. Hizmet,
bunları işleyicilere iletir:

```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`, oturum canlı olduğunda ayarlanır. Aramadan sonra kaydı,
transkripti ve notu almak için bunu
[`GET /v1/calls/{call_id}`](/api-reference/calls) ile kullanın.

## Sınırlar

- Sıra algılama sunucu tarafında gerçekleştirilir ve her zaman açıktır; Pipecat tarafından yönetilen sıralar
  (`turn_detection=False`) desteklenmez.
- Hizmete kaydedilen fonksiyonlar yalnızca satır içi oturumlarda çalışır. Kaydedilmiş bir
  ajan, kendi araçlarını ThunderPhone üzerinde yürütür.
- Ses, her iki yönde de 24 kHz'de 16 bit mono PCM'dir.
- Video kareleri yok sayılır.

<Note>
LiveKit Agents üzerinde mi geliştiriyorsunuz? Bkz.
[ThunderPhone'u LiveKit Agents ile kullanma](/tr/guides/use-with-livekit).
</Note>
