---
title: "Utilizați ThunderPhone din LiveKit Agents"
description: "Rulați un agent vocal ThunderPhone ca model în timp real (vorbire-la-vorbire) într-o sesiune LiveKit Agents, cu camere LiveKit, SIP și telefonie în jurul acestuia."
---

[LiveKit Agents](https://github.com/livekit/agents) este un cadru open-source
pentru agenți vocali în timp real, construit pe camere LiveKit. ThunderPhone se integrează ca
**model în timp real**: cadrul trimite sunetul participantului, ThunderPhone
returnează vocea agentului, transcrierile și apelurile de funcții, iar camera LiveKit,
trunchiurile SIP și telefonia transportă sunetul. Recunoașterea vocală, modelul de limbaj,
vocea, gestionarea schimbului de replici, cele 62 de limbi și instrumentele rulează toate pe ThunderPhone.

Apelurile efectuate astfel apar în [istoricul apelurilor](/api-reference/calls) și sunt
facturate ca orice alt apel în timp real ([prețuri](/ro/guides/pricing)). Nu este
implicat niciun abonament și niciun număr de telefon ThunderPhone.

## Instalare

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

Cu uv, `uv add "livekit-agents[thunderphone]~=1.8"` instalează același
plugin. Acesta este inclus în depozitul [livekit/agents](https://github.com/livekit/agents)
și este lansat odată cu `livekit-agents`, așadar mențineți-le pe ambele la
aceeași versiune. LiveKit îl documentează în propriul
[ghid pentru pluginul ThunderPhone](https://docs.livekit.io/agents/models/realtime/thunderphone/).

Pluginul încorporează modelul OpenAI Realtime al LiveKit, deoarece
[Realtime WebSocket](/api-reference/realtime) de la ThunderPhone utilizează același protocol. Acesta
necesită `livekit-agents` 1.8 sau o versiune mai nouă.

## Rulați un agent salvat

Tot ceea ce face agentul (promptul, vocea, motorul, limbile, instrumentele, mesajul de întâmpinare și verificările în perioadele de tăcere) este configurat în ThunderPhone. Sesiunea transmite doar sunetul. Creați agentul în tabloul de bord sau solicitați-i lui Zeus (agentul AI care creează, testează și ajustează agenți ThunderPhone) să îl configureze, apoi transmiteți-i aici ID-ul. Modificările pe care le implementați în ThunderPhone se aplică următorului apel fără a modifica codul 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))
```

Un agent salvat salută și își rulează propriile instrumente în ThunderPhone; instrucțiunile
și instrumentele `Agent`-ului LiveKit nu sunt trimise. Apelul se încheie când
agentul ThunderPhone închide apelul, iar sesiunea se închide odată cu acesta.

## Configurați sesiunea inline

Fără `agent_id`, instrucțiunile și instrumentele provin de la `Agent` din LiveKit, la fel ca pentru OpenAI. `model` selectează motorul, iar `voice` selectează vocea 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 fixează instrucțiunile și instrumentele când începe apelul, astfel încât
`update_instructions`, `update_tools` și transferurile către alți agenți care le modifică nu sunt
acceptate în timpul apelului. Sesiunile inline sunt controlate de client: agentul vorbește
când apelați `generate_reply()` sau când participantul termină un schimb de replici.

## Opțiuni

| Argument | Semnificație |
|---|---|
| `api_key` | Cheie secretă (`sk_live_...`). Valoarea implicită este `THUNDERPHONE_API_KEY`. |
| `agent_id` | Rulează un agent salvat. Se exclude reciproc cu `model` și `voice`. |
| `model` | Motor pentru sesiuni inline: `bolt` (versiunile mai vechi `spark` și `storm` sunt încă acceptate). |
| `voice` | Numele vocii ThunderPhone pentru sesiuni inline. |
| `language` | Indiciu privind limba principală pentru sesiunile inline, de exemplu `es`. |
| `caller_number`, `callee_number` | Numerele de telefon ale apelului atunci când camera gestionează o linie telefonică. Apar ca numerele de la și către în istoricul apelurilor. |
| `live_transcripts` | Transmite fragmente din transcrierea apelantului în timpul enunțului (facturat suplimentar). |
| `base_url` | Suprascrierea endpointului, implicit `wss://api.thunderphone.com/v1/realtime`. |

## Evenimente

ThunderPhone adaugă evenimente de platformă peste protocolul în timp real. Sesiunea
le emite:

```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` expune `call_id` după ce sesiunea devine activă. Utilizați-l cu
[`GET /v1/calls/{call_id}`](/api-reference/calls) pentru a prelua înregistrarea,
transcrierea și evaluarea după apel. Orice alt eveniment `call.*` (transfer,
tastatură, vorbire ignorată) sosește ca `thunderphone_call_event`.

## Limite

- Detectarea schimbării rândului de vorbire este pe server și este mereu activă; detectarea schimbării rândului de vorbire din framework
  (`turn_detection` pe `AgentSession`) este ignorată.
- Instrucțiunile și instrumentele nu se pot modifica după începerea apelului.
- Sunetul este PCM mono pe 16 biți la 24 kHz în ambele direcții.
- Cadrele video sunt ignorate.

<Note>
Construiți cu Pipecat? Consultați [Utilizați ThunderPhone din Pipecat](/ro/guides/use-with-pipecat).
</Note>
