---
title: "TaskClassificationItem"
---

## Fields

| Field                                                                                                                                                                        | Type                                                                                                                                                                         | Required                                                                                                                                                                     | Description                                                                                                                                                                  | Example                                                                                                                                                                      |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `category_token_share`                                                                                                                                                       | *float*                                                                                                                                                                      | :heavy_check_mark:                                                                                                                                                           | Fraction of this classification's token volume within its macro-category (0–1). Sums to 1 across all classifications sharing the same `macro_category`.                      | 0.48                                                                                                                                                                         |
| `category_usage_share`                                                                                                                                                       | *float*                                                                                                                                                                      | :heavy_check_mark:                                                                                                                                                           | Fraction of this classification's usage within its macro-category (0–1). Sums to 1 across all classifications sharing the same `macro_category`.                             | 0.51                                                                                                                                                                         |
| `display_name`                                                                                                                                                               | *str*                                                                                                                                                                        | :heavy_check_mark:                                                                                                                                                           | Human-readable label for the classification.                                                                                                                                 | Code Generation                                                                                                                                                              |
| `macro_category`                                                                                                                                                             | *str*                                                                                                                                                                        | :heavy_check_mark:                                                                                                                                                           | Coarse grouping derived from the tag prefix: `code`, `data`, `agent`, or `general`.                                                                                          | code                                                                                                                                                                         |
| `models`                                                                                                                                                                     | List[[components.TaskClassificationModel](../components/taskclassificationmodel.mdx)]                                                                                         | :heavy_check_mark:                                                                                                                                                           | Top models for this classification by request volume, sorted descending. Each entry reports the model's share of this classification's requests and tokens.                  |                                                                                                                                                                              |
| `tag`                                                                                                                                                                        | *str*                                                                                                                                                                        | :heavy_check_mark:                                                                                                                                                           | Classification tag identifier (e.g. `code:general_impl`, `agent:web_search`).                                                                                                | code:general_impl                                                                                                                                                            |
| `token_share`                                                                                                                                                                | *float*                                                                                                                                                                      | :heavy_check_mark:                                                                                                                                                           | Fraction of classified sampled token volume (prompt + completion) attributed to this classification (0–1). The unclassified `other` bucket is excluded from the denominator. | 0.31                                                                                                                                                                         |
| `usage_share`                                                                                                                                                                | *float*                                                                                                                                                                      | :heavy_check_mark:                                                                                                                                                           | Fraction of classified sampled requests attributed to this classification (0–1). The unclassified `other` bucket is excluded from the denominator.                           | 0.23                                                                                                                                                                         |