Практические сценарии

Создание агента: полный путь

Сквозной сценарий «с нуля»: вход → новое пространство → агент из шаблона поддержки → интеграции GitLab/YouTrack → первый чат (почта + базы знаний) → Telegram-канал → сводка с графиком и автоматизация по расписанию → просмотр запусков → вопрос к базе знаний. Каждый шаг — скриншот на вашей инсталляции; в конце главы приложена видеоинструкция с русскими субтитрами и подсветкой действий.

1. Вход

Откройте https://console.agentek.ru — платформа перенаправит на корпоративный SSO (Dex). Выберите «Active Directory» и войдите доменной учётной записью (с подтверждением MFA).

2. Новое пространство

Меню пространств вверху слева → «Создать пространство». Задайте название — slug подставится автоматически — и нажмите «Создать».

3. Агент из шаблона поддержки

«Создать агента» → «Выбрать шаблон» → в каталоге маркетплейса выберите «🎧 Агент клиентской поддержки» (категория «Поддержка»). Форма заполнится из шаблона — имя, slug и системный промпт уже готовы, — нажмите «Создать агента».

4. Интеграции: GitLab и YouTrack

Агент → вкладка «Интеграции». Откройте карточку GitLab, заполните GITLAB_API_URL и токен (под полем токена — ссылка «Получить токен»), нажмите «Подключить». То же для YouTrack (YOUTRACK_URL + токен). Подключённые серверы отмечены зелёным тумблером.

5. Первый чат — почта и базы знаний

Почта. Сначала положите доступ в «Секреты» агента: MAIL_ADDRESS и MAIL_PASSWORD (пароль приложения; уровень «Этот агент»), затем в чате попросите подключить ящик:

Агент настроит провайдера, проверит IMAP и покажет последнее письмо.

Базы знаний организации. В том же чате дайте агенту адреса MCP RAG-серверов — он подключит их сам (mcp add + mcp test) и перечислит доступные инструменты:

6. Telegram-канал

Агент → «Каналы» → «Telegram-бот» → вставьте Bot Token (от @BotFather), добавьте разрешённые Telegram-ID и «Подключить». Токен проверяется на лету (показывает имя бота). Теперь агент отвечает и в Telegram.

7. Сводка с графиком и автоматизация

Новый чат — попросите сводку изменений и наглядный график:

Агент строит план, тянет данные из обоих источников через MCP и выдаёт сводку (коммиты по авторам, обновлённые задачи) с текстовым графиком активности по часам.

Понравился результат — превратите его в ежедневную автоматизацию прямо из чата:

8. Автоматизации и история запусков

Раздел «Автоматизации» — созданное расписание со статусом и ближайшим запуском. Откройте карточку: виден промпт автоматизации и триггер (расписание, MSK); кнопка «Запустить сейчас» гоняет её вручную. В истории запусков каждый прогон раскрывается в диалог агента (только для просмотра).

9. Вопрос к базе знаний

Новый чат — сначала отправьте /reload-mcp, чтобы в этой сессии подхватились подключённые базы знаний, затем спросите о продукте. Агент выполняет семантический поиск по базе знаний YouTrack (youtrack-rag) и синтезирует ответ по найденному — статьям и задачам.

Агент из шаблона и бутстрап

Шаблон — это готовая роль: системный промпт, иконка и набор умений уже настроены. После создания агент сам начинает бутстрап-диалог — первый чат, в котором он выясняет ваш контекст и донастраивается.

1. «Создать агента» → «Выбрать шаблон» → выберите категорию. Для персональных задач — категория «Личное».

2. Откройте шаблон — форма создания уже заполнена: имя, slug и системный промпт можно править до создания. Если шаблон предлагает канал (например, Telegram-бот), его можно настроить сразу или снять выбор и подключить позже.

3. Нажмите «Создать агента» и дождитесь активного статуса (зелёная точка у имени).
4. У шаблонов с бутстрапом в списке чатов появится автоматически созданный первый диалог — агент сам задаст вопросы: какие системы подключить, что для вас важно, какие правила соблюдать.

База знаний пространства

База знаний собирает источники — документы, ссылки, Git-репозитории, трекеры и вики — и делает их доступными всем агентам пространства для поиска (RAG). Раздел «Базы знаний» — в левой навигации.

