{"slug": "new-telnyx-managed-insights-for-agent-instruction-following-and-user", "title": "New Telnyx-Managed Insights for Agent Instruction Following and User Satisfaction", "summary": "Telnyx launched two new managed insights, Agent Instruction Following and User Satisfaction, for AI Assistants to measure assistant quality without custom setup. The insights can be enabled via Insight Groups and queried through the Aggregate Conversation Insights API.", "body_md": "[Contact us](https://telnyx.com/contact-us)\n\n[Log in](https://portal.telnyx.com)\n\nTwo 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.\n\n`GET /ai/conversations/conversation-insights/aggregates`\n\n. Group by `score`\n\n, `metadata.assistant_id`\n\n, `metadata.assistant_version_id`\n\n, or `metadata.telnyx_conversation_channel`\n\n. Filter by `insight_id`\n\nand `created_at`\n\nrange 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.\n\nTo query aggregated insight counts via API:\n\n```\ncurl -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\" \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\"\n```\n\nResponse:\n\n```\n{\n  \"data\": [\n    { \"score\": \"excellent\", \"metadata\": { \"assistant_version_id\": \"v1\" }, \"record_count\": 142 },\n    { \"score\": \"good\", \"metadata\": { \"assistant_version_id\": \"v1\" }, \"record_count\": 38 },\n    { \"score\": \"excellent\", \"metadata\": { \"assistant_version_id\": \"v2\" }, \"record_count\": 98 },\n    { \"score\": \"good\", \"metadata\": { \"assistant_version_id\": \"v2\" }, \"record_count\": 71 }\n  ]\n}\n```\n\n**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).", "url": "https://wpnews.pro/news/new-telnyx-managed-insights-for-agent-instruction-following-and-user", "canonical_source": "https://telnyx.com/release-notes/telnyx-managed-insights-agent-instruction-following-user-satisfaction", "published_at": "2026-07-09 00:00:00+00:00", "updated_at": "2026-07-09 19:21:28.351189+00:00", "lang": "en", "topics": ["ai-products", "ai-tools", "natural-language-processing"], "entities": ["Telnyx"], "alternates": {"html": "https://wpnews.pro/news/new-telnyx-managed-insights-for-agent-instruction-following-and-user", "markdown": "https://wpnews.pro/news/new-telnyx-managed-insights-for-agent-instruction-following-and-user.md", "text": "https://wpnews.pro/news/new-telnyx-managed-insights-for-agent-instruction-following-and-user.txt", "jsonld": "https://wpnews.pro/news/new-telnyx-managed-insights-for-agent-instruction-following-and-user.jsonld"}}