---
title: "LiveKit Agents থেকে ThunderPhone ব্যবহার করুন"
description: "LiveKit রুম, SIP এবং টেলিফোনির সঙ্গে একটি LiveKit Agents সেশনের রিয়েলটাইম (স্পিচ-টু-স্পিচ) মডেল হিসেবে একটি ThunderPhone ভয়েস এজেন্ট চালান।"
---

[LiveKit Agents](https://github.com/livekit/agents) হলো LiveKit রুমের ওপর নির্মিত রিয়েলটাইম ভয়েস এজেন্টের জন্য একটি ওপেন-সোর্স ফ্রেমওয়ার্ক। ThunderPhone **রিয়েলটাইম মডেল** হিসেবে সংযুক্ত হয়: ফ্রেমওয়ার্কটি অংশগ্রহণকারীর অডিও পাঠায়, ThunderPhone এজেন্টের ভয়েস, ট্রান্সক্রিপ্ট এবং ফাংশন কল ফেরত দেয়, আর LiveKit-এর রুম, SIP ট্রাঙ্ক এবং টেলিফোনি অডিও বহন করে। স্পিচ রিকগনিশন, ভাষা মডেল, ভয়েস, টার্ন-টেকিং, 62টি ভাষা এবং টুল—সবকিছু ThunderPhone-এ চলে।

এইভাবে করা কলগুলো [কলের ইতিহাসে](/api-reference/calls) দেখা যায় এবং অন্যান্য যেকোনো রিয়েলটাইম কলের মতোই বিল করা হয় ([মূল্য নির্ধারণ](/bn/guides/pricing))। এতে কোনো সাবস্ক্রিপশন বা ThunderPhone ফোন নম্বর জড়িত নেই।

## ইনস্টল করুন

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

uv ব্যবহার করলে, `uv add "livekit-agents[thunderphone]~=1.8"` একই প্লাগইন ইনস্টল করে। এটি [livekit/agents](https://github.com/livekit/agents)
রিপোজিটরিতে অন্তর্ভুক্ত এবং `livekit-agents`-এর সঙ্গেই প্রকাশিত হয়, তাই দুটিকে একই
সংস্করণে রাখুন। LiveKit তাদের নিজস্ব
[ThunderPhone প্লাগইন নির্দেশিকায়](https://docs.livekit.io/agents/models/realtime/thunderphone/) এটি নথিভুক্ত করেছে।

প্লাগইনটি LiveKit-এর OpenAI Realtime মডেল র‍্যাপ করে, কারণ ThunderPhone-এর
[Realtime WebSocket](/api-reference/realtime) একই প্রোটোকলে কাজ করে। এর জন্য `livekit-agents` 1.8 বা পরবর্তী সংস্করণ প্রয়োজন।

## একটি সংরক্ষিত এজেন্ট চালান

এজেন্ট যা কিছু করে (prompt, ভয়েস, ইঞ্জিন, ভাষা, টুল, অভিবাদন, নীরবতা চেক-ইন), সবই ThunderPhone-এ কনফিগার করা হয়। সেশন শুধু অডিও স্থানান্তর করে। ড্যাশবোর্ডে এজেন্ট তৈরি করুন, অথবা Zeus-কে (ThunderPhone এজেন্ট তৈরি, পরীক্ষা ও টিউন করে এমন AI এজেন্ট) এটি সেট আপ করতে দিন, তারপর এর ID এখানে দিন। ThunderPhone-এ আপনি যে পরিবর্তনগুলো Deploy করেন, সেগুলো আপনার LiveKit কোড স্পর্শ না করেই পরবর্তী কলে প্রযোজ্য হবে।

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

একটি সংরক্ষিত এজেন্ট ThunderPhone-এ অভিবাদন জানায় এবং নিজস্ব টুল চালায়; LiveKit `Agent`-এর নির্দেশনা ও টুল পাঠানো হয় না। ThunderPhone এজেন্ট কল কেটে দিলে কল শেষ হয় এবং এর সঙ্গে সেশনও বন্ধ হয়।

## সেশন ইনলাইনে কনফিগার করুন

`agent_id` ছাড়া, নির্দেশনা ও টুল LiveKit `Agent` থেকে আসে, ঠিক যেভাবে সেগুলো OpenAI-এর ক্ষেত্রে আসে। `model` ইঞ্জিন নির্বাচন করে এবং `voice` 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 কল শুরু হলে নির্দেশনা ও টুল স্থির করে দেয়, তাই সেগুলো পরিবর্তন করে এমন `update_instructions`, `update_tools` এবং এজেন্ট হ্যান্ড-অফ কল চলাকালে সমর্থিত নয়। ইনলাইন সেশন ক্লায়েন্ট-নিয়ন্ত্রিত: আপনি `generate_reply()` কল করলে বা অংশগ্রহণকারী একটি টার্ন শেষ করলে এজেন্ট কথা বলে।

## বিকল্পসমূহ

| আর্গুমেন্ট | অর্থ |
|---|---|
| `api_key` | গোপন কী (`sk_live_...`)। ডিফল্ট হলো `THUNDERPHONE_API_KEY`। |
| `agent_id` | একটি সংরক্ষিত এজেন্ট চালান। `model` এবং `voice`-এর সঙ্গে পারস্পরিকভাবে একচেটিয়া। |
| `model` | ইনলাইন সেশনের ইঞ্জিন: `bolt` (পুরোনো `spark` এবং `storm` এখনও গ্রহণ করা হয়)। |
| `voice` | ইনলাইন সেশনের জন্য ThunderPhone ভয়েসের নাম। |
| `language` | ইনলাইন সেশনের প্রাথমিক ভাষা ইঙ্গিত, যেমন `es`। |
| `caller_number`, `callee_number` | রুমটি যখন একটি ফোন লাইন পরিচালনা করে, তখন কলের ফোন নম্বর। কলের ইতিহাসে এগুলো প্রেরক ও প্রাপকের নম্বর হিসেবে দেখা যায়। |
| `live_transcripts` | উচ্চারণ চলাকালীন কলারের ট্রান্সক্রিপ্টের অংশ স্ট্রিম করুন (অতিরিক্ত বিল করা হয়)। |
| `base_url` | এন্ডপয়েন্ট ওভাররাইড; ডিফল্ট `wss://api.thunderphone.com/v1/realtime`। |

## ইভেন্ট

ThunderPhone রিয়েলটাইম প্রোটোকলের ওপর প্ল্যাটফর্ম ইভেন্ট যোগ করে। সেশন
এগুলো এমিট করে:

```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` `call_id` প্রকাশ করে। কলের পরে রেকর্ডিং,
ট্রান্সক্রিপ্ট এবং গ্রেড আনতে এটি
[`GET /v1/calls/{call_id}`](/api-reference/calls)-এর সঙ্গে ব্যবহার করুন। অন্য সব `call.*` ইভেন্ট
(ট্রান্সফার, কীপ্যাড, বক্তব্য উপেক্ষা করা) `thunderphone_call_event` হিসেবে আসে।

## সীমাবদ্ধতা

- টার্ন শনাক্তকরণ সার্ভার-সাইডে হয় এবং সবসময় চালু থাকে; ফ্রেমওয়ার্ক-সাইড টার্ন শনাক্তকরণ
  (`AgentSession`-এ `turn_detection`) উপেক্ষা করা হয়।
- কল শুরু হলে নির্দেশনা এবং টুল পরিবর্তন করা যায় না।
- উভয় দিকেই অডিও হলো 24 kHz-এ 16-বিট মোনো PCM।
- ভিডিও ফ্রেম উপেক্ষা করা হয়।

<Note>
Pipecat ব্যবহার করছেন? [Pipecat থেকে ThunderPhone ব্যবহার করুন](/bn/guides/use-with-pipecat) দেখুন।
</Note>
