able-jackal-84140
12/23/2025, 3:30 AMtall-airline-16756
12/23/2025, 3:30 AMtall-airline-16756
12/23/2025, 3:30 AMuv run agent.py dev
• Node example (ensure dev script exists in package.json):
pnpm dev
1. Verify the agent connected:
◦ Check the agent logs for a successful registration/connection message.
◦ The agent should automatically accept new sessions (rooms) when in dev mode.
1. Open the Agents Playground:
◦ Go to https://agents-playground.livekit.io/
1. Join a room from the Playground:
◦ Enter any room name (e.g., test-room) and click Connect.
◦ When the room is created, your locally running agent in dev mode will automatically join the room.
1. Interact and confirm:
◦ Use microphone, camera, or text input in the Playground to send multimodal input.
◦ Confirm the agent’s responses (audio/video/text) are streamed back to the Playground.
1. If the agent doesn’t join or respond:
◦ Ensure the Playground and your agent use the same LiveKit server URL.
◦ Confirm your agent is actually running in dev mode and is accepting incoming jobs/sessions.
◦ Check agent logs for errors or rejected session messages.
If you’d like, tell me:
• Which agent runtime you’re using (Python or Node), and
• Any log messages you see when starting the agent.
I can give targeted troubleshooting steps based on that.
Sources: Agents playground | LiveKit docs | Voice AI quickstart | LiveKit docsable-jackal-84140
12/23/2025, 3:31 AMtall-airline-16756
12/23/2025, 3:32 AMable-jackal-84140
12/23/2025, 3:34 AMtall-airline-16756
12/23/2025, 3:35 AMpnpm dev or npm run dev).
1. Configure the Playground to point to your LiveKit server:
◦ Update the playground's configuration or environment (per the repo README) to use your local LiveKit URL (eg. <ws://your-host:7880> or the public tunnel URL if needed) and a valid token or dev credentials.
1. Run your agent and LiveKit server locally:
◦ Start LiveKit binding to 0.0.0.0 if you need external access.
◦ Start your agent in dev mode and ensure it connects to the same LiveKit URL.
Troubleshooting tips
• If browser media (mic/camera) is blocked, allow permissions for the local dev origin (http://localhost:PORT).
• If the playground can’t reach your LiveKit server, either run the playground and server on the same machine/network or expose LiveKit with a tunnel (ngrok) and use that public URL in the playground.
• Check console and agent logs for registration/auth errors; confirm API key/secret match.
Would you like step‑by‑step commands for cloning + running the playground on your OS (macOS/Linux/Windows), or help updating the playground config to your LiveKit URL? Which runtime are you using for your agent (Node or Python)?
Sources: Agents playground | LiveKit docs | An open source stack for real-time multimodal AI | Voice AI quickstart | LiveKit docsable-jackal-84140
12/23/2025, 3:45 AMtall-airline-16756
12/23/2025, 3:46 AMfrom livekit import agents, rtc
session = agents.voice.AgentSession(
# other settings...
room_input_options=agents.RoomInputOptions(
allowed_kinds=[rtc.ParticipantKind.PARTICIPANT_KIND_AGENT]
)
)
• Node.js
import { voice } from '@livekit/agents';
import { rtc } from 'livekit-client';
const session = new voice.AgentSession({
// other settings...
roomInputOptions: {
allowedKinds: [rtc.ParticipantKind.AGENT]
}
});
Must-haves for agent-to-agent voice
• Both agents connected to the same LiveKit room.
• Both agents include ParticipantKind.AGENT in their allowed kinds.
• TTS configured on agents so synthesized audio is produced and published.
• Agents publish their audio tracks to the room (so the other agent can hear them).
Useful scenarios
• Automated testing (one agent simulates a user, the other responds).
• Multi-agent pipelines where one agent hands off to another.
Do you want a full example for Node or Python that wires STT → LLM → TTS between two local agents, or do you need help enabling TTS/audio publishing in your current agent? Which runtime are you using?
Sources: How to Enable Agent-to-Agent Speech Detection in LiveKit | How to test your agent using another agent | Agents and handoffs | LiveKit docs | Agents Framework | livekit/livekit_composite | DeepWiki | Turns overview | LiveKit docs