1. «Создать базу» — задайте название; slug генерируется сам (он попадает в имена MCP-инструментов агентов и после создания не меняется).

2. В карточке базы — «Добавить источник»: тип (YouTrack, GitLab, Документ, Ссылка, Git-репозиторий), название, адрес и частота обновления (каждый час / ежедневно / еженедельно / вручную).

3. Источник появляется в списке со статусом индексации; «Синхронизировать всё» запускает обход вручную, дальше база обновляется по расписанию источника.

4. Агентам пространства база доступна автоматически через MCP-инструменты — попросите агента поискать в базе по имени («найди в базе знаний …»), отдельного подключения не требуется.

Сетевой диск агента (WebDAV)

Рабочую папку агента можно смонтировать сетевым диском на своём компьютере — файлы агента открываются в Finder/Проводнике как обычная папка.

1. Карточка агента → вкладка «Настройки» → включите «Сетевой диск (WebDAV)».
2. Платформа выпускает логин и пароль; пароль показывается один раз — сохраните его сразу. Он также кладётся в секреты агента (WEBDAV_PASSWORD), там его можно сменить; потеряли — выключите и включите диск, выпустится новый.

3. В карточке остаются URL диска и логин; по умолчанию доступ только на чтение — тумблер «Запись (RW)» включает запись.

4. Подключение: macOS — Finder → «Подключиться к серверу» → URL; Windows — «Подключить сетевой диск» → URL.

Диск содержит две папки: workspace/ — личная рабочая папка агента, и office/ — общий каталог инстанса, видимый всем агентам пространства.

OpenAI-совместимый API агента

Агента можно дёргать из своего кода и сторонних клиентов как обычный OpenAI-endpoint (/v1/chat/completions) — под собственным ключом, не раскрывая платформенные токены.

1. Карточка агента → вкладка «Настройки» → блок «OpenAI-совместимый API».
2. Заполните «Доступ с IP»: конкретные адреса, CIDR-подсети или * — без ограничений. Пока список пуст, API не включится.
3. Включите тумблер — платформа выпустит ключ (показывается один раз) и Base URL.

4. Авторизация — заголовок Authorization: Bearer <ключ>; заголовок X-Hermes-Session-Id держит непрерывность диалога между запросами. Потеряли ключ — выключите и включите API, выпустится новый.

curl -s "$BASE_URL/chat/completions" \
  -H "Authorization: Bearer $AGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "agent", "messages": [{"role": "user", "content": "Привет!"}]}'

Как маскирование меняет ответ

Пока маскирование включено, агент не видит реальные персональные данные — движок заменяет их нумерованными плейсхолдерами ещё до модели. Попросите агента составить письмо с ФИО, e-mail, телефоном и ИНН — в ответе вместо реальных данных будут метки <PERSON_1>, <EMAIL_ADDRESS_2>, <RU_PHONE_NUMBER_3>, <RU_INN_4>.

Это ожидаемое поведение. Если конкретному ключу/команде нужен доступ к реальным данным — снимите маскирование (см. выше).

Запуск MCP-сервера

На примере YouTrack. Сначала развернём сервис из каталога, затем подключим его к агенту как MCP.

1. Раздел Сервисы → Создать сервис → откроется «Каталог сервисов».

2. Выберите YouTrack MCP Server. Заполните параметр YOUTRACK_URL и секрет YOUTRACK_API_TOKEN (Profile → Account Security → Tokens в YouTrack), нажмите Развернуть.

3. В карточке сервиса возьмите адрес пространства — например http://mcp-youtrack (доступен агентам этого пространства).

4. В чате с агентом попросите подключить MCP по этому адресу (точка входа — <адрес>/mcp) и задайте вопрос. Агент сам выполнит mcp add/mcp test и ответит.

Сервисы из каталога: студии, хостинг приложений и публичный доступ

Помимо MCP-серверов, каталог сервисов разворачивает приложения для пространства: браузерные студии и хостинг ваших приложений. Всё создаётся одинаково: Сервисы → Создать сервис → шаблон → имя и параметры → Развернуть.

Design Studio — дизайн из текстового задания

