Çalışma alanı yöneticilerinin, kuruluşlarının kendi GitHub App’ini kullanarak ChatGPT’de GitHub Enterprise uygulama şablonunu nasıl yapılandırabileceğini öğrenin.

Genel bakış

Kuruluşunuz için GitHub Enterprise uygulama şablonunu kuran bir ChatGPT çalışma alanı yöneticisiyseniz bu kılavuzu kullanın. Şablon, üyelerin kullanacağı nihai uygulama değildir. Gerekli GitHub Enterprise yapılandırmasını sağladığınızda çalışma alanına özel bir taslak uygulama oluşturan kurulum akışıdır.

GitHub Enterprise kurulumu, ChatGPT’yi kuruluşunuzun GitHub Enterprise sunucusuna bağlar. Bir GitHub uygulaması oluşturur, ChatGPT geri çağırma URL’sini kaydeder, kimlik bilgilerini oluşturur ve ardından bu değerleri ChatGPT şablon kurulumu akışına yapıştırırsınız. ChatGPT taslak uygulamayı oluşturduktan sonra uygulamayı yayımlayabilir ve diğer çalışma alanı uygulamaları gibi yönetebilirsiniz.

Çalışma alanında gezinme ve uygulama erişimi hakkında bilgi için bkz. Eklentiler ve uygulamalar için yönetici denetimleri, güvenlik ve uyumluluk.

Neyi kuruyorsunuz?

ChatGPT’de çalışma alanına özel bir GitHub Enterprise uygulaması oluşturuyorsunuz. Uygulama şunları kullanır:

GitHub Enterprise sunucunuzda kayıtlı bir GitHub uygulaması.
OAuth ile kullanıcı yetkilendirmesi için GitHub uygulamasının istemci kimliği ve istemci gizli anahtarı.
ChatGPT’nin depo işlemleri için kurulum belirteçleri oluşturmasını sağlayan GitHub uygulaması özel anahtarı.
GitHub Enterprise’ın kurulum ve depo olaylarını ChatGPT’ye göndermesini sağlayan webhook gizli anahtarı ve webhook URL’si.
github.example.com gibi GitHub Enterprise ana makine adınız.

Bağımsız bir GitHub OAuth uygulaması değil, bir GitHub uygulaması oluşturun. ChatGPT şablon kurulumu için GitHub uygulamasının kimlik bilgileri, özel anahtarı ve webhook ayarları gerekir.

Başlamadan önce

Gerekenler:

ChatGPT çalışma alanı yöneticisi veya sahibi erişimi.
GitHub uygulamaları oluşturup kurmaya izin veren GitHub Enterprise yöneticisi veya kuruluş sahibi erişimi.
https:// veya yol içermeyen, yalnızca GitHub Enterprise ana makine adı.
ChatGPT’nin hangi depo eylemlerini destekleyeceğine dair bir karar; örneğin salt okunur depo araması, pull request iş akışları, sorun iş akışları, dosya düzenlemeleri, GitHub Actions veya daha kapsamlı Codex iş akışları.
GitHub uygulamasının özel anahtarını ve istemci gizli anahtarını yönetmek için güvenli bir ortam.

ChatGPT’yi ve GitHub Enterprise’ı ayrı sekmelerde açık tutun. Geri çağırma URL’sini kendiniz oluşturmayın. ChatGPT’de gösterilen geri çağırma URL’sini aynen kopyalayın.

Hazırlanacak değerler

GitHub Enterprise ana makine adı: örneğin github.example.com.
Geri çağırma URL’si: ChatGPT şablon kurulumu akışından kopyalayın.
GitHub uygulamasının istemci kimliği.
GitHub uygulamasının istemci gizli anahtarı.
GitHub uygulamasının PEM biçimindeki özel anahtarı.
ChatGPT’nin oluşturduğu webhook gizli anahtarı.
ChatGPT’de taslak uygulama oluşturulduktan sonra oluşturulan webhook URL’si.

ChatGPT’de şablon kurulumunu başlatın

ChatGPT’de uygulamanın kullanıma sunulacağı çalışma alanına geçin.
Çalışma alanı ayarları > Uygulamalar bölümünü açın. Ayrıca Yönetici Konsolu’na gidip ilgili ChatGPT çalışma alanını seçebilir ve Eklentiler bölümünü açabilirsiniz. Kullanımda tutulan Uygulamalar sayfasını açmak için Eski Uygulamaları Yönet seçeneğini seçin.
Dizin seçeneğini seçin.
GitHub Enterprise’ı arayın.
GitHub Enterprise uygulama şablonunu seçip kurulumu başlatın.
GitHub Enterprise veya GitHub Enterprise - Mühendislik gibi anlaşılır bir uygulama adı ve açıklaması girin.
GitHub Enterprise ana makine adını girin; örneğin github.example.com.
ChatGPT’de gösterilen geri çağırma URL’sini kopyalayın. Bu sekmeyi açık tutun.
Oluşturulan webhook gizli anahtarı kurulum sırasında gösteriliyorsa kopyalayın.

Örnek geri çağırma URL’si: https://chatgpt.com/connector/oauth/<callback_id>

