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

# Agent Insights

> Read agent conversation analytics — topics, sentiment, CSAT, and more

`client.insights` reads read-only analytics computed over an [agent's](/sdk/resources/agents) conversations — topics, sentiment, CSAT, rating drivers, and auto-surfaced highlights.

## Metrics

Every metric takes an `agent_id` and optional `days` (window), `deployment_id` (scope to one channel), and `message_length` (`"short" | "medium" | "long"`). All return `dict`s.

```python theme={null}
client.insights.bootstrap_status(agent_id)           # is analytics ready yet?
client.insights.top_topics(agent_id, days=30, limit=10)
client.insights.sub_topics(agent_id, parent="billing", days=30)
client.insights.csat_score(agent_id, days=7)
client.insights.sentiment_over_time(agent_id, days=30)
client.insights.rating_drivers(agent_id, days=30, limit=8)
client.insights.conversation_funnel(agent_id, days=30)
client.insights.custom_insights(agent_id, days=30, limit=20)
client.insights.noticed(agent_id, limit=12)          # auto-surfaced highlights
```

## Drilling into conversations

Drill from a chart into the underlying conversations:

```python theme={null}
client.insights.conversations(
    agent_id, kind="topic", key="billing", days=30, limit=20,
)   # kind: "topic" | "subtopic" | "driver" | "custom" | "cx"
```

<Info>
  Each metric has an `a`-prefixed async twin (`atop_topics`, `acsat_score`, …).
</Info>