Подготовка окружения и доступов
Результат быстрого старта: бот отвечает в Mattermost, а его работу можно посмотреть в веб-интерфейсе Orpheus.
Установите инструменты
На компьютере или Linux-сервере установите Docker с Compose, Git и Python 3. Проверьте:
docker version
docker compose version
git --version
python3 --versionDocker должен быть запущен. Для компьютера подходит Docker Desktop. На сервере нужны Docker Engine и Compose plugin. Используйте Compose 2.24 или новее.
Подготовьте сервисы
- Создайте проект AgentBox и получите API-ключ. Соберите шаблон в этом проекте с Codex CLI и Python 3.9 или новее. В примерах используется alias
codexс тегомdefault. Публичный шаблон другого проекта зарегистрировать в Orpheus нельзя. - Подготовьте API-ключ провайдера модели. В примере используется
gpt-6-sol. - Подготовьте сервер Mattermost с HTTPS-адресом. Коннектору нужен доступ к этому серверу для обмена сообщениями, а песочницам AgentBox — для скачивания вложений и отправки созданных агентом файлов. Если сервера нет, разверните его по инструкции ниже.
- Создайте бота по инструкции подключения и сохраните его токен.
Адрес Mattermost и токен бота понадобятся на следующем шаге — при заполнении настроек Orpheus.
Если Mattermost ещё не установлен
На Linux-сервере с Docker скачайте официальный комплект:
git clone https://github.com/mattermost/docker.git mattermost-server
cd mattermost-server
cp env.example .env
mkdir -p volumes/app/mattermost/{config,data,logs,plugins,client/plugins,bleve-indexes}
sudo chown -R 2000:2000 volumes/app/mattermostВ .env задайте DOMAIN, пароль PostgreSQL и фиксированный MATTERMOST_IMAGE_TAG. Запустите сервисы:
docker compose -f docker-compose.yml -f docker-compose.without-nginx.yml up -dНаправьте HTTPS reverse proxy вашего домена на порт 8065. Сохраните WebSocket-подключения. Откройте сайт, создайте администратора, команду и тестовый канал. Затем создайте бота по следующей инструкции. Подробности TLS и сетевых настроек приведены в руководстве Mattermost.
Далее: запуск сервисов.