Ç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 ayarlayan bir ChatGPT çalışma alanı yöneticisiyseniz bu kılavuzu kullanın. Şablon, üyelerin kullandığı nihai uygulama değildir. Gerekli GitHub Enterprise yapılandırmasını sağladıktan sonra çalışma alanına özel bir taslak uygulama oluşturan bir kurulum akışıdır.

GitHub Enterprise için kurulum, ChatGPT’yi kuruluşunuzun GitHub Enterprise ana makinesine bağlar. Bir GitHub App oluşturur, ChatGPT geri çağırma URL’sini kaydeder, kimlik bilgileri oluşturur ve ardından bu değerleri ChatGPT şablon kurulum akışına yapıştırırsınız. ChatGPT taslak uygulamayı oluşturduktan sonra, bunu yayınlayabilir ve diğer çalışma alanı uygulamaları gibi yönetebilirsiniz.

Ne ayarlıyorsunuz

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

GitHub Enterprise ana makinenizde kayıtlı bir GitHub App.
Kullanıcı OAuth yetkilendirmesi için GitHub App istemci kimliği ve istemci gizli anahtarı.
ChatGPT’nin depo işlemleri için yükleme tokenları oluşturabilmesi amacıyla GitHub App özel anahtarı.
GitHub Enterprise’ın yükleme ve depo etkinliklerini ChatGPT’ye geri gönderebilmesi için bir webhook gizli anahtarı ve webhook URL’si.
github.example.com gibi GitHub Enterprise ana makine adınız.

Bağımsız bir GitHub OAuth App değil, bir GitHub App oluşturun. ChatGPT şablon kurulumu GitHub App kimlik bilgileri, özel anahtar ve webhook ayarları gerektirir.

Başlamadan önce

Şunlara ihtiyacınız var:

ChatGPT çalışma alanı yöneticisi veya sahibi erişimi.
GitHub Apps oluşturup yükleyebilen GitHub Enterprise yöneticisi veya kuruluş sahibi erişimi.
https:// veya yol olmadan, yalnızca GitHub Enterprise ana makine adı.
ChatGPT’nin hangi depo eylemlerini desteklemesi gerektiğine dair bir karar; örneğin salt okunur depo arama, çekme isteği iş akışları, sorun iş akışları, dosya düzenlemeleri, GitHub Actions veya daha geniş Codex iş akışları.
GitHub App özel anahtarını ve istemci gizli anahtarını ele almak için güvenli bir yer.

ChatGPT ve GitHub Enterprise’ı ayrı sekmelerde açık tutun. Geri çağırma URL’si uydurmayın. ChatGPT’de gösterilen tam geri çağırma URL’sini kopyalayın.

Hazırlanacak değerler

GitHub Enterprise ana makine adı: örneğin github.example.com.
Geri çağırma URL’si: bunu ChatGPT şablon kurulum akışından kopyalayın.
GitHub App istemci kimliği.
GitHub App istemci gizli anahtarı.
GitHub App özel anahtar PEM’i.
ChatGPT tarafından oluşturulan webhook gizli anahtarı.
Taslak uygulama ChatGPT’de oluşturulduktan sonra oluşturulan webhook URL’si.

Şablon kurulumunu ChatGPT’de başlatın

ChatGPT’de uygulamanın kullanılabilir olması gereken çalışma alanına geçin.
Çalışma alanı ayarları > Uygulamalar bölümünü açın.
Dizin’i seçin.
GitHub Enterprise’ı arayın.
GitHub Enterprise uygulama şablonunu seçin ve kurulumu başlatın.
GitHub Enterprise veya GitHub Enterprise - Engineering gibi açık bir uygulama adı ve açıklaması girin.
github.example.com gibi GitHub Enterprise ana makine adını girin.
ChatGPT’de gösterilen geri çağırma URL’sini kopyalayın. Bu sekmeyi açık tutun.
Kurulum sırasında gösteriliyorsa oluşturulan webhook gizli anahtarını kopyalayın.

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

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

GitHub Enterprise’da GitHub App’i oluşturun

