Интеграцията на 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.
ИД на приложението и тайната за OAuth в GitLab за упълномощаване на потребителите.
Необходимите обхвати на 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.
ИД на приложението за OAuth в GitLab.
Тайна за OAuth в GitLab.
Обхвати на 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.
Създаване на 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.
Копирайте идентификационните данни за OAuth в GitLab
В запазеното приложение в 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.
Когато бъдете подканени, упълномощете 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 съвпада точно с показания в ChatGPT.
ChatGPT не може да създаде или запази черновата на приложението: Уверете се, че са въведени името на хоста, ИД на приложението, тайната и URI за пренасочване.
Удостоверяването е успешно, но заявките към проекта са неуспешни: Уверете се, че упълномощаващият потребител на GitLab има достъп до проекта и че OAuth приложението разполага с обхватите от шаблона.
API връща 403 или съобщение за недостатъчни разрешения: Уверете се, че свързаният акаунт в GitLab има необходимите разрешения за проекта или групата и че OAuth приложението включва необходимите обхвати от шаблона.
Няма достъпни проекти: Уверете се, че потребителят има достъп до проекта, свързан е с правилната инстанция на GitLab и е избрал правилното приложение GitLab в ChatGPT или Codex.