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

Подключение своей системы ​

Для задач из чата используйте коннектор Mattermost. Для ревью merge request — коннектор GitLab.

Коннектор переводит события вашей системы в задачи для Orpheus. Он может быть небольшим сервисом, обработчиком webhook или периодическим заданием.

text
Новый тикет → коннектор → POST /sessions → агент
                                            ↓
Хелпдеск ← API-вызов агента или after_run ← результат

Разделите обязанности ​

Ваша интеграцияOrpheusАгент
Выбирает события и собирает контекстЗапускает выполнение и сохраняет историюРешает задачу доступными инструментами
Связывает объект с сессиейПринимает новые задачи и уточненияГотовит ответ или файл
Определяет доставку и повторыВозвращает состояния, события и результатыСледует заданным инструкциям

Входом API служит массив текстовых сообщений. Файлы подготавливаются отдельно в песочнице. Источник задач и целевая система не обязаны совпадать.

Для простого коннектора достаточно создавать отдельную сессию по каждому событию. Для чатового коннектора выберите allow_multiple_runs: true, чтобы продолжать диалог в одной сессии. Настройте доставку результата и обработку повторов.

Примеры используют Python и стандартную библиотеку. Они показывают отдельные операции, а не готовый webhook-сервер. Для Go доступен клиент Orpheus.