Інтеграція GitLab із ChatGPT і Codex наразі перебуває на етапі бета-тестування.
Огляд
Скористайтеся шаблоном застосунку GitLab Self-Managed, щоб створити для екземпляра GitLab Self-Managed або GitLab Dedicated чернетку застосунку, призначеного для певного робочого простору. Укажіть ім’я хоста GitLab і облікові дані застосунку OAuth, перевірте чернетку застосунку, а потім опублікуйте її для відповідних учасників робочого простору. Після публікації ввімкнені дії застосунку будуть доступні в розмовах ChatGPT і сеансах Codex.
Огляд підтримуваних функцій GitLab, доступності, дозволів, використання даних і вимог до мережі див. тут: Підключення GitLab до ChatGPT і Codex.
Що ви налаштовуєте
Ви створюєте застосунок для певного робочого простору із шаблону застосунку GitLab Self-Managed. Застосунок використовує:
Застосунок GitLab OAuth, зареєстрований на вашому хості GitLab Self-Managed або GitLab Dedicated.
Ідентифікатор застосунку й секрет GitLab OAuth для авторизації користувачів.
Необхідні області доступу OAuth: api, write_repository і openid.
Ім’я хоста GitLab, наприклад gitlab.example.com, для визначення кінцевих точок вебсайту, API, авторизації та токенів.
Перш ніж почати
Вам потрібні:
Права адміністратора або власника робочого простору ChatGPT.
Дозвіл GitLab на створення застосунку OAuth: доступ власника групи для застосунку групи або доступ адміністратора екземпляра для застосунку на рівні всього екземпляра.
Лише ім’я хоста GitLab — без https://, порту чи шляху. Використовуйте хост GitLab Self-Managed або GitLab Dedicated, а не gitlab.com.
Визначте, які дії GitLab мають підтримувати ChatGPT і Codex, як-от пошук у репозиторіях, робота із запитами на злиття й задачами, редагування файлів або ширші робочі процеси Codex.
Тримайте ChatGPT і GitLab відкритими в окремих вкладках. Скопіюйте точний URI переспрямування, указаний у ChatGPT; не створюйте й не змінюйте його.
Дані, які потрібно підготувати
Ім’я хоста GitLab: наприклад, gitlab.example.com.
URI переспрямування: скопіюйте його під час налаштування шаблону в ChatGPT.
Ідентифікатор застосунку GitLab OAuth.
Секрет GitLab OAuth.
Області доступу OAuth: скопіюйте їх під час налаштування шаблону в ChatGPT.
Start the template setup in ChatGPT
In ChatGPT, switch to the workspace where the app should be available.
Go to Workspace settings > Plugins.
In Directory, find GitLab, open its GitLab Self-Managed app template, and select Enable.
Enter a clear app name and description.
Enter the GitLab hostname, such as gitlab.example.com.
Copy the Redirect URI shown in ChatGPT, and keep this tab open.
Example: https://chatgpt.com/connector/oauth/<redirect_id>. Do not remove the redirect ID, add a trailing slash, or replace the URI with a generic ChatGPT URL.
Створення застосунку GitLab OAuth у GitLab
Вибір місця створення застосунку
Відкрийте свій хост GitLab, наприклад https://gitlab.example.com.
Виберіть, де створити застосунок: на рівні всього екземпляра чи для певної групи. Цей вибір визначає, хто керуватиме застосунком. Доступ до проєктів і надалі залежатиме від дозволів користувача GitLab, який надає авторизацію, та наданих областей доступу OAuth.
Щоб створити застосунок на рівні всього екземпляра, перейдіть до розділу Адміністрування > Застосунки. Щоб створити застосунок групи, перейдіть у цій групі до розділу Налаштування > Застосунки.
Додавання відомостей про застосунок
Виберіть Новий застосунок або Додати новий застосунок.
Введіть зрозумілу назву застосунку, наприклад GitLab Self-Managed або GitLab Dedicated.
У полі URI переспрямування вставте точний URI, скопійований із ChatGPT.
Не вимикайте параметр Конфіденційний для цього серверного застосунку OAuth.
Налаштування доступу та збереження
Для застосунку на рівні всього екземпляра GitLab рекомендує вибрати параметр Довірений. Завдяки цьому запит на авторизацію користувача буде пропущено.
Виберіть області доступу api, write_repository і openid.
Перевірте, хто може керувати застосунком, і переконайтеся, що користувачі GitLab, які надають авторизацію, мають належні дозволи для груп і проєктів.
Збережіть застосунок.
Вимоги до областей доступу OAuth
Шаблон запитує наведені нижче області доступу OAuth для ввімкнених дій GitLab у ChatGPT і Codex:
api: потрібна для доступних через застосунок операцій GitLab API, зокрема дій із запитами на злиття, задачами та CI/CD.
write_repository: потрібна для операцій запису в репозиторій через Git.
openid: потрібна для отримання даних OpenID Connect про посвідчення та членство.
Копіювання облікових даних GitLab OAuth
У збереженому застосунку GitLab скопіюйте ідентифікатор застосунку й секрет. Зберігайте секрет як конфіденційні облікові дані. Якщо його розкрито, оновіть його в GitLab і створіть новий застосунок робочого простору.
Завершення налаштування в ChatGPT
Поверніться на вкладку налаштування шаблону ChatGPT.
Вставте ідентифікатор застосунку GitLab у поле Ідентифікатор клієнта OAuth.
Вставте секрет GitLab у поле Секрет клієнта OAuth.
Переконайтеся, що в полі імені хоста GitLab указано лише ім’я хоста, наприклад gitlab.example.com.
Виберіть Створити чернетку.
Відкрийте відомості про чернетку застосунку та перевірте параметри «Доступ ролей» і «Налаштувати дії».
Публікація та керування застосунком для ChatGPT і Codex
Після створення чернетка застосунку не стає автоматично доступною учасникам. Після перевірки чернетки:
Виберіть Опублікувати для чернетки застосунку.
Перейдіть до розділу Налаштування робочого простору > Плагіни й переконайтеся, що GitLab доступний потрібним ролям.
Перевірте доступ ролей, які мають використовувати застосунок.
У розділі Налаштувати дії перевірте доступні дії читання й запису.
У розділі Налаштувати схвалення визначте, коли користувачі мають схвалювати дію, перш ніж ChatGPT або Codex виконає її через застосунок.
Попросіть тестового користувача з доступом відкрити GitLab у Каталозі плагінів або в розділі Налаштування > Плагіни. Переконайтеся, що користувач може встановити плагін і підключитися до застосунку, створеного із шаблону GitLab Self-Managed.
Ці налаштування схвалення застосунку діють у розмовах ChatGPT і гілках Codex.
Налаштування активності GitLab для перевірки коду в Codex
Після публікації застосунку налаштуйте активність GitLab у Codex, якщо плануєте перевіряти код за допомогою Codex. Під час налаштування цієї активності буде налаштовано необхідні події вебхуків.
Відкрийте налаштування конекторів Codex.
Налаштуйте обліковий запис служби робочого простору. Дозвольте Codex створити обліковий запис або надайте персональний токен доступу для наявного облікового запису служби.
Увімкніть активність GitLab для проєкту або однієї з його батьківських груп.
Якщо Codex має виконувати завдання з програмування або використовувати налаштування певного проєкту, створіть середовище проєкту.
Застосунок GitLab використовує користувацький OAuth для читання та ввімкнених дій у ChatGPT і Codex. Для запису результатів перевірки Codex у GitLab Self-Managed або GitLab Dedicated токен облікового запису служби, яким керує робочий простір, визначає посвідчення та проєкти, де Codex може коментувати або реагувати.
Докладніше: Перевірка запитів на злиття GitLab за допомогою Codex.
Підключення й перевірка застосунку GitLab
Як користувач із доступом відкрийте GitLab у Каталозі плагінів або в розділі Налаштування > Плагіни. Виберіть Установити плагін, а потім — Підключити.
Якщо у вашому робочому просторі є кілька застосунків GitLab, виберіть застосунок для цього хоста GitLab Self-Managed або GitLab Dedicated.
Коли з’явиться запит, авторизуйте застосунок GitLab OAuth.
Спочатку виконайте в ChatGPT або Codex невелику дію читання, наприклад перегляньте список доступних проєктів або отримайте відомий запит на злиття.
Якщо дії запису ввімкнено, перед широким упровадженням перевірте їх у проєкті з низьким рівнем ризику та в кожному продукті, де плануєте їх використовувати.
Ім’я хоста й робота OAuth
Застосунок використовує ім’я хоста для визначення кінцевих точок GitLab. Введіть лише хост, наприклад gitlab.example.com. Не додавайте https://, шлях API чи репозиторію, порт або gitlab.com. Цей шаблон призначено для GitLab Self-Managed або GitLab Dedicated. Для GitLab.com (SaaS) використовуйте застосунок GitLab.
Усунення проблем із налаштуванням застосунку GitLab Self-Managed
Невідповідність URI переспрямування: переконайтеся, що URI переспрямування в застосунку GitLab OAuth точно збігається з URI переспрямування, указаним у ChatGPT.
ChatGPT не може створити або зберегти чернетку застосунку: переконайтеся, що вказано ім’я хоста, ідентифікатор застосунку, секрет і URI переспрямування.
Автентифікація успішна, але виклики проєкту не виконуються: переконайтеся, що користувач GitLab, який надає авторизацію, має доступ до проєкту, а застосунок OAuth — області доступу, передбачені шаблоном.
API повертає помилку 403 або повідомляє про недостатні дозволи: переконайтеся, що підключений обліковий запис GitLab має необхідні дозволи для проєкту чи групи, а застосунок OAuth — необхідні області доступу, передбачені шаблоном.
Немає доступних проєктів: переконайтеся, що користувач має доступ до проєкту, підключений до потрібного екземпляра GitLab і вибрав правильний застосунок GitLab у ChatGPT або Codex.