---
title: "Типы блоков"
id: "1338"
type: "page"
slug: "blocks"
published_at: "2026-08-15T23:32:26+00:00"
modified_at: "2026-10-17T12:50:57+00:00"
url: "https://pastukhov.com/agents/analytics/docs/blocks/"
markdown_url: "https://pastukhov.com/agents/analytics/docs/blocks.md"
excerpt: "Документ собирается из блоков — 38 типов контента в четырёх группах: текстовые, утилиты, данные и…"
---

# Типы блоков

[https://pastukhov.com/agents/analytics/docs/blocks/.md](https://pastukhov.com/agents/analytics/docs/blocks/.md)

Документ собирается из блоков — 38 типов контента в четырёх группах: текстовые, утилиты, данные и графики. Каждый блок занимает в сетке документа от 1 до 24 колонок и перетаскивается мышью.

## Текстовые

- **MarkdownContent** — форматированный текст: пояснения, выводы, ссылки, картинки и файлы, лежащие рядом с документом;
- **NotebookContent** — полноценный Jupyter Notebook как блок отчёта (подробнее — [Jupyter Notebooks](/agents/analytics/docs/jupyter) ).

## Утилиты

- **BookmarksContent** — закладки-карточки со ссылками на другие отчёты и страницы;
- **SectionContent** — заголовок раздела: группирует блоки в длинных отчётах;
- **DetailsContent** — список свойств сущности: компактная карточка «ключ — значение».

## Данные

- **TableContent** — интерактивная таблица: закреплённые шапка и первые колонки при прокрутке, постраничная выдача, сортировка, итоговая строка, мини-график в ячейке, цветные значки по правилам (например, только топ-10% — красным) и ссылки из ячеек;
- **MetricContent** — одиночная метрика/KPI крупным числом — с подписью, планом, изменением за период, состоянием и мини-графиком динамики;
- **GaugeContent** — спидометр-гейдж с зонами значений;
- **BarGaugeContent** — линейка-гейдж: ранжированный ряд значений, цвет каждого по порогам — удобно для рейтингов и нормативов;
- **AlertsContent** — живой список сработавших оповещений: состояния и фильтры по меткам, обновляется в реальном времени.

## Графики

- **LineChartContent** — линейный график: как величина меняется во времени;
- **BarChartContent** — столбчатая диаграмма: сравнение категорий между собой;
- **ComboChartContent** — комбинированная диаграмма: столбцы одного показателя и линия другого на двух осях;
- **ScatterChartContent** — точечная диаграмма: связь двух числовых колонок и выбросы;
- **DumbbellChartContent** — гантельная диаграмма: два значения одной сущности и разрыв между ними (план и факт);
- **SlopeChartContent** — наклонная диаграмма: как изменились значения или рейтинг между двумя периодами;
- **BulletChartContent** — пулевая диаграмма: значение против нормы с коридорами допуска;
- **ParetoChartContent** — диаграмма Парето: рейтинг категорий с линией накопленной доли;
- **DoughnutChartContent** — кольцевая диаграмма: доли целого;
- **TreemapChartContent** — дерево: площади прямоугольников вместо долей и вложенность категорий;
- **WaterfallChartContent** — диаграмма-водопад: из чего сложился итог — от начальной суммы к конечной;
- **SankeyChartContent** — диаграмма потоков: куда перетекают деньги или товары, ширина ленты — объём;
- **HistogramChartContent** — гистограмма распределения значений;
- **BoxPlotChartContent** — диаграмма размаха с квартилями и выбросами;
- **ViolinChartContent** — диаграмма-скрипка: полная форма распределения по каждой группе;
- **HeatmapContent** — тепловая карта: плотность значений по двум колонкам;
- **CalendarHeatmapContent** — календарная тепловая карта: значение каждого дня в сетке года;
- **FunnelChartContent** — воронка: сколько людей доходит до каждого этапа и где отваливаются;
- **GanttChartContent** — диаграмма Ганта: что когда начинается и заканчивается, с отметкой сегодняшнего дня;
- **TornadoChartContent** — торнадо: какой фактор сильнее всего двигает результат;
- **RadarChartContent** — лепестковая диаграмма: профиль объекта по нескольким критериям сразу;
- **ParallelCoordinatesChartContent** — параллельные координаты: профили многих объектов по нескольким показателям;
- **VennChartContent** — диаграмма Венна: пересечение двух или трёх групп;
- **MapChartContent** — карта регионов: значение каждого региона России или страны мира цветом;
- **NodeGraphChartContent** — граф связей: узлы и рёбра по списку связей, кого-с-кем;
- **StateTimelineChartContent** — таймлайн состояний: цветные интервалы состояний по каждой метке;
- **StatusHistoryChartContent** — сетка состояний по времени: дискретные ячейки-периоды для каждой метки;
- **CandlestickChartContent** — свечи OHLC с объёмом торгов: финансовые ряды.

Что показывает каждый график и когда его ставить — в разделе [Графики](/agents/analytics/docs/charts)
.

## Сетка документа

- ширина блока — от 1 до 24 колонок; ширина вне диапазона ловится валидатором (`INVALID_BLOCK_WIDTH`);
- блоки перетаскиваются мышью (drag & drop);
- у каждого блока уникальный ID вида `block_{timestamp}_{random}`;
- конфигурация блока — словарь параметров: заголовок, размеры, тип контента, данные, запросы, переопределения оформления.

## Notebook-блок

Ноутбук хранится двумя способами: как встроенный JSON прямо в блоке или как ссылка на внешний файл `.ipynb`. У блока отображаются счётчик ячеек и время последнего сохранения.

[← Оглавление документации](/agents/analytics/docs)