Counts per AI agent

Overview

The counts_per_brain function provides aggregate counts grouped by AI agent. Use this endpoint to:

• Compare session volumes across AI agents
• Track message and user counts per AI agent
• Monitor AI agent activity and last usage

Quick start

query CountsPerBrain(
  $accountId: uuid
  $deskIds: _uuid
  $brainIds: _uuid
  $integrationIds: _uuid
  $brainVersions: _int4
  $channels: _text
  $tags: _text
  $startDate: timestamp
  $endDate: timestamp
  $isTest: Boolean
  $minNumUserMessages: Int
) {
  rows: counts_per_brain(
    args: {
      account_id: $accountId
      start_time: $startDate
      end_time: $endDate
      brain_parent_ids: $brainIds
      desk_ids: $deskIds
      integration_ids: $integrationIds
      brain_versions: $brainVersions
      channels: $channels
      tags: $tags
      is_test: $isTest
      min_num_user_messages: $minNumUserMessages
    }
  ) {
    brain_parent_id: id
    num_requests
    num_sessions
    num_users
    last_used
  }
}

Variables:

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

Try it

Loading GraphQL Playground...

Parameters

Parameter	Type	Description
accountId	uuid	Account identifier
deskIds	_uuid	Filter by desk IDs
brainIds	_uuid	Filter by AI agent IDs
integrationIds	_uuid	Filter by integration IDs
brainVersions	_int4	Filter by AI agent versions
channels	_text	Filter by channels
tags	_text	Filter by session tags
startDate	timestamp	Start date (format: yyyy-mm-dd)
endDate	timestamp	End date (format: yyyy-mm-dd)
isTest	Boolean	Exclude test sessions
minNumUserMessages	Int	Minimum user messages in session

Response fields

Field	Type	Description
brain_parent_id	uuid	AI agent identifier
num_requests	Int	Total number of user messages
num_sessions	Int	Total number of sessions
num_users	Int	Total number of unique users
last_used	timestamp	Timestamp of last activity

Common use cases

Account totals

Get counts for all AI agents in an account:

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

Multiple AI agents

Get counts for specific AI agents:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "brainIds": "{a2wv9283-9b53-4d7b-b77d-2650f3a1a99c, 99xx33p9-dfab-44e5-9303-9b2bf13f1c94}",
  "startDate": "2024-01-08",
  "endDate": "2024-01-17"
}

Filter by tags

Filter by session tags:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "tags": "{vip-user, return-order}",
  "startDate": "2024-01-08",
  "endDate": "2024-01-17"
}

AI agents and tags

Combine AI agent and tag filters:

{
  "accountId": "991c12a1-cc58-4377-8e37-f72259e9dac1",
  "brainIds": "{a2wv9283-9b53-4d7b-b77d-2650f3a1a99c}",
  "tags": "{vip-user, return-order}",
  "startDate": "2024-01-08",
  "endDate": "2024-01-17"
}

Example response

{
  "data": {
    "rows": [
      {
        "brain_parent_id": "a2wv9283-9b53-4d7b-b77d-2650f3a1a99c",
        "num_requests": 309,
        "num_sessions": 309,
        "num_users": 309,
        "last_used": "2024-01-12T15:09:18.58"
      },
      {
        "brain_parent_id": "99xx33p9-dfab-44e5-9303-9b2bf13f1c94",
        "num_requests": 1564,
        "num_sessions": 448,
        "num_users": 448,
        "last_used": "2024-01-12T16:00:33.701"
      }
    ]
  }
}