Подключение своей системы
Для задач из чата используйте коннектор Mattermost. Для ревью merge request — коннектор GitLab.
Коннектор переводит события вашей системы в задачи для Orpheus. Он может быть небольшим сервисом, обработчиком webhook или периодическим заданием.
Новый тикет → коннектор → POST /sessions → агент
↓
Хелпдеск ← API-вызов агента или after_run ← результатРазделите обязанности
| Ваша интеграция | Orpheus | Агент |
|---|---|---|
| Выбирает события и собирает контекст | Запускает выполнение и сохраняет историю | Решает задачу доступными инструментами |
| Связывает объект с сессией | Принимает новые задачи и уточнения | Готовит ответ или файл |
| Определяет доставку и повторы | Возвращает состояния, события и результаты | Следует заданным инструкциям |
Входом API служит массив текстовых сообщений. Файлы подготавливаются отдельно в песочнице. Источник задач и целевая система не обязаны совпадать.
Для простого коннектора достаточно создавать отдельную сессию по каждому событию. Для чатового коннектора выберите allow_multiple_runs: true, чтобы продолжать диалог в одной сессии. Настройте доставку результата и обработку повторов.
Примеры используют Python и стандартную библиотеку. Они показывают отдельные операции, а не готовый webhook-сервер. Для Go доступен клиент Orpheus.