https://github.example.com gibi GitHub Enterprise ana makinenizi açın.
Uygulamanın sahibi olması gereken kuruluşa veya hesaba gidin.
Ayarlar > Geliştirici ayarları > GitHub Apps bölümünü açın.
Yeni GitHub App’i seçin.
ChatGPT GitHub Enterprise Connector gibi açık bir uygulama adı girin.
Bir ana sayfa URL’si girin. Ayrılmış bir dahili sayfa yoksa GitHub Enterprise kuruluş URL’sini kullanın.
Geri Çağırma URL’si alanına ChatGPT’den kopyalanan tam geri çağırma URL’sini yapıştırın.
Güvenlik ekibinizin değiştirmek için belirli bir nedeni yoksa Kullanıcı yetkilendirme tokenlarının süresini dolacak şekilde ayarla seçeneğini etkin bırakın.
Kullanıcıların yükleme veya bağlanma akışı sırasında uygulamayı yetkilendirebilmesi için Yükleme sırasında kullanıcı yetkilendirmesi iste seçeneğini etkinleştirin.
Bu GitHub App nereye yüklenebilir? bölümünde, kullanıma sunma planınıza uyan en dar seçeneği seçin.
GitHub App’i oluşturun.

İzinleri ve etkinlikleri yapılandırın

Etkinleştirmeyi planladığınız ChatGPT eylemleri için gereken minimum izinleri seçin.

Salt okunur depo keşfi ve Soru-Cevap için şu gibi okuma izinleriyle başlayın:

Meta veriler: salt okunur. GitHub, GitHub Apps için meta veriler gerektirir.
İçerikler: dosya ve depo içeriği erişimi için salt okunur.
Sorunlar: sorun arama veya sorun okuma gerekiyorsa salt okunur.
Çekme istekleri: çekme isteği arama veya inceleme bağlamı gerekiyorsa salt okunur.
Eylemler: iş akışı çalıştırma durumu, işler, günlükler veya yapıtlar gerekiyorsa salt okunur.

Yazma iş akışları için yalnızca gerektiği yerlerde İçerikler, Çekme istekleri, Sorunlar, Eylemler veya İş Akışları gibi yazma izinleri ekleyin. Amaçlanan ChatGPT eylemlerini destekleyen en dar izinleri kullanın.

Webhook etkinlikleri, desteklediğiniz iş akışlarıyla eşleşmelidir. Yaygın etkinlikler arasında Yükleme, Yükleme depoları, Push, Çekme isteği, Sorunlar, Sorun yorumu, İş akışı çalıştırma ve İş akışı işi bulunur.

GitHub App kimlik bilgilerini oluşturun ve kopyalayın

GitHub App ayarlarında İstemci Kimliği’ni kopyalayın.
Bir İstemci gizli anahtarı oluşturun ve hemen kopyalayın.
Özel anahtarlar altında bir özel anahtar oluşturun.
.pem dosyasını indirin ve güvenli şekilde saklayın.
.pem dosyasını yerel olarak açın ve başlangıç ile bitiş satırları dahil tam PEM metnini kopyalayın.

Özel anahtar hassastır. Bunu bir kimlik bilgisi gibi ele alın. Açığa çıkarsa yeni bir özel anahtar oluşturun, ChatGPT uygulama kurulumunu güncelleyin ve ele geçirilen anahtarı GitHub Enterprise’da silin.

Kurulumu ChatGPT’de tamamlayın

ChatGPT şablon kurulum sekmesine dönün.
GitHub App İstemci Kimliği’ni OAuth istemci kimliği alanına yapıştırın.
GitHub App İstemci gizli anahtarını OAuth istemci gizli anahtarı alanına yapıştırın.
Kuruluşunuzun şablon varsayılanlarını bilerek geçersiz kılması gerekmiyorsa Kapsamlar’ı değiştirmeyin.
GitHub Enterprise ana makine adının yalnızca ana makine adı olduğunu doğrulayın; örneğin github.example.com.
GitHub App özel anahtar PEM’ini GitHub App ö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.
Oluşturulan taslak uygulama ayrıntılarını ChatGPT’de açın ve oluşturulan webhook URL’sini kopyalayın.

