# Агенты

## Что такое агенты?

Агенты, это изолированные ИИ-ассистенты, которые рассуждают над проблемами, выполняют задачи и общаются на множестве платформ. Каждый агент имеет собственное рабочее пространство, историю сессий, конфигурацию модели и привязки к каналам.

## Изоляция агентов

Каждый агент получает:

- **Рабочее пространство**, выделенная директория для файлов, заметок и данных агента
- **Сессии**, независимая история разговоров и транскрипты
- **Конфигурация**, выбор модели, разрешения для инструментов, лимиты расходов
- **Идентичность**, уникальная персона, определённая в файле `AGENTS.md` агента
- **Профили аутентификации**, конфигурации ключей API и аутентификации для каждого агента

## Персоны агентов

Рабочее пространство каждого агента содержит файл `AGENTS.md`, определяющий личность, инструкции и поведенческие правила. Этот постоянный системный промпт формирует то, как агент отвечает, тон, предметная экспертиза, форматирование, использование инструментов и политики безопасности.

## Маршрутизация для нескольких агентов

При работе нескольких агентов входящие сообщения маршрутизируются автоматически на основе **привязок**:

- **Привязка к каналу**, все сообщения с платформы (например, все Telegram → агент `personal`)
- **Привязка к серверу/рабочему пространству**, конкретный сервер Discord или рабочее пространство Slack направляется к выделенному агенту
- **Привязка по типу чата**, личные сообщения направляются к одному агенту, групповые, к другому
- **Привязка к контакту/собеседнику**, сообщения от конкретных контактов направляются к конкретным агентам

Привязки оцениваются в порядке приоритета. Побеждает первое совпадение. Несовпавшие сообщения направляются к агенту по умолчанию.

## Суб-агенты и делегирование

Агенты могут порождать суб-агентов для специализированных задач:

- **Делегирование задач**, разбивать сложные задачи и делегировать части специализированным суб-агентам
- **Изолированное выполнение**, суб-агенты работают в собственном контексте сессии
- **Переговорные разговоры**, агенты могут вести диалоги туда-обратно (до 5 итераций) для совместной работы
- **Объявление результатов**, результаты суб-агента могут быть опубликованы обратно в исходный канал

## Команды и оркестрация

Многоагентные команды обеспечивают скоординированные рабочие процессы:

- **Параллельное выполнение**, запускать несколько агентов одновременно над разными аспектами задачи
- **Последовательные конвейеры**, объединять агентов в цепочку, где каждый опирается на вывод предыдущего
- **Гибридный режим**, сочетать параллельное и последовательное выполнение
- **Отслеживание задач**, отслеживать статус работы каждого агента (в очереди, выполняется, готово, ошибка, отменено)

## Профили инструментов

Управляйте тем, что может делать каждый агент:

| Профиль | Доступные инструменты |
|---------|----------------|
| **minimal** | Только статус сессии |
| **coding** | Ввод-вывод файлов, выполнение, сессии, память, изображения |
| **messaging** | Отправка сообщений, история сессий |
| **full** | Все инструменты (по умолчанию) |

Пользовательские списки разрешений/запретов можно задать для каждого агента и каждого провайдера модели.

## Безопасный режим

Безопасный режим предоставляет песочницу для выполнения:

- **Главный переключатель**, включить или отключить глобально
- **Управление по агентам**, отключить для доверенных агентов, оставить включённым для остальных
- **Подтверждение выполнения**, чувствительные операции требуют явного подтверждения пользователя
- **Синхронизация политик**, настройки синхронизируются во всех подключённых клиентах в режиме реального времени

## Память агента

Каждый агент имеет доступ к системе памяти:

- **MEMORY.md**, постоянные заметки и важная информация между сессиями
- **Файлы памяти**, дополнительные структурированные знания в директории `memory/`
- **Векторный поиск**, поиск в памяти с использованием запросов на естественном языке

Подробности см. в разделе [Сессии и память](sessions-memory.md).