Geri çağırma kimliğini kaldırmayın, URL’nin sonuna eğik çizgi eklemeyin veya URL’yi genel bir ChatGPT URL’siyle değiştirmeyin.

GitHub Enterprise’da GitHub Uygulamasını oluşturun

GitHub Enterprise sunucunuzun adresini açın; örneğin https://github.example.com.
Uygulamanın sahibi olacak kuruluşa veya hesaba gidin.
Ayarlar > Geliştirici ayarları > GitHub Uygulamaları bölümünü açın.
Yeni GitHub Uygulaması seçeneğini seçin.
ChatGPT GitHub Enterprise gibi anlaşılır bir uygulama adı girin.
Bir ana sayfa URL’si girin. Uygulamaya özel bir kurum içi sayfa yoksa GitHub Enterprise kuruluş URL’sini kullanın.
Geri çağırma URL’si alanına, ChatGPT’den kopyaladığınız geri çağırma URL’sini aynen yapıştırın.
Güvenlik ekibinizin bu ayarı değiştirmek için belirli bir gerekçesi yoksa Kullanıcı yetkilendirme belirteçlerinin süresi dolsun seçeneğini etkin bırakın.
Kullanıcıların yükleme veya bağlanma sırasında uygulamayı yetkilendirebilmesi için Yükleme sırasında kullanıcı yetkilendirmesi iste seçeneğini etkinleştirin.
Bu GitHub Uygulaması nereye yüklenebilir? bölümünde, kullanıma sunma planınıza uygun en dar kapsamlı seçeneği seçin.
GitHub Uygulamasını oluşturun.

İzinleri ve olayları yapılandırın

Etkinleştirmeyi planladığınız ChatGPT eylemleri için gereken en düşük izin düzeyini seçin.

Salt okunur depo keşfi ve soru-cevap için aşağıdaki gibi okuma izinleriyle başlayın:

Meta veriler: salt okunur. GitHub, GitHub uygulamaları için meta veri iznini zorunlu tutar.
İçerikler: dosya ve depo içeriğine erişim için salt okunur.
Sorunlar: sorun aramak veya okumak gerekiyorsa salt okunur.
Pull request’ler: pull request aramak veya inceleme bağlamı edinmek gerekiyorsa salt okunur.
Eylemler: iş akışı çalıştırma durumu, işler, günlükler veya çıktılar gerekiyorsa salt okunur.

Yazma işlemi içeren iş akışları için yalnızca gereken alanlara yazma izinleri ekleyin; örneğin İçerikler, Pull request’ler, Sorunlar, Eylemler veya İş Akışları. Amaçlanan ChatGPT eylemlerini destekleyen en dar kapsamlı izinleri kullanın.

Webhook olayları, desteklediğiniz iş akışlarıyla eşleşmelidir. Yaygın olaylar arasında Kurulum, Kurulum depoları, Gönderme, Pull request, Sorunlar, Sorun yorumu, İş akışı çalıştırması ve İş akışı işi bulunur.

GitHub uygulaması kimlik bilgilerini oluşturun ve kopyalayın

GitHub uygulaması ayarlarında İstemci kimliği değerini kopyalayın.
Bir İstemci gizli anahtarı oluşturup hemen kopyalayın.
Özel anahtarlar bölümünde bir özel anahtar oluşturun.
.pem dosyasını indirip güvenli bir yerde saklayın.
.pem dosyasını yerel olarak açın ve başlangıç ve bitiş satırları dahil tüm PEM metnini kopyalayın.

Özel anahtar hassas bilgidir. Kimlik bilgilerinizi koruduğunuz gibi koruyun. Açığa çıkarsa yeni bir özel anahtar oluşturun, ChatGPT uygulama yapılandırmasını güncelleyin ve GitHub Enterprise’da açığa çıkan anahtarı silin.

ChatGPT’de kurulumu tamamlayın

ChatGPT şablon kurulumu sekmesine dönün.
GitHub uygulamasının istemci kimliğini OAuth istemci kimliği alanına yapıştırın.
GitHub uygulamasının istemci gizli anahtarını OAuth istemci gizli anahtarı alanına yapıştırın.
Kuruluşunuzun şablonun varsayılan değerlerini özellikle değiştirmesi gerekmiyorsa Kapsamlar alanını olduğu gibi bırakın.
GitHub Enterprise ana makine adı alanının yalnızca github.example.com gibi bir ana makine adı içerdiğini doğrulayın.
GitHub uygulamasının PEM biçimindeki özel anahtarını GitHub uygulaması özel anahtarı alanına yapıştırın veya yükleyin.
Oluşturulan webhook gizli anahtarının mevcut olduğunu doğrulayın.
Taslak uygulamayı oluşturun.
ChatGPT’de oluşturulan taslak uygulamanın ayrıntılarını açıp oluşturulan webhook URL’sini kopyalayın.

Webhook URL’si şu biçimde olmalıdır: https://connectors.api.openai.org/connectors/<connector_id>/webhook

GitHub Enterprise’da webhook kurulumunu tamamlayın

