---
title: "השתמשו ב-ThunderPhone מתוך Pipecat"
description: "הריצו סוכן קולי של ThunderPhone כשירות דיבור-לדיבור בתוך צינור עיבוד של Pipecat, עם התעבורה והטלפוניה שלכם."
---

[Pipecat](https://github.com/pipecat-ai/pipecat) הוא מערך קוד פתוח
לבניית סוכנים קוליים משירותים הניתנים להרכבה. ThunderPhone משתלב
כ**שירות LLM מדיבור לדיבור**: Pipecat שולח את שמע המתקשר, ThunderPhone
מחזיר את קול הסוכן, תמלולים וקריאות פונקציה, ותעבורת Pipecat
(Daily, LiveKit, Twilio, WebRTC, מיקרופון מקומי) מעבירה את
השמע. זיהוי דיבור, מודל השפה, הקול, ניהול תורות, 62
שפות וכלים פועלים כולם על ThunderPhone.

שיחות שמתבצעות בדרך זו מופיעות ב[היסטוריית השיחות](/api-reference/calls) ומחויבות כמו כל שיחה אחרת בזמן אמת ([תמחור](/he/guides/pricing)). אין צורך במנוי או במספר טלפון של ThunderPhone.

## התקנה

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

החבילה עוטפת את שירות OpenAI Realtime של Pipecat, מכיוון ש-[Realtime WebSocket](/api-reference/realtime)
של ThunderPhone מדבר באותו פרוטוקול. נדרשת גרסה `pipecat-ai` 1.8 או חדשה יותר.

## הפעלת סוכן שמור

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

## אירועים

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.
- השמע הוא PCM מונו של 16 סיביות ב-24 קה״ץ בשני הכיוונים.
- מסגרות וידאו מתעלמות.

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