Appearance
Агенты AI-чата: обзор и руководство
Chat Agents (Агенты AI-чата) — это специализированные профили ИИ в сервисе AI Router, оптимизированные под решение конкретных прикладных задач: от верстки корпоративных документов и подготовки презентаций до построения архитектурных схем и моделирования бизнес-процессов.
Каждый агент объединяет:
- Специализированный System Prompt: сфокусированная ролевая инструкция и правила валидации ответов.
- Набор инструментов (Tools): точечно подобранные вызовы API (генерация файлов, поиск по RAG, работа с медиа или таблицами), исключающие лишние побочные действия.
- Системные навыки (Skills): корпоративные руководства по стилизации, типографике и отраслевым стандартам.
- Права доступа: разграничение скоупов базы знаний и внешних MCP-инструментов.
Каталог системных агентов
В платформу Unishift встроены предустановленные системные агенты:
| Агент | Идентификатор (slug) | Назначение | Ключевые инструменты |
|---|---|---|---|
| Code-агенты | code-architect, code-relations, code-reviewer, db-inspector | Исследование кодовой базы, архитектурный анализ, зависимости, ревью кода и схемы БД | create_drawio, search_tables, get_table, search_knowledge_base, наследование MCP |
| Генератор документов | doc-generator | Создание отчетов, памяток и таблиц в форматах DOCX, PDF и Excel XLSX | get_document_runners, render_document, 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 |
Как использовать агентов
Способ 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/agents):
- Включать и отключать системных агентов (
active: true/false). - Корректировать системные промпты и список разрешенных инструментов (
tools). - Привязывать новые скиллы (
skill_slugs) и внешние MCP-серверы (mcp_slugs). - Создавать собственных кастомных агентов под специфические бизнес-процессы компании.