Интеграцията на GitLab с ChatGPT и Codex в момента е в бета-версия.
Общ преглед
Използвайте шаблона за приложение GitLab Self-Managed, за да създадете чернова на приложение за конкретно работно пространство, свързано с инсталация на GitLab Self-Managed или GitLab Dedicated. Посочете името на хоста на GitLab и идентификационните данни на OAuth приложението, прегледайте черновата на приложението и го публикувайте за членовете на работното пространство с необходимите права. След публикуването активираните действия на приложението са достъпни в разговорите в ChatGPT и сесиите в Codex.
За общ преглед на поддържаните функции на GitLab, достъпността, разрешенията, използването на данни и мрежовите изисквания вижте: Свързване на GitLab с ChatGPT и Codex.
Какво настройвате
Създавате приложение за конкретно работно пространство от шаблона за приложение GitLab Self-Managed. Приложението използва:
OAuth приложение за GitLab, регистрирано на вашия хост с 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; не го създавайте сами и не го променяйте.
За да отворите страницата Приложения от Администраторската конзола, изберете желаното работно пространство в 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 > Apps.
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.
Създайте OAuth приложението за GitLab в 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: необходим за операциите с API на GitLab, предоставяни от приложението, включително действия със заявки за сливане, задачи и CI/CD.
write_repository: необходим за операции за запис в хранилището чрез Git.
openid: необходим за информацията за самоличност и членство чрез OpenID Connect.
Копирайте идентификационните данни за GitLab OAuth
В запазеното приложение в GitLab копирайте Идентификатор на приложението и Таен ключ. Пазете Тайния ключ като идентификационни данни. Ако бъде разкрит, подновете го в GitLab и създайте ново приложение за работното пространство.
Завършете настройката в ChatGPT
Върнете се в раздела за настройка на шаблона в ChatGPT.
Поставете Идентификатор на приложението от GitLab в полето Идентификатор на OAuth клиента.
Поставете Таен ключ от GitLab в полето Таен ключ на OAuth клиента.
Уверете се, че полето за име на хоста на GitLab съдържа само името на хоста, например gitlab.example.com.
Изберете Създаване на чернова.
Отворете подробностите за черновата на приложението и прегледайте „Достъп по роли“ и „Конфигуриране на действия“.
Публикувайте и управлявайте приложението за ChatGPT и Codex
Създаването на чернова на приложението не го прави автоматично достъпно за членовете. След като прегледате черновата:
Изберете Публикуване за черновата на приложението.
Отидете в Администраторската конзола, изберете желаното работно пространство в ChatGPT и отворете Плъгини, след което се уверете, че 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.
Упълномощете OAuth приложението за GitLab, когато бъдете подканени.
Първо изпълнете малко по обхват действие за четене в 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 за пренасочване на OAuth приложението в GitLab съвпада точно с URI за пренасочване, показан в ChatGPT.
ChatGPT не може да създаде или запази черновата на приложението: Уверете се, че са попълнени името на хоста, идентификаторът на приложението, тайният ключ и URI за пренасочване.
Удостоверяването е успешно, но заявките към проекта са неуспешни: Уверете се, че потребителят на GitLab, който упълномощава приложението, има достъп до проекта и че OAuth приложението има обхватите, изисквани от шаблона.
API връща 403 или грешка за недостатъчни разрешения: Уверете се, че свързаният акаунт в GitLab има необходимите разрешения за проекта или групата и че OAuth приложението включва обхватите, изисквани от шаблона.
Няма достъпни проекти: Уверете се, че потребителят има достъп до проекти, свързан е с желаната инсталация на GitLab и е избрал правилното приложение GitLab в ChatGPT или Codex.