Конфигурация Mattermost
ENV коннектора
| Переменная | По умолчанию | Назначение |
|---|---|---|
ORPHEUS_BASE_URL | required | Адрес API Orpheus без /api/v1 |
ORPHEUS_API_KEY | required | Сервисный Bearer-ключ |
WORKFLOWS_DIR | workflows | Каталог файлов .md, без вложенных каталогов |
LISTEN_ADDR | :8080 | Адрес health и metrics |
HTTP_TIMEOUT | 30s | Таймаут HTTP-запроса |
MAX_REQUEST_BYTES | 1048576 | Бюджет запроса, от 4096 до 1048576 байт |
MAX_PARALLEL_THREADS | 8 | Параллельные сверки тредов, от 1 до 128 |
AGENTBOX_API_KEY | unset | Доставка файлов в активный запуск |
AGENTBOX_API_URL | SDK default | Необязательное переопределение SDK endpoint |
YAML workflow
| Поле | По умолчанию | Назначение |
|---|---|---|
id | required | Уникальное имя workflow |
revision | required | Строка ревизии |
reconcile_from | required | Фиксированная дата начала обработки UTC RFC3339 |
profile | required | Имя профиля Orpheus |
sandbox_template | required | Имя шаблона AgentBox |
mattermost.base_url | required | Адрес Mattermost |
mattermost.token_env | required | Имя ENV токена бота |
env_from | [] | Переменные worker для агента |
services | [] | Уникальные коды сервисов, передаваемые сессии агента вместе с env_from |
include_ids / exclude_ids | [] | ID включённых и исключённых каналов. Не включает приватные и групповые каналы |
direct_messages | false | Обрабатывать личные сообщения |
private_channels | false | Обрабатывать закрытые каналы |
group_messages | false | Обрабатывать групповые сообщения |
start_on_mention | true | Требовать упоминание для нового треда |
trigger_bot_ids | [] | Разрешённые внешние боты |
send_commentary_messages | true | Публиковать промежуточные сообщения |
draining | false | Доставлять принятые результаты без новых задач |
message_batch_window | 0 | Окно сбора сообщений |
poll_interval | 30s | Интервал сверки каналов |
full_reconcile_interval | 5m | Интервал полной сверки сессий |
max_concurrent_runs | 10 | Параллельные запуски workflow |
run_timeout_seconds | 3600 | Таймаут исполнения агента |
hook_timeout_seconds | 120 | Таймаут файловых хуков |
max_session_tokens | 100000000 | Бюджет токенов сессии |
max_post_chars | 12000 | Символов в сообщении с учётом лимита сервера |
initial_context_token_budget | 100000 | Приблизительный бюджет начального контекста |
files.max_per_post | 5 | Файлов на входное сообщение, от 1 до 100 |
files.max_file_bytes | 10485760 | Байт в обычном входном файле |
files.max_image_bytes | 20971520 | Байт во входном изображении |
files.max_batch_bytes | 104857600 | Байт во входном пакете, максимум 100 MiB |
files.max_output_files | 5 | Число файлов результата, от 1 до 100 с учётом лимита сервера Mattermost |
files.max_output_bytes | 31457280 | Байт в одном выходном файле |
link_expansion.enabled | true | Раскрывать ссылки на этот Mattermost |
link_expansion.max_links | 5 | Число раскрываемых ссылок |
link_expansion.max_posts | 20 | Число сообщений по ссылкам |
Коннектор автоматически выходит из приватных каналов без маршрута. Настройте доступ до запуска или перезагрузки коннектора и до приглашения бота. См. маршрутизацию каналов.
Обязательные поля отмечены required. Неизвестные поля, дубли ключей, совпадающие ID и пересекающиеся специализированные маршруты отклоняются. revision заключайте в кавычки. После YAML запишите полные инструкции агенту.
Секреты не записываются в workflow. token_env и env_from содержат имена переменных. Примеры · Применение изменений.
Автор и канал сообщения
Каждый пост приходит агенту отдельным сообщением с front matter:
---
kind: thread
post_id: post-id
root_id: root-id
channel: {"id":"channel-id","name":"dev-test-group"}
author: {"id":"user-id","username":"alice","nickname":"Alice","email":"alice@example.com"}
created_at: 2026-10-01T07:00:00Z
---channel.name — имя канала из ~dev-test-group без ~. У личных и групповых каналов это сгенерированное имя. Связанные треды содержат сведения о собственных авторах и каналах.
Email берётся из профиля Mattermost. Для ботов и постов вебхуков email не передаётся. Пустые необязательные поля опускаются. Это позволяет навыку Space определить автора конкретной просьбы, но само по себе не задаёт права доступа.
Для работы по email токен коннектора должен читать адреса других пользователей. Обычному боту требуется включённая настройка Mattermost PrivacySettings.ShowEmailAddress. Проверьте GET /api/v4/users/{human-user-id} с токеном коннектора: наличие email у самого бота недостаточно. Если адрес недоступен, агент не должен угадывать владельца задания.