# Статистика запусков агентов

> Запуски по дням: сами (по расписанию, задачам и проверкам) и с людьми (чат, Telegram, консилиумы), а также разделы, в которых агенты работали. По агентам под управлением пользователя учитываются запуски всей команды, по остальным только свои.

export default function Layout(props) {
  const { OpenAPIPage } = props.components ?? {};
  return (
    <>
      {props.children}
      ## Статистика запусков агентов

`GET /ws/api/agent-activity/stats`

Запуски по дням: сами (по расписанию, задачам и проверкам) и с людьми (чат, Telegram, консилиумы), а также разделы, в которых агенты работали. По агентам под управлением пользователя учитываются запуски всей команды, по остальным только свои.

**Авторизация:** dpop

**Параметры**

| Имя | Где | Обязательный | Тип | Описание |
| --- | --- | --- | --- | --- |
| `agent` | query | да | string (uuid) или массив string (uuid) | Агенты, по которым нужна статистика |
| `period` | query | нет | "week" \| "month" \| "quarter" \| "year" | Период: неделя, 30 дней, квартал или год; для года сравнение с прошлым периодом не считается |
| `mine` | query | нет | "true" \| "false" | true — только собственные запуски пользователя |
| `tz` | query | нет | string | Часовой пояс для разбивки по дням, IANA |

**Ответы**

- `200` — Статистика (`application/json`, AgentActivityStats)
  - `days`: массив object, обязательное — Запуски по дням
    - `agentId`: string (uuid), обязательное — Агент
    - `assisted`: integer, обязательное — Запуски вместе с людьми
    - `autonomous`: integer, обязательное — Запуски без участия людей
    - `day`: string, обязательное — День в часовом поясе запроса, YYYY-MM-DD
  - `domains`: массив object, обязательное — Действия по разделам
    - `agentId`: string (uuid), обязательное — Агент
    - `calls`: integer, обязательное — Число действий
    - `domain`: string, обязательное — Раздел, в котором агент выполнял действия
  - `previousSince`: string, обязательное — Начало такого же предыдущего периода, ISO 8601; дни включают и его
  - `since`: string, обязательное — Начало периода, ISO 8601
- `400` — Некорректный запрос: не прошла валидация параметров или тела (`application/problem+json`, ProblemDetails)
- `401` — Не авторизован
- `403` — Недостаточно прав или scope (`application/problem+json`, ProblemDetails)

    </>
  );
}