Realtime Agent

Manage SenseAudio realtime agents by listing agents, starting or continuing sessions, querying status, and leaving sessions with proper error handling.

SenseAudio Realtime Agent

Use this skill for SenseAudio Agent session lifecycle integration.

Read First

• references/agent.md

Workflow

1. Discover agent:

• List available agents and pick agent_id.

2. Start or continue dialogue:

• new_dialogue=true for new session.
• new_dialogue=false with conv_id for continuity.

3. Persist runtime credentials:

• Store conv_id and room_id in your application state (database or session store), never in client-side code or logs.
• Tokens returned by /invoke are short-lived — treat them like passwords: do not log, do not embed in URLs, and discard after the session ends via /leave.
• Rotate by calling /invoke again with the same conv_id; do not reuse expired tokens.

4. Operate session:

• Query room status when needed.
• Leave session explicitly when finished.

5. Handle failures:

• Distinguish quota/auth/not-found vs parameter errors.