---
title: "השתמשו ב-ThunderPhone מתוך LiveKit Agents"
description: "הפעילו סוכן קולי של ThunderPhone כמודל בזמן אמת (דיבור לדיבור) של הפעלת LiveKit Agents, עם חדרי LiveKit, ‏SIP וטלפוניה סביבו."
---

[LiveKit Agents](https://github.com/livekit/agents) היא מסגרת קוד פתוח
לסוכנים קוליים בזמן אמת המבוססים על חדרי LiveKit. ThunderPhone משתלב בתור
**מודל בזמן אמת**: המסגרת שולחת את השמע של המשתתף, ThunderPhone
מחזיר את קול הסוכן, תמלולים וקריאות פונקציה, והחדרים, עורקי SIP והטלפוניה של LiveKit מעבירים את השמע. זיהוי דיבור, מודל השפה, הקול, ניהול התורות, 62 שפות וכלים פועלים כולם ב-ThunderPhone.

שיחות שמתבצעות בדרך זו מופיעות ב[היסטוריית השיחות](/api-reference/calls) ומחויבות כמו כל שיחה אחרת בזמן אמת ([תמחור](/he/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/).

התוסף עוטף את מודל OpenAI Realtime של LiveKit, משום ש-[Realtime WebSocket](/api-reference/realtime)
של ThunderPhone מדבר באותו פרוטוקול. נדרשת גרסה 1.8 או חדשה יותר של
`livekit-agents`.

## הריצו סוכן שמור

כל מה שהסוכן עושה (הנחיה, קול, מנוע, שפות, כלים, ברכה,
בדיקות שקט) מוגדר ב-ThunderPhone. ההפעלה רק מעבירה אודיו.
בנו את הסוכן בלוח הבקרה, או בקשו מ-Zeus (סוכן הבינה המלאכותית שבונה, בודק
ומכוונן סוכני ThunderPhone) להגדיר אותו, ואז העבירו כאן את המזהה שלו. שינויים שתפרסמו ב-ThunderPhone יחולו על השיחה הבאה בלי לגעת בקוד ה-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; ההנחיות והכלים של
`Agent` ב-LiveKit אינם נשלחים. השיחה מסתיימת כאשר סוכן ThunderPhone
מנתק, וההפעלה נסגרת יחד איתו.

## הגדירו את ההפעלה בתוך הקוד

ללא `agent_id`, ההנחיות והכלים מגיעים מה-`Agent` של LiveKit, באותו אופן שבו הם מגיעים מ-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`.

## מגבלות

- זיהוי תורות מתבצע בצד השרת ותמיד פעיל; זיהוי תורות בצד המסגרת
  (`turn_detection` ב-`AgentSession`) אינו נלקח בחשבון.
- לא ניתן לשנות הוראות וכלים לאחר תחילת השיחה.
- השמע הוא PCM מונו של 16 סיביות ב-24 קה״ץ בשני הכיוונים.
- מתעלמים ממסגרות וידאו.

<Note>
בונים על Pipecat במקום זאת? עיינו ב-[שימוש ב-ThunderPhone מתוך Pipecat](/he/guides/use-with-pipecat).
</Note>
