Overview
The Phonic Live Conversation API is built for the voice agent experience. Use LiveKit's Phonic plugin to build a reliable speech-to-speech voice agent with intelligent tool calling.
Installation
Install the Phonic plugin:
uv add "livekit-agents[phonic]~=1.4"
pnpm add "@livekit/agents-plugin-phonic@1.x"
Authentication
The Phonic plugin requires an API key which can be accessed on the Phonic console's API keys page. Set PHONIC_API_KEY as a variable in your .env file.
Usage
Use Phonic in an AgentSession. For example, you can use it in the Voice AI quickstart.
from livekit.plugins import phonicsession = AgentSession(llm=phonic.realtime.RealtimeModel(voice="sabrina"),)
import * as phonic from '@livekit/agents-plugin-phonic';const session = new voice.AgentSession({llm: new phonic.realtime.RealtimeModel({ voice: "sabrina" }),});
Parameters
This section describes some of the available parameters. For a complete reference of all available parameters, see the plugin reference.
strOptionalPhonic agent name.
strOptionalPhonic voice to use from the available voices.
strOptionalThe message the agent says when the session starts. Ignored when generate_welcome_message is True.
boolOptionalWhether to auto-generate the welcome message (ignores welcome_message).
Additional resources
The following resources provide more information about using Phonic with LiveKit Agents.
