# Документация Humanitec

> Справочная документация платформы Humanitec: быстрый старт, API, руководства и UI-инструкции.

## Pages

- [Flows Public API](https://humanitec.ru/documentation/api/flows/): A2A API для Flows - это внешний HTTP-интерфейс, через который ваш backend может запускать опубликованные flows, получать ответы, продолжать диалоги, передавать файлы, подставлять переменные и управлять branches. Эта стр…
- [Frontend Public API](https://humanitec.ru/documentation/api/frontend/): Управление платформой: авторизация, компании, биллинг Интерактивная документация !!! info Интерактивная документация сервиса: Swagger UI ReDoc Доступно полное описание всех эндпоинтов с возможностью тестирования. Эндпои…
- [API](https://humanitec.ru/documentation/api/): Публичные API платформы Humanitec. Сервисы OpenAPI Flows A2A API A2A интеграция с flows: token, авторизация, message/send, streaming, tasks, branches, variables и files. OpenAPI Frontend Public API Управление платформой…
- [Руководства](https://humanitec.ru/documentation/guides/): Добро пожаловать в раздел руководств Humanitec на русском языке. Пошаговые инструкции интерфейса (E2E) находятся в разделе **Инструкции**.
- [Документация Humanitec](https://humanitec.ru/documentation/): Документация Humanitec Документация для платформы ИИ-агентов, Flows, Sync, NetWorkle и RAG. Здесь есть быстрый старт, публичные API и автособранные E2E-инструкции с реальными скриншотами интерфейса. Начать интеграцию От…
- [Быстрый старт](https://humanitec.ru/documentation/quickstart/): Quickstart За несколько минут проверьте Agent Card, отправьте сообщение агенту и перейдите к полной API-документации. Base URL https://humanitec.ru/flows/api/v1/{flow_id} Auth Authorization: Bearer {token} Protocol JSON…
- [NetWorkle: хаб настроек](https://humanitec.ru/documentation/scenarios/crm/crm-settings-hub/): Переход на /crm/settings и проверка отображения settings-hub-page с карточками. Шаг 1. Открыт раздел настроек NetWorkle Открыт раздел настроек NetWorkle Шаг 2. Хаб настроек NetWorkle отображен с карточками Хаб настроек…
- [NetWorkle: оболочка записной книжки](https://humanitec.ru/documentation/scenarios/crm/crm-shell/): Доступ к NetWorkle UI на system.localhost после входа. Шаг 1. SPA NetWorkle открыт SPA NetWorkle открыт Шаг 2. Оболочка NetWorkle видна Оболочка NetWorkle видна
- [NetWorkle](https://humanitec.ru/documentation/scenarios/crm/): Пошаговые инструкции интерфейса NetWorkle. Инструкции NetWorkle: оболочка записной книжки NetWorkle: хаб настроек
- [Flows: добавление LLM-ноды](https://humanitec.ru/documentation/scenarios/flows/add-llm-node/): Инструкция показывает, как добавить LLM Node на канву, открыть настройки ноды, заполнить промпт и выбрать LLM-профиль. Шаг 1. Открываем редактор flow. Слева находится палитра нод, в центре находится канва. Открываем ред…
- [Flows: API Console и A2A запуск](https://humanitec.ru/documentation/scenarios/flows/api-console/): Полная инструкция по модалке API Console в редакторе Flows: где взять endpoint, как читать A2A JSON-RPC body, как запускать Streaming/Sync/Async и как разбирать реальные ответы API. Шаг 1. Открываем API Console из редак…
- [Flows: создание flow](https://humanitec.ru/documentation/scenarios/flows/create-flow/): Пошаговая инструкция для обычного пользователя: открыть Flows, выбрать шаблон, заполнить понятные поля и попасть в редактор с готовой канвой. Шаг 1. Открываем Flows. Это список ваших flow: здесь можно найти готового аге…
- [Flows: редактирование flow](https://humanitec.ru/documentation/scenarios/flows/edit-llm-flow/): Инструкция для повторного редактирования: открыть готовый flow, изменить название, обновить промпт LLM-ноды и сохранить изменения. Шаг 1. Открываем уже готовый flow и кликаем по LLM-ноду. Справа снова видны ее настройки…
- [Evaluation Lab: создание и изменение test cases](https://humanitec.ru/documentation/scenarios/flows/evaluation-lab/): Evaluation Lab — полноэкранная рабочая зона для проверки flow. Базовый цикл такой: выбрать suite, добавить case из шаблона или вручную, запустить suite/case, открыть результат в матрице, посмотреть live transcript и tra…
- [Flows: главная страница и обзор сервиса](https://humanitec.ru/documentation/scenarios/flows/flows-home-overview/): Главная `/flows/` — рабочий обзор сервиса. Здесь разработчик видит доступные flow, быстрые действия, состояние runtime-контуров и переходы в чат или редактор. Шаг 1. Открываем Flows Откройте `/flows/`. Слева находится к…
- [Flows](https://humanitec.ru/documentation/scenarios/flows/): Пошаговые инструкции по Flows: главная сервиса, запуск агента в чате, создание и редактирование flow, операции published flow и Evaluation Lab. Flows: главная страница сервиса Инструкции Evaluation Lab: создание и измен…
- [Flows: операционный контур published flow](https://humanitec.ru/documentation/scenarios/flows/operate-published-flow/): После сборки flow разработчику нужно не только редактировать граф, но и выпускать, тестировать, открывать наблюдаемость, настраивать входы и переходить в Evaluation Lab. Этот сценарий показывает, где эти действия находя…
- [Flows: запуск агента в чате](https://humanitec.ru/documentation/scenarios/flows/run-flow-chat/): Чат `/flows/ ` — пользовательская поверхность flow. Здесь проверяют published-поведение агента без входа в редактор: текст, файлы, voice/TTS, trace, logs и durable history. Шаг 1. Открываем чат flow На главной Flows выб…
- [Frontend: корневая оболочка платформы](https://humanitec.ru/documentation/scenarios/frontend/frontend-shell/): Главная оболочка Humanitec на порту frontend-сервиса. Шаг 1. Корневой SPA открыт Корневой SPA открыт Шаг 2. Оболочка frontend-app видна Оболочка frontend-app видна
- [Frontend](https://humanitec.ru/documentation/scenarios/frontend/): Пошаговые инструкции интерфейса Frontend. Инструкции Frontend: корневая оболочка платформы
- [Инструкции](https://humanitec.ru/documentation/scenarios/): Проверенные пользовательские инструкции с шагами и скриншотами интерфейса. Инструкции Flows Frontend NetWorkle RAG Sync Основные инструкции
- [Основные инструкции](https://humanitec.ru/documentation/scenarios/platform/): Базовые инструкции для нового пользователя: вход, Dashboard, список сервисов и меню аккаунта. Инструкции Основные инструкции: вход, Dashboard и меню пользователя
- [Основные инструкции: вход, Dashboard и меню пользователя](https://humanitec.ru/documentation/scenarios/platform/main-dashboard-user-menu/): Базовый маршрут для нового пользователя: открыть сайт, перейти в Dashboard, понять список сервисов и разобраться с пунктами меню пользователя. Шаг 1. Открываем главный сайт. Если пользователь уже вошел, в шапке есть кно…
- [RAG](https://humanitec.ru/documentation/scenarios/rag/): Пошаговые инструкции интерфейса RAG. Инструкции RAG: оболочка сервиса
- [RAG: оболочка сервиса](https://humanitec.ru/documentation/scenarios/rag/rag-shell/): Доступ к RAG UI на system.localhost после входа и маппинга субдомена. Шаг 1. SPA RAG открыт SPA RAG открыт Шаг 2. Оболочка rag-app видна Оболочка rag-app видна
- [Sync: ad-hoc звонок использует обычный видимый канал](https://humanitec.ru/documentation/scenarios/sync/adhoc-call-visible-channel/): Кнопка «Создать Sync» создаёт канал встречи с читаемым именем (дата и время), чат в оверлее работает, а после переключения каналов сообщения встречи сохраняются в этом канале. Шаг 1. Ad-hoc встреча создала видимый канал…
- [Sync: чат в оверлее звонка синхронизирован с каналом](https://humanitec.ru/documentation/scenarios/sync/call-overlay-chat-sync/): Сообщение из основного чата видно в call-overlay, а сообщение из call-overlay после завершения звонка отображается в ленте канала. Шаг 1. Сообщение из основного чата отправлено Сообщение из основного чата отправлено Шаг…
- [Sync: старт звонка из шапки канала](https://humanitec.ru/documentation/scenarios/sync/channel-call-overlay/): В topic-канале пользователь нажимает «Звонок в этом канале»; после ответа сервера отображается оверлей звонка (атрибут data-call-active на sync-app). Шаг 1. Открыт topic-канал Открыт topic-канал Шаг 2. Отображается овер…
- [Sync: переход по прямой ссылке на канал](https://humanitec.ru/documentation/scenarios/sync/channel-from-url-query/): После создания канала в UI тест получает id канала через API и открывает Sync по `/sync/c/{channel_id}` — выбранный канал и чат подгружаются автоматически. Шаг 1. Повторное открытие Sync по прямой ссылке канала Повторно…
- [Sync: выбор пространства](https://humanitec.ru/documentation/scenarios/sync/create-space/): Пользователь открывает Sync и выбирает существующее платформенное пространство в селекторе сайдбара. Шаг 1. Открыт Sync со списком всех пространств Открыт Sync со списком всех пространств Шаг 2. Пространство выбрано в с…
- [Sync: создание канала в пространстве](https://humanitec.ru/documentation/scenarios/sync/create-topic-channel/): После создания пространства пользователь создаёт topic-канал через «+» у раздела «Каналы» и подтверждает создание. Шаг 1. Выбрано пространство Sync Выбрано пространство Sync Шаг 2. Открыто создание канала Открыто создан…
- [Sync: удаление своего сообщения](https://humanitec.ru/documentation/scenarios/sync/delete-own-message/): Пользователь удаляет своё сообщение через контекстное меню. Шаг 1. Сообщение для удаления в ленте Сообщение для удаления в ленте Шаг 2. Сообщение исчезло из ленты Сообщение исчезло из ленты
- [Sync: настройки пространства](https://humanitec.ru/documentation/scenarios/sync/edit-space-name/): Пользователь открывает Sync-настройки выбранного платформенного пространства и включает опцию транскрибации голосовых сообщений. Шаг 1. Sync открыт Sync открыт Шаг 2. Открыты настройки пространства Открыты настройки про…
- [Sync](https://humanitec.ru/documentation/scenarios/sync/): Пошаговые инструкции интерфейса Sync. Инструкции Sync: ad-hoc звонок использует обычный видимый канал Sync: выбор пространства Sync: загрузка оболочки чата Sync: клик по @mention открывает карточку профиля Sync: мобильн…
- [Sync: страница входа по недействительной ссылке](https://humanitec.ru/documentation/scenarios/sync/join-invalid-token/): Публичная страница /sync/join/{token} показывает сообщение об ошибке для несуществующего токена. Шаг 1. Сообщение об ошибке для неверной ссылки Сообщение об ошибке для неверной ссылки
- [Sync: упоминание @ в канале](https://humanitec.ru/documentation/scenarios/sync/mention-from-popup/): Создаётся канал, второй участник компании добавлен в канал через API. В композере после «@» открывается список участников; выбор вставляет @user_id; в пузырьке mention показывает имя из company members, не сырой id. Шаг…
- [Sync: клик по @mention открывает карточку профиля](https://humanitec.ru/documentation/scenarios/sync/mention-profile-modal/): После отправки сообщения с упоминанием клик по подсвеченному имени открывает карточку профиля; видны имя, блок каналов вместе; в сетке есть строка канала как в сайдбаре. Шаг 1. Упоминание в ленте Упоминание в ленте Шаг…
- [Sync: отправка сообщения с изображением](https://humanitec.ru/documentation/scenarios/sync/message-with-image/): Пользователь прикрепляет изображение к сообщению; после отправки в ленту попадает блок с картинкой. Шаг 1. Канал открыт Канал открыт Шаг 2. Сообщение с превью изображения в ленте Сообщение с превью изображения в ленте
- [Sync: мобильный список чатов](https://humanitec.ru/documentation/scenarios/sync/mobile-sidebar-menu/): При ширине viewport как на телефоне Sync показывает список чатов прямо на главном экране, без дополнительного раскрытия сайдбара. Шаг 1. Sync на узком viewport Sync на узком viewport Шаг 2. Список чатов доступен без лиш…
- [Sync: мьют уведомлений в настройках канала](https://humanitec.ru/documentation/scenarios/sync/mute-channel-notifications/): Пользователь открывает настройки topic-канала и включает «Не беспокоить». Шаг 1. Открыты настройки канала Открыты настройки канала Шаг 2. Включён мьют уведомлений Включён мьют уведомлений
- [Sync: открытие чата с участником компании](https://humanitec.ru/documentation/scenarios/sync/open-dm-from-members/): В разделе «Личные» пользователь находит коллегу по имени и открывает с ним диалог. Шаг 1. Sync открыт, раздел «Личные» доступен Sync открыт, раздел «Личные» доступен Шаг 2. Поиск по имени участника Поиск по имени участн…
- [Sync: профиль отправителя из сообщения](https://humanitec.ru/documentation/scenarios/sync/peer-profile-from-message/): В канал добавлен участник; его сообщение создаётся через API; владелец открывает профиль по кнопке на аватаре в пузырьке чужого сообщения. Шаг 1. В канал добавлен второй участник В канал добавлен второй участник Шаг 2.…
- [Sync: реакция и редактирование своего сообщения](https://humanitec.ru/documentation/scenarios/sync/reaction-edit-message/): Сообщение отправляется из UI; реакция ставится через API; после перезагрузки видна метка реакции; редактирование текста выполняется в UI. Шаг 1. Сообщение отправлено Сообщение отправлено Шаг 2. Поставлена реакция Постав…
- [Sync: отправка сообщения в канал](https://humanitec.ru/documentation/scenarios/sync/send-message-in-channel/): Пользователь открывает канал, вводит текст в поле «Сообщение…» и отправляет его; текст отображается в ленте. Шаг 1. Выбран канал, открыт чат Выбран канал, открыт чат Шаг 2. Сообщение отображается в ленте Сообщение отобр…
- [Sync: загрузка оболочки чата](https://humanitec.ru/documentation/scenarios/sync/sync-chat-shell/): После входа под системным пользователем открывается SPA Sync; на экране отображается корневой элемент приложения (sync-app). Шаг 1. Приложение Sync открыто по URL SPA Приложение Sync открыто по URL SPA Шаг 2. Оболочка s…
- [Sync: полная инструкция по сервису](https://humanitec.ru/documentation/scenarios/sync/sync-complete-guide/): Длинная инструкция по основному рабочему маршруту Sync: пространство, канал, сообщения, упоминания, вложения, меню сообщения, закрепы, треды, настройки канала, профиль участника и реальные realtime-обновления. Шаг 1. От…
- [Sync: панель тредов после ответа на сообщение](https://humanitec.ru/documentation/scenarios/sync/thread-reply-drawer/): Пользователь отвечает на сообщение в основной ленте и открывает панель «Треды»: заголовок и область списка отображаются (список может быть пустым, если thread_id ещё не задан у сообщений в ленте). Шаг 1. Созданы простра…