# New Telnyx-Managed Insights for Agent Instruction Following and User Satisfaction

> Source: <https://telnyx.com/release-notes/telnyx-managed-insights-agent-instruction-following-user-satisfaction>
> Published: 2026-07-09 00:00:00+00:00

[Contact us](https://telnyx.com/contact-us)

[Log in](https://portal.telnyx.com)

Two new Telnyx-managed insights, *Agent Instruction Following* and *User Satisfaction*, are now available for AI Assistants. These built-in insights measure assistant quality out of the box, with no prompt engineering or custom schema design required.

`GET /ai/conversations/conversation-insights/aggregates`

. Group by `score`

, `metadata.assistant_id`

, `metadata.assistant_version_id`

, or `metadata.telnyx_conversation_channel`

. Filter by `insight_id`

and `created_at`

range to build per-day time series.To enable these insights on an assistant, add them to an Insight Group first: AI > Insights > **AI Insight Groups** tab > create or edit a group > search for and add **Agent Instruction Following** and **User Satisfaction** > save. Then assign the group to your assistant under Analysis > **Insights** sub-tab.

To query aggregated insight counts via API:

```
curl -X GET "https://api.telnyx.com/v2/ai/conversations/conversation-insights/aggregates?group_by=score&group_by=metadata.assistant_version_id&metadata.assistant_id=eq.<your-assistant-id>&insight_id=<insight-id>&created_at=gte.2025-07-01T00:00:00Z&created_at=lt.2025-07-08T00:00:00Z" \
  -H "Authorization: Bearer $TELNYX_API_KEY"
```

Response:

```
{
  "data": [
    { "score": "excellent", "metadata": { "assistant_version_id": "v1" }, "record_count": 142 },
    { "score": "good", "metadata": { "assistant_version_id": "v1" }, "record_count": 38 },
    { "score": "excellent", "metadata": { "assistant_version_id": "v2" }, "record_count": 98 },
    { "score": "good", "metadata": { "assistant_version_id": "v2" }, "record_count": 71 }
  ]
}
```

**Learn more** in the [Telnyx-managed insights guide](https://developers.telnyx.com/docs/inference/ai-insights/telnyx-managed-insights), the [Insight Groups docs](https://developers.telnyx.com/docs/inference/ai-insights/insight-groups), or the [Aggregate Conversation Insights API reference](https://developers.telnyx.com/api-reference/conversations/aggregate-conversation-insights).