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

# Типы блоков

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

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

## Текстовые

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

## Утилиты

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

## Данные

- **TableContent** — интерактивная таблица с пагинацией и ссылками из ячеек;
- **MetricContent** — одиночная метрика/KPI крупным числом;
- **GaugeContent** — спидометр-гейдж с зонами значений.

## Графики

- **LineChartContent** — линейный график;
- **BarChartContent** — столбчатая диаграмма;
- **ScatterChartContent** — точечная диаграмма;
- **DoughnutChartContent** — кольцевая диаграмма;
- **HistogramChartContent** — гистограмма распределения;
- **CandlestickChartContent** — свечи OHLC с объёмом торгов;
- **BoxPlotChartContent** — box plot с квартилями и выбросами.

Параметры каждого графика — в разделе [Графики](/agents/analytics/docs/charts)
.

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

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

## Notebook-блок

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

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