GitHub Enterprise’daki GitHub uygulaması ayarlarına dönün.
GitHub uygulamasının Genel ayarlarını açın.
Etkin webhook’lar seçeneği henüz etkin değilse etkinleştirin.
ChatGPT webhook URL’sini Webhook URL’si alanına yapıştırın.
ChatGPT webhook gizli anahtarını Webhook gizli anahtarı alanına yapıştırın.
SSL doğrulamasını etkin tutun.
Abone olunan webhook olaylarının etkinleştirdiğiniz izin ve eylemlerle eşleştiğini doğrulayın.
Değişiklikleri kaydedin.

Uygulamayı ChatGPT’de yayınlayın ve yönetin

Taslak uygulamayı oluşturmak, uygulamayı otomatik olarak üyelerin kullanımına sunmaz. Taslağı gözden geçirdikten sonra:

Taslak uygulamayı yayınlayın.
Çalışma alanı ayarlarında Uygulamalar sayfasını, ardından Etkin bölümünü açın ve uygulamanın göründüğünü doğrulayın. Uygulamalar sayfasını, Yönetici Konsolu > Eklentiler bölümündeki Eski Uygulamaları Yönet seçeneğini kullanarak da açabilirsiniz.
Enterprise ve Edu’da, uygulamayı hangi rollerin kullanabileceğini seçmek için Kullanıcı erişimi ayarını kullanın. Business’ta, uygulamanın çalışma alanı genelinde kullanıma açık olup olmayacağını yönetin.
Okuma ve yazma eylemleri için Eylem kontrolü ayarını gözden geçirin.
ChatGPT’nin uygulamayı kullanmadan önce hangi durumlarda üyelerden onay isteyeceğini seçmek için Uygulama izinleri ayarını gözden geçirin.
Erişim izni olan bir test kullanıcısından ChatGPT’de Uygulamalar bölümünü açmasını ve uygulamanın göründüğünü doğrulamasını isteyin.

Bu uygulama izinleri ChatGPT sohbetleri için geçerlidir. Çalışma Alanı Ajanları, hangi uygulama eylemlerinin kullanılabileceğini ve son kullanıcılardan ne zaman onay isteneceğini belirlemek için ajanı oluşturan kişinin her ajan için ayrı ayrı belirlediği kontrolleri kullanır. Ajanların davranışı hakkında bilgi için bkz. Enterprise ve Business için ChatGPT Çalışma Alanı Ajanları.

GitHub uygulamasını kurun ve test edin

GitHub Enterprise’da GitHub uygulamasını kuruluşa veya hesaba yükleyin.
Çalışma alanı politikasına göre tüm depoları veya belirli depoları seçin.
Erişim izni olan bir kullanıcı olarak ChatGPT’den bağlantı akışını başlatın.
İstendiğinde GitHub uygulamasını yetkilendirin.
Önce erişilebilir depoları listelemek veya bilinen bir pull request’i getirmek gibi küçük çaplı bir okuma eylemi çalıştırın.
Yazma eylemleri etkinse daha geniş kapsamda kullanıma sunmadan önce düşük riskli bir depoda test edin.

Ana makine adı ve OAuth davranışı

ChatGPT, GitHub Enterprise uç noktalarını belirlemek için ana makine adını kullanır. Yalnızca ana makine adını girin; örneğin github.example.com veya octocorp.ghe.com.

API yolu veya depo yolu girmeyin. github.com adresini de yalnızca bu uygulamanın GitHub Enterprise sunucusunun adresi tam olarak buysa girin.

Sorun giderme

Yönlendirme URI’si uyuşmuyor: GitHub uygulamasının geri çağırma URL’sinin ChatGPT’de gösterilen geri çağırma URL’siyle birebir eşleştiğini doğrulayın.
ChatGPT taslak uygulamayı oluşturamıyor veya kaydedemiyor: Ana makine adı, OAuth istemci kimliği, OAuth istemci gizli anahtarı, özel anahtar ve webhook gizli anahtarı dahil tüm zorunlu alanların doldurulduğunu doğrulayın.
Kimlik doğrulama başarılı ancak depo çağrıları başarısız oluyor: GitHub uygulamasının kurulu olduğunu ve depoya erişimi olduğunu doğrulayın.
API, 403 veya yetersiz izin hatası döndürüyor: GitHub uygulamasına eksik izni ekleyin ve istenirse kurulum sahibinin güncellenen izinleri onaylamasını sağlayın.
Hiçbir depo görünmüyor: Uygulama kurulumunun beklenen depoları kapsadığını ve ChatGPT’de yetkilendirme yapan kullanıcının bu depolara erişimi olduğunu doğrulayın.
Webhook teslimleri başarısız oluyor: Webhook URL’sinin ve webhook gizli anahtarının ChatGPT’deki değerlerle eşleştiğini doğrulayın, SSL doğrulamasını etkin tutun ve GitHub Enterprise sunucusunun connectors.api.openai.org adresine erişebildiğinden emin olun.
Özel anahtar hataları: Başlangıç ve bitiş satırları dahil tüm PEM içeriğinin kopyalandığını doğrulayın.

ChatGPT’de GitHub Enterprise uygulama şablonunu ayarlama