---
title: "Upotrebljavajte ThunderPhone iz Pipecata"
description: "Pokrenite glasovnog agenta ThunderPhone kao uslugu govora u govor unutar Pipecat cjevovoda, uz vlastiti prijenos i telefoniju."
---

[Pipecat](https://github.com/pipecat-ai/pipecat) je okvir otvorenog koda
za izradu glasovnih agenata od sastavljivih usluga. ThunderPhone se integrira kao
**LLM usluga za govor-u-govor**: Pipecat šalje zvuk pozivatelja, ThunderPhone
vraća glas agenta, transkripte i pozive funkcija, a Pipecatov prijenos
(Daily, LiveKit, Twilio, WebRTC, lokalni mikrofon) prenosi zvuk. Prepoznavanje
govora, jezični model, glas, izmjena redoslijeda govora, 62 jezika i alati svi rade na ThunderPhoneu.

Pozivi upućeni na ovaj način prikazuju se u [povijesti poziva](/api-reference/calls) i
naplaćuju se kao i svaki drugi poziv u stvarnom vremenu ([cijene](/hr/guides/pricing)). Nisu
uključeni pretplata ni ThunderPhone telefonski broj.

## Instalacija

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

Paket omata Pipecatovu uslugu OpenAI Realtime jer ThunderPhoneov
[Realtime WebSocket](/api-reference/realtime) koristi isti protokol. Potreban
mu je `pipecat-ai` 1.8 ili noviji.

## Pokrenite spremljenog agenta

Sve što agent radi (upit, glas, mehanizam, jezici, alati, pozdrav, provjere tijekom tišine) konfigurira se u ThunderPhoneu. Cjevovod samo prenosi zvuk. Izradite agenta na nadzornoj ploči ili neka ga postavi Zeus (AI agent koji izrađuje, testira i prilagođava ThunderPhone agente), a zatim ovdje proslijedite njegov ID. Promjene koje implementirate u ThunderPhoneu primjenjuju se na sljedeći poziv bez izmjena vašeg cjevovoda.

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

Spremljeni agent započinje poziv prema vlastitom rasporedu, pa usluga ne
zahtijeva početni odgovor od Pipecata. Proslijedite `greet_on_connect=True` ako
ga ipak želite.

## Konfigurirajte sesiju izravno u kodu

Bez `agent_id`, upute i alati dolaze iz Pipecatova konteksta, na isti način kao
za OpenAI. `product` odabire engine, a `voice` odabire ThunderPhoneov glas.

```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"],
        )
    ]),
)
```

Sesijama u kodu upravlja klijent: agent govori prvi jer Pipecat zahtijeva odgovor
kada kontekst stigne te ostaje tih tijekom tišine, osim ako dodate poruku ili
zatražite drugi odgovor.

## Opcije

| Argument | Značenje |
|---|---|
| `api_key` | Tajni ključ (`sk_live_...`). Zadano je `THUNDERPHONE_API_KEY`. |
| `agent_id` | Pokrenite spremljenog agenta. Uzajamno se isključuje s `product` i `voice`. |
| `product` | Mehanizam za umetnute sesije: `bolt` (stariji `spark` i `storm` i dalje su prihvaćeni). |
| `voice` | Naziv ThunderPhone glasa za umetnute sesije. |
| `language` | Savjet za primarni jezik za umetnute sesije, npr. `es`. |
| `from_number`, `to_number` | Brojevi za bilježenje u pozivu kada cjevovod upravlja telefonskom linijom. |
| `live_transcripts` | Strujno prenosite fragmente prijepisa pozivatelja usred izgovora (dodatno se naplaćuje). |
| `greet_on_connect` | Zatražite prvi odgovor čim sesija bude spremna. |
| `end_task_on_call_ended` | Pošaljite `EndWorkerFrame` kada ThunderPhone završi poziv (zadano uključeno). |

## Događaji

ThunderPhone dodaje događaje platforme povrh protokola u stvarnom vremenu. Usluga
ih šalje obrađivačima:

```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` postavlja se kada sesija postane aktivna. Upotrijebite ga s
[`GET /v1/calls/{call_id}`](/api-reference/calls) za dohvaćanje snimke,
prijepisa i ocjene nakon poziva.

## Ograničenja

- Prepoznavanje izmjene govornika odvija se na poslužitelju i uvijek je uključeno; izmjene kojima upravlja Pipecat
  (`turn_detection=False`) nisu podržane.
- Funkcije registrirane u usluzi pokreću se samo za ugrađene sesije. Spremljeni
  agent pokreće vlastite alate na ThunderPhoneu.
- Zvuk je 16-bitni mono PCM pri 24 kHz u oba smjera.
- Videookviri se zanemaruju.

<Note>
Gradite uz LiveKit Agents? Pogledajte
[Upotreba ThunderPhonea iz LiveKit Agents](/hr/guides/use-with-livekit).
</Note>
