Інтеграція GitHub Issues
Працює з GitHub
Підключіть ReplyRabbit до GitHub Issues, щоб розмови підтримки у FreeScout могли ставати структурованими issues у правильному репозиторії. Агенти можуть створити issue з розмови, бачити пов'язану issue у FreeScout і дозволити ReplyRabbit підготувати передачу інженерії.
Шукаєте огляд?
Огляд
Інтеграція GitHub Issues додає панель GitHub до ReplyRabbit у розмові FreeScout. Коли GitHub налаштовано, ReplyRabbit може створити завдання зі зручною для розробника назвою, корисним підсумком, мітками, виконавцями, контекстом репозиторію та посиланням назад на розмову підтримки.
Кожна поштова скринька вибирає один трекер завдань: жодного, Linear або GitHub. GitHub і Linear є альтернативами для одного й того самого робочого процесу від підтримки до інженерії, а не двома трекерами, що працюють разом в одній поштовій скриньці.
Ручне створення завдань GitHub доступне на Pro і Team. Автоматичне створення завдань GitHub з нових листів клієнтів доступне на Team.
Передумови
Перед початком переконайтеся, що у вас є:
- Робоче встановлення FreeScout.
- ReplyRabbit встановлено та активовано.
- План ReplyRabbit, який включає потрібну вам функцію GitHub.
- Доступ до облікового запису або організації GitHub, де слід створювати задачі.
- Репозиторій із увімкненими GitHub Issues.
Якщо ReplyRabbit ще не встановлено, почніть з Як встановити модуль ReplyRabbit, потім завершіть Як налаштувати ReplyRabbit.
Дозволи та область дії токена
ReplyRabbit підключається до GitHub за допомогою особистого токена доступу, який ви надаєте в налаштуваннях поштової скриньки. Рекомендується деталізований токен, обмежений репозиторіями, які має використовувати ReplyRabbit. Ви можете створити його з Налаштування деталізованого токена GitHub.
Надайте токену достатньо доступу для читання метаданих репозиторію, читання міток і виконавців, створення й оновлення завдань та додавання коментарів до завдань. Для деталізованого токена почніть із Метадані: читання, Вміст: читання, і Задачі: читання та запис для вибраних репозиторіїв.
Для суворіших журналів аудиту створіть токен із виділеного облікового запису бота GitHub, який має доступ лише до репозиторіїв, які має використовувати ReplyRabbit.
Тримайте токен у таємниці. Якщо токен змінено або видалено в GitHub, оновіть налаштування поштової скриньки, перш ніж створювати більше задач.
Підключити GitHub Issues
Відкрийте налаштування поштової скриньки
У FreeScout відкрийте поштову скриньку, яка має створювати завдання GitHub, потім відкрийте Налаштування і виберіть ReplyRabbit.Вибрати GitHub як трекер завдань
У селекторі трекера завдань виберіть GitHub Issues. ReplyRabbit показує налаштування GitHub і приховує налаштування Linear для цієї поштової скриньки.Вставте токен
Вставте свій Особистий токен доступу GitHub. Якщо ви вже зберегли токен, ReplyRabbit показує замаскований попередній перегляд замість повного секрету.Завантажити репозиторії
Натисніть кнопку, щоб завантажити репозиторії з GitHub, потім виберіть типовий репозиторій, де слід створювати нові завдання.Зберегти налаштування
Збережіть налаштування поштової скриньки. ReplyRabbit зберігає підключення GitHub для цієї поштової скриньки.
Налаштувати типові значення
Після вибору репозиторію за замовчуванням налаштуйте значення за замовчуванням для задач, з яких мають починати ваші агенти:
- Репозиторій за замовчуванням: виберіть, де створюються задачі, коли жодне правило маршрутизації не збігається.
- Автоматичне надсилання завдань: на тарифі Team, дозвольте ReplyRabbit автоматично створювати завдання GitHub, коли результат тріажу вказує, що потрібна інженерна робота.
- Маршрутизація репозиторіїв: увімкніть автоматичний вибір репозиторію, коли хочете, щоб ReplyRabbit зіставляв розмови з доступними репозиторіями.
- Зіставлення доменів: зіставляйте домени електронної пошти клієнтів із конкретними репозиторіями, коли потрібна детермінована маршрутизація.
- Мітки: виберіть мітки, які ReplyRabbit може застосовувати для типу задачі, пріоритету або інших тегів робочого процесу.
- Мітки пріоритету: зіставляйте рівні пріоритету ReplyRabbit з мітками GitHub, оскільки GitHub Issues не має власного поля пріоритету.
- Призначуваний за замовчуванням: виберіть користувача GitHub, який має за замовчуванням отримувати нові задачі.
- Повідомлення про перегляд: коли ввімкнено автоматичне створення задач, додайте нотатку FreeScout, яка повідомляє агентам, що задачу створено автоматично і її слід переглянути.
Маршрутизація репозиторіїв необов'язкова. Якщо жоден репозиторій не зіставлено впевнено, ReplyRabbit використовує репозиторій за замовчуванням.
Створити issue GitHub з розмови FreeScout
Відкрийте розмову в поштовій скриньці, де налаштовано GitHub. Панель ReplyRabbit може створити issue GitHub з потоку клієнта, а потім показати прив'язаний issue у FreeScout.
Вміст задачі генерується для інженерної передачі, а не копіюється наосліп з усієї поштової нитки. Перегляньте назву, підсумок, мітки, виконавців і репозиторій перед створенням задачі, коли використовується ручне створення.
ReplyRabbit також може додати контекст поштового ланцюжка як коментар до issue на GitHub, щоб інженерний відділ мав дані клієнта, не просячи підтримку знову вставити той самий ланцюжок.
Тримайте розмови та задачі синхронізованими
Після прив'язки issue розмова FreeScout може показувати поточний ідентифікатор issue GitHub, заголовок, стан, мітки та виконавців. Агенти можуть відкрити issue в GitHub, коли їм потрібен повний інженерний огляд.
ReplyRabbit також підтримує цикл завершення: він перевіряє пов'язані проблеми GitHub за розкладом, зазвичай кожні 5 хвилин. Коли GitHub закриває проблему, ReplyRabbit може допомогти скласти чернетку подальшого звернення до клієнта, щоб підтримка могла закрити розмову з контекстом. Якщо ваша команда використовує причини закриття GitHub, ви можете обмежити чернетки завершення проблемами, закритими як completed.
Усунення несправностей
| Симптом | Що перевірити |
|---|---|
| Репозиторії не завантажаться | Підтвердьте, що токен актуальний і має доступ до вибраних репозиторіїв GitHub. |
| Задачі не створюються | Переконайтеся, що GitHub вибрано як трекер завдань, вибрано типовий репозиторій, а ваш план ReplyRabbit включає цю функцію. |
| Автоматичні завдання не створюються | Підтвердьте, що ви на тарифі Team і Автоматичне надсилання завдань увімкнено. |
| Репозиторій неправильний або відсутній | Переконайтеся, що маршрутизацію репозиторіїв або зіставлення доменів налаштовано. ReplyRabbit використовує типовий репозиторій, якщо немає впевненого збігу. |
| Мітки або виконавці не оновляться | Перезавантажте розмову, потім переконайтеся, що токен досі має доступ до пов'язаного репозиторію. |
| GitHub повертає помилки перевищення ліміту запитів | Зачекайте, поки скинеться ліміт GitHub API для токена, а потім розгляньте можливість звузити доступ до репозиторіїв або зменшити автоматичну активність щодо завдань. |
| Закриті завдання не генерують чернеток | Підтвердити Автоматична чернетка при завершенні увімкнено, і, якщо ввімкнено режим лише завершених, завдання GitHub було закрито як виконане. |
Для ширших виправлень дивіться Усунення несправностей ReplyRabbit.
Конфіденційність і обробка даних
ReplyRabbit надсилає GitHub вміст issue, потрібний для інженерної передачі. Це може включати відповідний контекст клієнта, згенерований заголовок issue, згенерований підсумок, мітки, виконавців і посилання або ідентифікатор розмови FreeScout.
Не вставляйте конфіденційну інформацію в завдання GitHub, якщо репозиторію не дозволено її отримувати. Якщо дані клієнтів мають повністю залишатися на вашому власному сервері, залиште GitHub вимкненим для цієї поштової скриньки.
Наступні кроки
- Продовжити з Як налаштувати ReplyRabbit якщо поштова скринька все ще потребує налаштувань провайдера, контексту або стилю.
- Читати Інтеграція зі Slack якщо ваша команда хоче створення завдань або сповіщень про завершення в Slack.
- Порівняти з Інтеграція з Linear якщо ви вирішуєте, який трекер завдань має використовувати поштова скринька.
Часті запитання
Чи потрібен мені особистий токен доступу GitHub?
Так. ReplyRabbit підключається до GitHub за допомогою токена з вашого власного облікового запису або організації GitHub.
Чи може одна поштова скринька використовувати Linear і GitHub одночасно?
Ні. Кожна поштова скринька обирає один трекер завдань: жоден, Linear або GitHub.
Чи може ReplyRabbit вибрати репозиторій GitHub?
Так, коли налаштовано маршрутизацію репозиторіїв. ReplyRabbit підтримує зіставлення за доменом і зіставлення репозиторіїв ШІ для репозиторіїв, до яких має доступ ваш токен.
Який план включає GitHub Issues?
Ручне створення завдань GitHub є функцією Pro. Автоматичне створення завдань GitHub є функцією Team.
Чи надсилає ReplyRabbit всю розмову з клієнтом до GitHub?
ReplyRabbit надсилає вміст issue, потрібний для інженерної передачі, включно з відповідним контекстом клієнта та згенерованим підсумком.