AI-дизайн-студия (Open Design): прототипы, лендинги, дашборды и слайды из текстового описания, с экспортом в HTML/PDF/PPTX. Ключ LLM Роутера и модель платформа подставляет сама — ключ остаётся в поде и в браузер не уезжает. Открывается кнопкой «Открыть» под вашей учёткой консоли.

Подключите агента при создании — его workspace/ смонтируется в студию, и сгенерированный код ложится прямо к агенту.

Coding Studio — кодер в браузере

Браузерная среда разработки на базе opencode — подробно в главе «LLM-ключ и работа из IDE»: ключ и модели подключаются автоматически, рабочая папка — workspace/ привязанного агента.

«Хостинг приложения» — приложение из исходников

Разворачивает ваше приложение: собирает исходники внутри пода (по docker-compose.yml, иначе по Dockerfile) и держит перед ним nginx. Два источника (SOURCE):

• git — клон ветки репозитория; новая ревизия подхватывается автоматически (опрос ветки раз в минуту). Приватный доступ: HTTPS-токен GIT_TOKEN (GitLab Access Token c read_repository / GitHub PAT) или SSH deploy-ключ GIT_SSH_KEY.
• agent — исходники из workspace/ привязанного агента, без клона; пересборка по кнопке. Связка «агент пишет код → «Хостинг приложения» его публикует» закрывает полный цикл внутри платформы.

Порт приложения — APP_PORT (по умолчанию берётся из compose/EXPOSE, иначе 3000); наружу сервис всегда отвечает на :80. Служебные маршруты /health, /status, POST /rebuild защищайте секретом CONTROL_TOKEN — иначе перезапустить сервис сможет любой под в namespace.

Публичный доступ

Каждый сервис с веб-интерфейсом получает URL. Переключатель «Публичный доступ» (в форме создания или в карточке сервиса) решает, кто по нему попадёт:

• Выкл (по умолчанию) — URL за входом в консоль: страницу увидят только участники пространства под своей учёткой.
• Вкл — адрес открыт всем без входа: так публикуют собранный сайт или сервис для внешних пользователей.
• Сотрудники организации — для пространств организации: адрес открыт коллегам под их учётками, наружу закрыт. Так внутреннее приложение публикуется «для своих» без внешнего доступа.

Для MCP-сервисов тот же переключатель означает видимость для агентов: локальный сервер доступен только агентам пространства, публичный — всем агентам контура.

Подключение почты к агенту

Hermes-агент умеет работать с почтой через встроенный CLI himalaya (IMAP/SMTP).

1. Раздел Секреты → Создать секрет: MAIL_ADDRESS = адрес ящика и MAIL_PASSWORD = пароль приложения (уровень «Агент»).

2. В чате: «подключи ящик через himalaya и покажи последнее письмо». Агент настроит провайдера (для Яндекса imap.yandex.ru:993/smtp.yandex.ru:465, SSL) и прочитает почту.

Подключение Telegram-бота

1. Агент → вкладка Каналы → Telegram-бот. Вставьте Bot Token (от @BotFather) и добавьте в Пользователи разрешённые Telegram-ID (allowlist), затем Сохранить.

2. Напишите боту в Telegram — диалог появится в console в режиме просмотра (отвечает бот в самом Telegram).

Автоматизация: письмо → задача в YouTrack

Автоматизация запускает агента по расписанию. Соберём сценарий «прочитать новые письма и завести по ним задачи в YouTrack» (агент должен иметь подключённую почту и YouTrack MCP — см. разделы выше).

1. Автоматизации → Создать автоматизацию: выберите агента, задайте название, расписание (например «Каждый час») и промпт с задачей.

2. Автоматизация становится активной и срабатывает по расписанию; кнопка Запустить сейчас — ручной прогон.

Подтверждение действий

Перед потенциально опасными действиями (команды в терминале, выполнение кода) Hermes-агент по умолчанию спрашивает подтверждение: показывает команду и кнопки Разрешить (один раз), В сессии (до конца сессии), Всегда (запомнить) и Отклонить.

Отключить подтверждения

Чтобы агент выполнял действия без запроса, добавьте ему секрет HERMES_YOLO_MODE = 1 (Секреты → Создать секрет, уровень «Агент»). После этого агент перестаёт спрашивать разрешение.