how to stop the agent to make responses?

Thanks for reaching out, Hyeonsu. I'm an AI assistant and I'm here to help. Give me a moment while I research this topic.

How can I determine whose turn is it?

Figuring out whose turn it is in LiveKit is pretty straightforward, and you’ve got a few handy options: • Voice Activity Detection (VAD): This picks up when someone is talking or quiet. Once a user stops speaking and there’s silence for a bit (like 500ms), it knows their turn is done. • Transformer-Based Turn Detection Model: This one’s a bit smarter—it looks at both the audio and what’s being said to guess when someone’s finished talking. It works with multiple languages and tends to be more accurate. • Manual Turn Control: If you prefer, you can turn off the automatic detection and handle turns yourself through code. This is great for things like games where you want to control the order exactly. You set up turn detection at the

AgentSession

level, and you can pick whichever method fits your needs best—VAD, semantic models, or manual control. If you want, I’m here to help you get any of these set up! Sources: AI voice agents | LiveKit Docs | livekit-plugins/livekit-plugins-turn-detector/README.md | complex-agents/role-playing/prompts/combat_prompt.yaml | How does end-of-utterance detection work in conversations? | Turn detection and interruptions | LiveKit Docs

I mean is there a state that i can use to get the current turn?

LiveKit doesn’t have a built-in method like

get_current_turn()

to check the current turn state directly. But no worries—you can keep track of turn state using a few handy events and hooks: • Lifecycle Hooks: The

on_user_turn_completed

hook is great for knowing when a user finishes their turn. • Speech Events: You can listen for

input_speech_started

and

input_speech_stopped

events to see when someone’s speaking. • Manual Turn Control: If you want more control, you can turn off automatic turn detection and handle turns yourself with methods like

session.commit_user_turn()

and

session.clear_user_turn()

. These options should help you keep track of turn state smoothly in your app. If you want, I’m here to help you set it up! Sources: livekit-agents/livekit/agents/voice/agent_session.py | AI voice agents | LiveKit Docs | Turn detection and interruptions | LiveKit Docs | Pipeline nodes and hooks | LiveKit Docs

Are there other ways to stop responses programmatically?

Hey there! If you want to stop LiveKit agent responses programmatically, here are some easy ways to do it: • Interrupt Ongoing Speech: Just call

session.interrupt()

to immediately pause what the agent is saying. • Prevent New Responses: You can raise the

StopResponse

exception inside the

on_user_turn_completed

callback to stop the agent from replying further. • Disconnect the Agent: Use

ctx.shutdown()

to completely stop the agent and remove it from the room. • Graceful Session End: Try

session.drain()

followed by

session.aclose()

to wrap things up nicely and close the session. • End Entire Room: If you want to end the session for everyone, use the

delete_room

API. If you want a hand with any of these, just let me know—I’m here to help! Sources: basics/interrupts_user.py | Agents telephony integration | LiveKit Docs | agents/src/pipeline/pipeline_agent.ts | livekit-agents/livekit/agents/voice/agent_activity.py | Job lifecycle | LiveKit Docs

what does session.drain do?

Hey there! The

session.drain()

method is super handy because it makes sure all the pending stuff—like audio from text-to-speech or any queued-up responses—gets fully processed and delivered before the agent session ends. It’s usually used when you want to shut things down smoothly without any sudden cut-offs. For example, if your agent is wrapping up with a goodbye message,

session.drain()

makes sure that message finishes playing before you call

session.aclose()

to close the session. Just a heads-up: if the session isn’t running, it’ll throw an error. If you want me to walk you through it or need a hand setting this up, just let me know—I’m here to help! Sources: agents/src/worker.ts | Distributed Setup | LiveKit Docs | Worker lifecycle | LiveKit Docs | Deploy and scale agents on LiveKit Cloud | livekit-agents/livekit/agents/worker.py