# Humanitec Documentation

> Reference documentation for the Humanitec platform: quickstart, API, guides, and UI instructions.

## Pages

- [Flows Public API](https://humanitec.ru/documentation/en/api/flows/): A2A API для Flows - это внешний HTTP-интерфейс, через который ваш backend может запускать опубликованные flows, получать ответы, продолжать диалоги, передавать файлы, подставлять переменные и управлять branches. Эта стр…
- [Frontend Public API](https://humanitec.ru/documentation/en/api/frontend/): Управление платформой: авторизация, компании, биллинг Interactive Documentation !!! info Интерактивная документация сервиса: Swagger UI ReDoc Доступно полное описание всех эндпоинтов с возможностью тестирования. Endpoin…
- [API](https://humanitec.ru/documentation/en/api/): Public APIs for Humanitec platform. Services OpenAPI Flows A2A API A2A integration with flows: token, authorization, message/send, streaming, tasks, branches, variables, and files. OpenAPI Frontend Public API Управление…
- [Documentation (EN)](https://humanitec.ru/documentation/en/guides/): Welcome to the Humanitec documentation in English. End-to-end UI instructions in English: **E2E instructions** (only tests with `title_en` / `description_en`).
- [Humanitec Documentation](https://humanitec.ru/documentation/en/): Humanitec Docs Documentation for the AI agent, Flows, Sync, NetWorkle, and RAG platform. Start with a working A2A request, browse generated API reference, or inspect UI instructions with real screenshots. Start building…
- [Quickstart](https://humanitec.ru/documentation/en/quickstart/): Quickstart Check the Agent Card, send a message to an agent, and jump into the generated API reference. Base URL https://humanitec.ru/flows/api/v1/{flow_id} Auth Authorization: Bearer {token} Protocol JSON-RPC 2.0 1. Pr…
- [NetWorkle: хаб настроек](https://humanitec.ru/documentation/en/scenarios/crm/crm-settings-hub/): Переход на /crm/settings и проверка отображения settings-hub-page с карточками. Шаг 1. Открыт раздел настроек NetWorkle Открыт раздел настроек NetWorkle Шаг 2. Хаб настроек NetWorkle отображен с карточками Хаб настроек…
- [NetWorkle: оболочка записной книжки](https://humanitec.ru/documentation/en/scenarios/crm/crm-shell/): Доступ к NetWorkle UI на system.localhost после входа. Шаг 1. SPA NetWorkle открыт SPA NetWorkle открыт Шаг 2. Оболочка NetWorkle видна Оболочка NetWorkle видна
- [NetWorkle](https://humanitec.ru/documentation/en/scenarios/crm/): Step-by-step UI instructions with screenshots. Pages NetWorkle: оболочка записной книжки NetWorkle: хаб настроек
- [Flows: добавление LLM-ноды](https://humanitec.ru/documentation/en/scenarios/flows/add-llm-node/): Инструкция показывает, как добавить LLM Node на канву, открыть настройки ноды, заполнить промпт и выбрать LLM-профиль. Шаг 1. Открываем редактор flow. Слева находится палитра нод, в центре находится канва. Открываем ред…
- [Flows: API Console and A2A run](https://humanitec.ru/documentation/en/scenarios/flows/api-console/): Complete guide for the API Console modal in the Flows editor: where to get the endpoint, how to read the A2A JSON-RPC body, how to run Streaming/Sync/Async, and how to inspect real API responses. Step 1. Open API Consol…
- [Flows: создание flow](https://humanitec.ru/documentation/en/scenarios/flows/create-flow/): Пошаговая инструкция для обычного пользователя: открыть Flows, выбрать шаблон, заполнить понятные поля и попасть в редактор с готовой канвой. Шаг 1. Открываем Flows. Это список ваших flow: здесь можно найти готового аге…
- [Flows: редактирование flow](https://humanitec.ru/documentation/en/scenarios/flows/edit-llm-flow/): Инструкция для повторного редактирования: открыть готовый flow, изменить название, обновить промпт LLM-ноды и сохранить изменения. Шаг 1. Открываем уже готовый flow и кликаем по LLM-ноду. Справа снова видны ее настройки…
- [Evaluation Lab: создание и изменение test cases](https://humanitec.ru/documentation/en/scenarios/flows/evaluation-lab/): Evaluation Lab — полноэкранная рабочая зона для проверки flow. Базовый цикл такой: выбрать suite, добавить case из шаблона или вручную, запустить suite/case, открыть результат в матрице, посмотреть live transcript и tra…
- [Flows: service home and overview](https://humanitec.ru/documentation/en/scenarios/flows/flows-home-overview/): The `/flows/` page is the service cockpit. A developer can find flows, start common actions, inspect runtime readiness, and jump into chat or editor. Step 1. Open Flows Open `/flows/`. The left sidebar contains the flow…
- [Flows](https://humanitec.ru/documentation/en/scenarios/flows/): Step-by-step Flows instructions: service home, agent chat, creating and editing flows, published-flow operations, and Evaluation Lab. Flows: service home page Pages Evaluation Lab: создание и изменение test cases Flows:…
- [Flows: operating a published flow](https://humanitec.ru/documentation/en/scenarios/flows/operate-published-flow/): After building a flow, a developer must publish it, test it, inspect observability, configure inputs, and jump into Evaluation Lab. This scenario shows where these actions live in the editor. Step 1. Open the flow edito…
- [Flows: running an agent in chat](https://humanitec.ru/documentation/en/scenarios/flows/run-flow-chat/): The `/flows/ ` chat is the user-facing flow surface. Use it to verify published behavior without entering the editor: text, files, voice/TTS, traces, logs, and durable history. Step 1. Open a flow chat On the Flows home…
- [Frontend: корневая оболочка платформы](https://humanitec.ru/documentation/en/scenarios/frontend/frontend-shell/): Главная оболочка Humanitec на порту frontend-сервиса. Шаг 1. Корневой SPA открыт Корневой SPA открыт Шаг 2. Оболочка frontend-app видна Оболочка frontend-app видна
- [Frontend](https://humanitec.ru/documentation/en/scenarios/frontend/): Step-by-step UI instructions with screenshots. Pages Frontend: корневая оболочка платформы
- [E2E instructions](https://humanitec.ru/documentation/en/scenarios/): Step-by-step UI instructions with screenshots generated from the same tests as the Russian documentation. Services Flows Frontend NetWorkle Platform Basics RAG Sync
- [Platform Basics](https://humanitec.ru/documentation/en/scenarios/platform/): Basic instructions for a new user: entry, Dashboard, service list, and account menu. Pages Platform basics: entry, Dashboard, and user menu
- [Platform basics: entry, Dashboard, and user menu](https://humanitec.ru/documentation/en/scenarios/platform/main-dashboard-user-menu/): A basic path for a new user: open the website, go to Dashboard, understand the service list, and inspect the user menu. Step 1. Open the main website. If the user is signed in, the header has a Dashboard button. Open th…
- [RAG](https://humanitec.ru/documentation/en/scenarios/rag/): Step-by-step UI instructions with screenshots. Pages RAG: оболочка сервиса
- [RAG: оболочка сервиса](https://humanitec.ru/documentation/en/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/en/scenarios/sync/adhoc-call-visible-channel/): Кнопка «Создать Sync» создаёт канал встречи с читаемым именем (дата и время), чат в оверлее работает, а после переключения каналов сообщения встречи сохраняются в этом канале. Шаг 1. Ad-hoc встреча создала видимый канал…
- [Sync: чат в оверлее звонка синхронизирован с каналом](https://humanitec.ru/documentation/en/scenarios/sync/call-overlay-chat-sync/): Сообщение из основного чата видно в call-overlay, а сообщение из call-overlay после завершения звонка отображается в ленте канала. Шаг 1. Сообщение из основного чата отправлено Сообщение из основного чата отправлено Шаг…
- [Sync: старт звонка из шапки канала](https://humanitec.ru/documentation/en/scenarios/sync/channel-call-overlay/): В topic-канале пользователь нажимает «Звонок в этом канале»; после ответа сервера отображается оверлей звонка (атрибут data-call-active на sync-app). Шаг 1. Открыт topic-канал Открыт topic-канал Шаг 2. Отображается овер…
- [Sync: переход по прямой ссылке на канал](https://humanitec.ru/documentation/en/scenarios/sync/channel-from-url-query/): После создания канала в UI тест получает id канала через API и открывает Sync по `/sync/c/{channel_id}` — выбранный канал и чат подгружаются автоматически. Шаг 1. Повторное открытие Sync по прямой ссылке канала Повторно…
- [Sync: selecting a space](https://humanitec.ru/documentation/en/scenarios/sync/create-space/): The user opens Sync and selects an existing platform namespace from the sidebar selector. Step 1. Sync is open with all spaces selected Sync is open with all spaces selected Step 2. Space is selected in the sidebar Spac…
- [Sync: создание канала в пространстве](https://humanitec.ru/documentation/en/scenarios/sync/create-topic-channel/): После создания пространства пользователь создаёт topic-канал через «+» у раздела «Каналы» и подтверждает создание. Шаг 1. Выбрано пространство Sync Выбрано пространство Sync Шаг 2. Открыто создание канала Открыто создан…
- [Sync: удаление своего сообщения](https://humanitec.ru/documentation/en/scenarios/sync/delete-own-message/): Пользователь удаляет своё сообщение через контекстное меню. Шаг 1. Сообщение для удаления в ленте Сообщение для удаления в ленте Шаг 2. Сообщение исчезло из ленты Сообщение исчезло из ленты
- [Sync: настройки пространства](https://humanitec.ru/documentation/en/scenarios/sync/edit-space-name/): Пользователь открывает Sync-настройки выбранного платформенного пространства и включает опцию транскрибации голосовых сообщений. Шаг 1. Sync открыт Sync открыт Шаг 2. Открыты настройки пространства Открыты настройки про…
- [Sync](https://humanitec.ru/documentation/en/scenarios/sync/): Step-by-step UI instructions with screenshots. Pages Sync: ad-hoc звонок использует обычный видимый канал Sync: selecting a space Sync: загрузка оболочки чата Sync: клик по @mention открывает карточку профиля Sync: моби…
- [Sync: страница входа по недействительной ссылке](https://humanitec.ru/documentation/en/scenarios/sync/join-invalid-token/): Публичная страница /sync/join/{token} показывает сообщение об ошибке для несуществующего токена. Шаг 1. Сообщение об ошибке для неверной ссылки Сообщение об ошибке для неверной ссылки
- [Sync: упоминание @ в канале](https://humanitec.ru/documentation/en/scenarios/sync/mention-from-popup/): Создаётся канал, второй участник компании добавлен в канал через API. В композере после «@» открывается список участников; выбор вставляет @user_id; в пузырьке mention показывает имя из company members, не сырой id. Шаг…
- [Sync: клик по @mention открывает карточку профиля](https://humanitec.ru/documentation/en/scenarios/sync/mention-profile-modal/): После отправки сообщения с упоминанием клик по подсвеченному имени открывает карточку профиля; видны имя, блок каналов вместе; в сетке есть строка канала как в сайдбаре. Шаг 1. Упоминание в ленте Упоминание в ленте Шаг…
- [Sync: отправка сообщения с изображением](https://humanitec.ru/documentation/en/scenarios/sync/message-with-image/): Пользователь прикрепляет изображение к сообщению; после отправки в ленту попадает блок с картинкой. Шаг 1. Канал открыт Канал открыт Шаг 2. Сообщение с превью изображения в ленте Сообщение с превью изображения в ленте
- [Sync: мобильный список чатов](https://humanitec.ru/documentation/en/scenarios/sync/mobile-sidebar-menu/): При ширине viewport как на телефоне Sync показывает список чатов прямо на главном экране, без дополнительного раскрытия сайдбара. Шаг 1. Sync на узком viewport Sync на узком viewport Шаг 2. Список чатов доступен без лиш…
- [Sync: мьют уведомлений в настройках канала](https://humanitec.ru/documentation/en/scenarios/sync/mute-channel-notifications/): Пользователь открывает настройки topic-канала и включает «Не беспокоить». Шаг 1. Открыты настройки канала Открыты настройки канала Шаг 2. Включён мьют уведомлений Включён мьют уведомлений
- [Sync: открытие чата с участником компании](https://humanitec.ru/documentation/en/scenarios/sync/open-dm-from-members/): В разделе «Личные» пользователь находит коллегу по имени и открывает с ним диалог. Шаг 1. Sync открыт, раздел «Личные» доступен Sync открыт, раздел «Личные» доступен Шаг 2. Поиск по имени участника Поиск по имени участн…
- [Sync: профиль отправителя из сообщения](https://humanitec.ru/documentation/en/scenarios/sync/peer-profile-from-message/): В канал добавлен участник; его сообщение создаётся через API; владелец открывает профиль по кнопке на аватаре в пузырьке чужого сообщения. Шаг 1. В канал добавлен второй участник В канал добавлен второй участник Шаг 2.…
- [Sync: реакция и редактирование своего сообщения](https://humanitec.ru/documentation/en/scenarios/sync/reaction-edit-message/): Сообщение отправляется из UI; реакция ставится через API; после перезагрузки видна метка реакции; редактирование текста выполняется в UI. Шаг 1. Сообщение отправлено Сообщение отправлено Шаг 2. Поставлена реакция Постав…
- [Sync: отправка сообщения в канал](https://humanitec.ru/documentation/en/scenarios/sync/send-message-in-channel/): Пользователь открывает канал, вводит текст в поле «Сообщение…» и отправляет его; текст отображается в ленте. Шаг 1. Выбран канал, открыт чат Выбран канал, открыт чат Шаг 2. Сообщение отображается в ленте Сообщение отобр…
- [Sync: загрузка оболочки чата](https://humanitec.ru/documentation/en/scenarios/sync/sync-chat-shell/): После входа под системным пользователем открывается SPA Sync; на экране отображается корневой элемент приложения (sync-app). Шаг 1. Приложение Sync открыто по URL SPA Приложение Sync открыто по URL SPA Шаг 2. Оболочка s…
- [Sync: полная инструкция по сервису](https://humanitec.ru/documentation/en/scenarios/sync/sync-complete-guide/): Длинная инструкция по основному рабочему маршруту Sync: пространство, канал, сообщения, упоминания, вложения, меню сообщения, закрепы, треды, настройки канала, профиль участника и реальные realtime-обновления. Step 1. О…
- [Sync: панель тредов после ответа на сообщение](https://humanitec.ru/documentation/en/scenarios/sync/thread-reply-drawer/): Пользователь отвечает на сообщение в основной ленте и открывает панель «Треды»: заголовок и область списка отображаются (список может быть пустым, если thread_id ещё не задан у сообщений в ленте). Шаг 1. Созданы простра…