К содержимому

Конфигурация Mattermost ​

ENV коннектора ​

ПеременнаяПо умолчаниюНазначение
ORPHEUS_BASE_URLrequiredАдрес API Orpheus без /api/v1
ORPHEUS_API_KEYrequiredСервисный Bearer-ключ
WORKFLOWS_DIRworkflowsКаталог файлов .md, без вложенных каталогов
LISTEN_ADDR:8080Адрес health и metrics
HTTP_TIMEOUT30sТаймаут HTTP-запроса
MAX_REQUEST_BYTES1048576Бюджет запроса, от 4096 до 1048576 байт
MAX_PARALLEL_THREADS8Параллельные сверки тредов, от 1 до 128
AGENTBOX_API_KEYunsetДоставка файлов в активный запуск
AGENTBOX_API_URLSDK defaultНеобязательное переопределение SDK endpoint

YAML workflow ​

ПолеПо умолчаниюНазначение
idrequiredУникальное имя workflow
revisionrequiredСтрока ревизии
reconcile_fromrequiredФиксированная дата начала обработки UTC RFC3339
profilerequiredИмя профиля Orpheus
sandbox_templaterequiredИмя шаблона AgentBox
mattermost.base_urlrequiredАдрес Mattermost
mattermost.token_envrequiredИмя ENV токена бота
env_from[]Переменные worker для агента
services[]Уникальные коды сервисов, передаваемые сессии агента вместе с env_from
include_ids / exclude_ids[]ID включённых и исключённых каналов. Не включает приватные и групповые каналы
direct_messagesfalseОбрабатывать личные сообщения
private_channelsfalseОбрабатывать закрытые каналы
group_messagesfalseОбрабатывать групповые сообщения
start_on_mentiontrueТребовать упоминание для нового треда
trigger_bot_ids[]Разрешённые внешние боты
send_commentary_messagestrueПубликовать промежуточные сообщения
drainingfalseДоставлять принятые результаты без новых задач
message_batch_window0Окно сбора сообщений
poll_interval30sИнтервал сверки каналов
full_reconcile_interval5mИнтервал полной сверки сессий
max_concurrent_runs10Параллельные запуски workflow
run_timeout_seconds3600Таймаут исполнения агента
hook_timeout_seconds120Таймаут файловых хуков
max_session_tokens100000000Бюджет токенов сессии
max_post_chars12000Символов в сообщении с учётом лимита сервера
initial_context_token_budget100000Приблизительный бюджет начального контекста
files.max_per_post5Файлов на входное сообщение, от 1 до 100
files.max_file_bytes10485760Байт в обычном входном файле
files.max_image_bytes20971520Байт во входном изображении
files.max_batch_bytes104857600Байт во входном пакете, максимум 100 MiB
files.max_output_files5Число файлов результата, от 1 до 100 с учётом лимита сервера Mattermost
files.max_output_bytes31457280Байт в одном выходном файле
link_expansion.enabledtrueРаскрывать ссылки на этот Mattermost
link_expansion.max_links5Число раскрываемых ссылок
link_expansion.max_posts20Число сообщений по ссылкам

Коннектор автоматически выходит из приватных каналов без маршрута. Настройте доступ до запуска или перезагрузки коннектора и до приглашения бота. См. маршрутизацию каналов.

Обязательные поля отмечены required. Неизвестные поля, дубли ключей, совпадающие ID и пересекающиеся специализированные маршруты отклоняются. revision заключайте в кавычки. После YAML запишите полные инструкции агенту.

Секреты не записываются в workflow. token_env и env_from содержат имена переменных. Примеры · Применение изменений.

Автор и канал сообщения ​

Каждый пост приходит агенту отдельным сообщением с front matter:

yaml
---
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 у самого бота недостаточно. Если адрес недоступен, агент не должен угадывать владельца задания.