---
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) และ
คิดค่าบริการเช่นเดียวกับการโทรแบบเรียลไทม์อื่นๆ ([ราคา](/th/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 (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` | ส่ง `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 kHz ทั้งสองทิศทาง
- ระบบจะไม่สนใจเฟรมวิดีโอ

<Note>
กำลังพัฒนาด้วย LiveKit Agents อยู่ใช่ไหม ดู
[ใช้ ThunderPhone จาก LiveKit Agents](/th/guides/use-with-livekit)
</Note>
