> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threetone.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Real-time monitoring

> Read the workspace live counter and distinguish it from unreleased event streams and live conversation monitoring.

The live-count endpoint provides a snapshot of a shared activity counter. It does not return individual sessions, transcripts, or a connection for observing conversations.

<Note>
  [Get live conversation count](/api-reference/agents-platform/get-live-conversation-count) reads a workspace-level counter. Its `agent_id` and `agent_ids` parameters are currently ignored, so filtered requests must not be presented as agent-specific counts.
</Note>

You need a permitted API key and a deployment with the shared cache available.

<Steps>
  <Step title="Read the workspace counter" id="monitoring-read-counter">
    Request the live count and record when you received it. Use the value only for that workspace snapshot, alongside its request success or failure.
  </Step>

  <Step title="Separate zero from unavailable" id="monitoring-interpret-counter">
    A missing counter key returns zero. An unavailable cache or invalid stored value produces an error. Preserve that error state instead of displaying it as zero activity.
  </Step>

  <Step title="Plan richer monitoring separately" id="monitoring-plan-events">
    Agent configuration includes `conversation_config.conversation.monitoring_enabled` and `monitoring_events`. These saved fields do not provide a released event subscription, WebSocket connection, or live transcript viewer.
  </Step>
</Steps>

Before relying on real-time monitoring, verify the released execution path, counter updates, freshness, and event delivery behavior. The counter read itself does not establish those guarantees.

<AccordionGroup>
  <Accordion title="Can I monitor one agent with agent_ids?" id="monitoring-faq-filter">Not currently. The handler reads the same workspace counter regardless of those filters.</Accordion>
  <Accordion title="Does monitoring_enabled start a stream?" id="monitoring-faq-stream">No released subscription workflow is established by saving that field.</Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.