Webhook URL’si şöyle görünmelidir: https://connectors.api.openai.org/connectors/<connector_id>/webhook

GitHub Enterprise’da webhook kurulumunu tamamlayın

GitHub Enterprise’daki GitHub App ayarlarına dönün.
GitHub App Genel ayarlarını açın.
Zaten etkin değilse Aktif webhook’ları etkinleştirin.
ChatGPT webhook URL’sini Webhook URL 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 bırakın.
Abone olunan webhook etkinliklerinin etkinleştirdiğiniz izinler 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, onu üyeler için otomatik olarak kullanılabilir hale getirmez. Taslağı inceledikten sonra:

Taslak uygulamayı yayınlayın.
Uygulamanın Çalışma alanı ayarları > Uygulamalar > Etkin bölümünde göründüğünü doğrulayın.
Bunu kullanması gereken roller için Kullanıcı erişimi’ni yapılandırın.
Okuma ve yazma eylemleri için Eylem denetimi’ni gözden geçirin.
ChatGPT’nin uygulamayı kullanmadan önce üyelere ne zaman soracağını seçmek için Uygulama izinleri’ni gözden geçirin.
İzin verilen bir test kullanıcısından ChatGPT’deki Uygulamalar’ı açmasını ve uygulamanın göründüğünü doğrulamasını isteyin.

Bu uygulama izinleri ChatGPT konuşmaları için geçerlidir. Çalışma alanı otonom ajanları, hangi uygulama eylemlerinin kullanılabilir olduğunu ve son kullanıcılardan bunları ne zaman onaylamalarının isteneceğini belirlemek için otonom ajanın oluşturucusu tarafından ayarlanan otonom ajan başına denetimleri kullanır. Otonom ajan davranışı için bkz.: Enterprise ve Business için ChatGPT Çalışma Alanı Otonom Ajanları.

GitHub App’i yükleyin 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 seçili depoları seçin.
İzin verilen bir kullanıcı olarak bağlanma akışını ChatGPT’den başlatın.
İstendiğinde GitHub uygulamasını yetkilendirin.
Önce erişilebilir depoları listeleme veya bilinen bir çekme isteğini getirme gibi küçük bir okuma eylemi çalıştırın.
Yazma eylemleri etkinse daha geniş kullanıma sunmadan önce düşük riskli bir depoda test edin.

Ana makine adı ve OAuth davranışı

ChatGPT, GitHub Enterprise uç noktalarını türetmek için ana makine adını kullanır. Yalnızca github.example.com veya octocorp.ghe.com gibi ana makineyi girin.

Bu uygulama için tam GitHub Enterprise ana makinesi değilse API yolu, depo yolu veya github.com girmeyin.

Sorun giderme

Yönlendirme URI’si uyuşmazlığı: GitHub App geri çağırma URL’sinin ChatGPT’de gösterilen geri çağırma URL’siyle tam olarak 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 gerekli alanların mevcut olduğunu doğrulayın.
Kimlik doğrulama başarılı oluyor ancak depo çağrıları başarısız oluyor: GitHub App’in yüklü olduğunu ve depoya erişimi olduğunu doğrulayın.
API 403 döndürüyor veya izinler yetersiz: eksik GitHub App iznini ekleyin ve istenirse yükleme sahibinin güncellenmiş izinleri onaylamasını sağlayın.
Hiç depo görünmüyor: uygulama yüklemesinin beklenen depoları içerdiğini ve ChatGPT’de yetkilendiren kullanıcının bunlara erişimi olduğunu doğrulayın.
Webhook teslimleri başarısız oluyor: webhook URL’sinin ve webhook gizli anahtarının ChatGPT’den alınan değerlerle eşleştiğini doğrulayın, SSL doğrulamasını etkin tutun ve GitHub Enterprise ana makinesinin connectors.api.openai.org adresine erişebildiğinden emin olun.
Özel anahtar hataları: başlangıç ve bitiş satırları dahil tam PEM içeriğinin kopyalandığını doğrulayın.

ChatGPT’de GitHub Enterprise uygulama şablonunu ayarlama