System insights performance

Overview

The get_system_insights_performance function provides system-level performance insights and metrics. This endpoint aggregates key performance indicators across your AI agents and conversations. Use this endpoint to:

• Monitor overall system health and performance
• Track key performance indicators (KPIs) at scale
• Generate executive-level performance dashboards

Quick start

query SystemInsightsPerformance(
  $accountId: uuid!
  $deskIds: _uuid
  $brainIds: _uuid
  $startDate: timestamp
  $endDate: timestamp
) {
  rows: get_system_insights_performance(
    args: {
      account_id: $accountId
      desk_ids: $deskIds
      brain_parent_ids: $brainIds
      start_time: $startDate
      end_time: $endDate
    }
  ) {
    avg_csat_brain
    csat_brain_count
    goal_achieved_percentage
    goal_achieved_count
    goal_total_count
  }
}

Variables:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

Parameters

Parameter	Type	Description
accountId	uuid!	Account identifier (required)
deskIds	_uuid	Filter by desk IDs
brainIds	_uuid	Filter by AI agent IDs
startDate	timestamp	Start date (format: yyyy-mm-dd)
endDate	timestamp	End date (format: yyyy-mm-dd)

Response fields

Field	Type	Description
avg_csat_brain	Float	Average AI agent CSAT score
csat_brain_count	Int	Number of sessions with an AI agent CSAT score
goal_achieved_percentage	Float	Percentage of evaluated sessions that achieved the goal
goal_achieved_count	Int	Number of sessions that achieved the goal
goal_total_count	Int	Number of sessions with a goal evaluation

Common use cases

Try it

Loading GraphQL Playground...

Monthly overview

Get monthly system performance:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

Specific desk

Get performance for a specific desk:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "deskIds": "{d2be0283-9b53-4d7b-b77d-2650f3a1a99c}",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

Specific AI agents

Get performance for specific AI agents:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "brainIds": "{a2wv9283-9b53-4d7b-b77d-2650f3a1a99c}",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

Example response

{
  "data": {
    "rows": [
      {
        "avg_csat_brain": 4.2,
        "csat_brain_count": 1250,
        "goal_achieved_percentage": 78.5,
        "goal_achieved_count": 9812,
        "goal_total_count": 12500
      }
    ]
  }
}