When a user hits the

user_away_timeout

, you can gently handle it using LiveKit's event monitoring along with a bit of custom logic. Here’s a friendly walkthrough on how to set this up: 1. Event Monitoring: Keep an ear out for the

user_state_changed

event—that’s what tells you when the user’s status switches to "away" after the timeout. 2. Custom Logic: Create a function that kicks in when the user goes inactive. This function can check in with the user, wait for their response, and if there’s no activity, gracefully close the session. 3. Configuration: Don’t forget to set the

user_away_timeout

when you initialize the

AgentSession

to decide how long you want to wait before considering the user away. Here’s an example to help you get started:

from livekit.agents import Agent, AgentSession
import asyncio

async def entrypoint(ctx):
    session = AgentSession(
        vad=silero.VAD.load(),
        llm=openai.LLM(model="gpt-4o-mini"),
        stt=deepgram.STT(),
        tts=cartesia.TTS(),
        user_away_timeout=15.0,  # We’re setting the timeout to 15 seconds here
    )

    inactivity_task = None

    async def user_presence_task():
        # Let’s try to re-engage the user a few times
        for _ in range(3):
            await session.generate_reply(
                instructions="The user has been inactive. Please respond to continue."
            )
            await asyncio.sleep(10)
        
        # If there’s still no response, we’ll close the session
        await session.aclose()
        ctx.delete_room()

    @session.on("user_state_changed")
    def user_state_changed(ev):
        nonlocal inactivity_task
        if ev.new_state == "away":
            inactivity_task = asyncio.create_task(user_presence_task())
        else:
            if inactivity_task:
                inactivity_task.cancel()
                inactivity_task = None

    await session.start(agent=Agent())

This setup listens for when the user goes "away" and then gently tries to bring them back. If they don’t respond after a few friendly nudges, it closes the session to keep things tidy.