Appearance
Агенты 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 XLSX | create_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.io | drawio | Построение архитектурных и структурных схем draw.io | create_drawio, read_drawio, update_drawio, search_media |
| Бизнес-процессы BPMN | bpmn | Моделирование процессов по стандарту BPMN 2.0 | create_bpmn, read_bpmn, update_bpmn, search_media |
Code-агенты — особый случай: это не карточки, а инструменты кода, подключаемые через MCP, и системные агенты раннера (code-research, task-systems-analysis). Прежние карточки code-architect / code-relations / code-reviewer / db-inspector удалены миграцией. Подробнее — Исследование кода.
Как использовать агентов
Способ 1. Выбор агента в композере чата (рекомендуемый)
- Откройте любой AI-чат: общее окно (
/ai-router), чат пространства (/space/:id/chat) или тетрадь в Блокнотах. - В нижней панели композера найдите селектор «Агент».
- Выберите нужного специалиста (например, Генератор документов или PPTX).
- Отправьте запрос естественным языком. Агент активирует свой набор инструментов и системный навык.
Наследование скоупов
При работе в чате пространства выбранный агент автоматически сохраняет доступ к базе знаний этого пространства (space-{id}), заметкам и задачам.
Способ 2. Автоматический вызов в режиме мульти-агента (mode=multi-agent)
Если в композере выбран режим «Мульти-агент» (mode=multi-agent), вам не обязательно переключать агента вручную:
- Вы формулируете комплексную задачу, например:
"Изучи документацию по сервису биллинга в нашей базе знаний, составь архитектурную схему в draw.io и сформируй официальный отчет в DOCX."
- Оркестратор видит только карточки, которые администратор уже создал (например
drawioиdoc-generator). Пустой каталог — делегировать некому, ход выполняет сам оркестратор. - Через инструмент
spawn_agentоркестратор изолированно запускает дочерние задачи субагентам. - Каждый агент выполняет свою часть работы, сохраняет файлы в хранилище и возвращает артефакты в общий контекст диалога.
Непрерывный контекст и работа с файлами
- Автоматическое прикрепление к сообщению: Все файлы, сгенерированные агентами (документы, презентации, схемы), возвращают метаданные (
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.