Skip to content

Агенты AI-чата: обзор и руководство ​

Chat Agents (Агенты AI-чата) — это специализированные профили ИИ в сервисе AI Router, оптимизированные под решение конкретных прикладных задач: от верстки корпоративных документов и подготовки презентаций до построения архитектурных схем и моделирования бизнес-процессов.

Терминология

Эта страница описывает пользовательские карточки ассистентов (Assistant). Версионируемые системные агенты, исполняемые через runner-agent, описаны отдельно: Системные агенты и runner-agent.

Каждый агент объединяет:

  • Специализированный System Prompt: сфокусированная ролевая инструкция и правила валидации ответов.
  • Набор инструментов (Tools): точечно подобранные вызовы API (генерация файлов, поиск по RAG, работа с медиа или таблицами), исключающие лишние побочные действия.
  • Системные навыки (Skills): корпоративные руководства по стилизации, типографике и отраслевым стандартам.
  • Права доступа: разграничение скоупов базы знаний и внешних MCP-инструментов.

Каталог ​

После установки список ассистентов пустой. Карточки создаёт администратор в Настройки → AI Router → Ассистенты. Ниже — специалисты, которых имеет смысл завести вручную: те же slug, tools и назначение.

АгентИдентификатор (slug)НазначениеКлючевые инструменты
Code-агентыкарточек нет; системные агенты code-research, task-systems-analysisИсследование кодовой базы через подключаемый MCP-сервер, архитектурный и системный анализMCP-инструменты кода (search/read), search_knowledge_base
Генератор документовdoc-generatorСоздание отчетов, памяток и таблиц в форматах DOCX, PDF и Excel XLSXcreate_docx, update_docx, create_xlsx, create_pdf, search_knowledge_base, search_tables
ПрезентацииpptxПроектирование и генерация колод слайдов PowerPoint (.pptx)create_pptx, read_pptx, update_pptx, search_knowledge_base, search_media
Диаграммы draw.iodrawioПостроение архитектурных и структурных схем draw.iocreate_drawio, read_drawio, update_drawio, search_media
Бизнес-процессы BPMNbpmnМоделирование процессов по стандарту BPMN 2.0create_bpmn, read_bpmn, update_bpmn, search_media

Code-агенты — особый случай: это не карточки, а инструменты кода, подключаемые через MCP, и системные агенты раннера (code-research, task-systems-analysis). Прежние карточки code-architect / code-relations / code-reviewer / db-inspector удалены миграцией. Подробнее — Исследование кода.


Как использовать агентов ​

Способ 1. Выбор агента в композере чата (рекомендуемый) ​

  1. Откройте любой AI-чат: общее окно (/ai-router), чат пространства (/space/:id/chat) или тетрадь в Блокнотах.
  2. В нижней панели композера найдите селектор «Агент».
  3. Выберите нужного специалиста (например, Генератор документов или PPTX).
  4. Отправьте запрос естественным языком. Агент активирует свой набор инструментов и системный навык.

Наследование скоупов

При работе в чате пространства выбранный агент автоматически сохраняет доступ к базе знаний этого пространства (space-{id}), заметкам и задачам.


Способ 2. Автоматический вызов в режиме мульти-агента (mode=multi-agent) ​

Если в композере выбран режим «Мульти-агент» (mode=multi-agent), вам не обязательно переключать агента вручную:

  1. Вы формулируете комплексную задачу, например:

    "Изучи документацию по сервису биллинга в нашей базе знаний, составь архитектурную схему в draw.io и сформируй официальный отчет в DOCX."

  2. Оркестратор видит только карточки, которые администратор уже создал (например drawio и doc-generator). Пустой каталог — делегировать некому, ход выполняет сам оркестратор.
  3. Через инструмент spawn_agent оркестратор изолированно запускает дочерние задачи субагентам.
  4. Каждый агент выполняет свою часть работы, сохраняет файлы в хранилище и возвращает артефакты в общий контекст диалога.

Непрерывный контекст и работа с файлами ​

  • Автоматическое прикрепление к сообщению: Все файлы, сгенерированные агентами (документы, презентации, схемы), возвращают метаданные (file_name, download_url, file_id). Они автоматически появляются в блоке Источники / Файлы прямо под сообщением ассистента со ссылкой на мгновенное скачивание в браузере.
  • Память сессии (Session Facts): Сервис фиксирует идентификаторы последних созданных файлов (last_file_id, last_file). Вы можете писать контекстные уточнения следующими сообщениями:
    • «Переделай этот документ в PDF»
    • «Добавь в созданную таблицу еще один столбец с НДС»
    • «Поменяй цветовую тему презентации на темную»

Управление агентами для администраторов ​

Администраторы создают и правят карточки в Настройки → AI Router → Ассистенты (/settings/ai-router/assistants). Системных карточек после установки нет.

  • Создать карточку: system_prompt, узкий список tools, скиллы, scopes, MCP.
  • Включить или выключить (active).
  • Открыть карточку выбранным пользователям через shared_user_ids.