---
title: "Pipecat سے ThunderPhone استعمال کریں"
description: "اپنی ٹرانسپورٹ اور ٹیلی فونی کے ساتھ Pipecat پائپ لائن کے اندر ThunderPhone وائس ایجنٹ کو اسپیچ ٹو اسپیچ سروس کے طور پر چلائیں۔"
---

[Pipecat](https://github.com/pipecat-ai/pipecat) قابلِ ترکیب سروسز سے
وائس ایجنٹس بنانے کے لیے ایک اوپن سورس فریم ورک ہے۔ ThunderPhone ایک
**آواز سے آواز کی LLM سروس** کے طور پر منسلک ہوتا ہے: Pipecat کالر کی آڈیو بھیجتا ہے، ThunderPhone
ایجنٹ کی آواز، ٹرانسکرپٹس اور فنکشن کالز واپس کرتا ہے، اور Pipecat کی
ٹرانسپورٹ (Daily، LiveKit، Twilio، WebRTC، ایک مقامی مائیکروفون) آڈیو منتقل کرتی ہے۔
تقریر کی شناخت، لینگویج ماڈل، آواز، باری لینے کا عمل، 62
زبانیں اور ٹولز سب ThunderPhone پر چلتے ہیں۔

اس طریقے سے کی گئی کالز [کال ہسٹری](/api-reference/calls) میں ظاہر ہوتی ہیں اور
ان کا بل کسی بھی دوسری ریئل ٹائم کال کی طرح لیا جاتا ہے ([قیمتیں](/ur/guides/pricing))۔ اس میں
نہ کوئی سبسکرپشن شامل ہے اور نہ ہی ThunderPhone کا کوئی فون نمبر۔

## انسٹال کریں

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

پیکیج Pipecat کی OpenAI Realtime سروس کو ریپ کرتا ہے، کیونکہ ThunderPhone کا
[Realtime WebSocket](/api-reference/realtime) اسی پروٹوکول پر بات کرتا ہے۔ اس کے لیے `pipecat-ai` 1.8 یا اس سے نیا ورژن درکار ہے۔

## محفوظ شدہ ایجنٹ چلائیں

ایجنٹ جو کچھ بھی کرتا ہے (prompt، آواز، انجن، زبانیں، ٹولز، خیرمقدم، خاموشی کی جانچ) ThunderPhone پر کنفیگر ہوتا ہے۔ پائپ لائن صرف آڈیو منتقل کرتی ہے۔ ڈیش بورڈ میں ایجنٹ بنائیں، یا Zeus سے (وہ AI ایجنٹ جو ThunderPhone ایجنٹس بناتا، جانچتا اور بہتر بناتا ہے) اسے سیٹ اپ کروائیں، پھر اس کی ID یہاں فراہم کریں۔ 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` | جب ThunderPhone کال ختم کرے تو `EndWorkerFrame` پش کریں (بطور ڈیفالٹ فعال)۔ |

## ایونٹس

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 پر اپنے ٹولز خود چلاتا ہے۔
- آڈیو دونوں سمتوں میں 24 kHz پر 16 بِٹ مونو PCM ہے۔
- ویڈیو فریمز نظر انداز کر دیے جاتے ہیں۔

<Note>
کیا آپ LiveKit Agents کے ساتھ بنا رہے ہیں؟ دیکھیں
[LiveKit Agents کے ذریعے ThunderPhone استعمال کریں](/ur/guides/use-with-livekit)۔
</Note>
