ChatGPT Belgeleri
Türkçe
İletişim goolvyouyou@gmail.com

Eklenti yönetimi

Çalışma alanı eklentilerini GitHub'dan içe aktarın ve eşitleyin

Başlamadan önce

Çalışma alanı yöneticileri, GitHub'dan bir eklenti pazarını içe aktarabilir ve eklentilerin depodaki sürümlerle güncel kalmasını sağlayabilir. Pazar, içe aktarılacak eklentileri listeleyen bir JSON kataloğudur.

Bu sayfa, çalışma alanına içe aktarma ve eşitleme işlemlerini kapsar. Pazar yerlerini doğrudan yerel istemcilerde buluttan yönetilen veya sistem düzeyindeki config.toml aracılığıyla yapılandırmak için Eklenti pazar yerlerini ve varsayılanları yapılandırma bölümüne bakın. Belirli bir projede eklentileri etkinleştirmek veya devre dışı bırakmak için Bir depoda eklentiyi etkinleştirme veya devre dışı bırakma bölümüne bakın.

Pazar deposunu ve bu deponun başvurduğu diğer tüm depoları okuyabilen bir GitHub hesabı kullanın. Herkese açık ve özel GitHub depoları desteklenir. İçe aktarmadan önce, depo erişiminiz için gereken tüm GitHub kuruluşu onaylarını tamamlayın.

İçe aktarmadan önce depo içeriğini inceleyin. Yeni eklentilerde kurulum politikası Kullanılabilir olarak ayarlanır ve kimlik doğrulama kurulum sırasında yapılır. Yeni pazarlarda günlük otomatik eşitleme etkindir. İçe aktarma işlemi tüm geçerli girdileri işler ve sonraki eşitlemeler depodaki yeni eklentileri otomatik olarak ekler.

Pazar eşitlemesini yapılandırma

  1. Yönetici > Eklentiler bölümünü açın ve Ekle > Pazarı içe aktar seçeneğini belirleyin.
  2. Kaynak alanına https://github.com/example/team-plugins gibi depo URL'sini girin. Dal veya klasör URL'si olmadan yalnızca depo URL'sini kullanın.
  3. Pazar bir alt dizindeyse bu dizini Yol alanına girin. Örneğin, team-tools/.agents/plugins/marketplace.json için team-tools kullanın. Deponun kök dizini için Yol alanını boş bırakın. Manifest dosyasının adını girmeyin.
  4. İsteğe bağlı olarak bir Dal, etiket veya commit girin. Deponun varsayılan dalını kullanmak için bu alanı boş bırakın. Gelecekteki commit'leri almak için bir dal kullanın; sabit bir commit belirtilen revizyonda kalır.
  5. Pazarı içe aktar seçeneğini belirleyin ve istendiğinde GitHub erişimini yetkilendirin. İlk içe aktarma, çok büyük pazarlar için bir saate kadar sürebilir. Sonraki günlük eşitlemeler genellikle birkaç dakika sürer.
  6. İçe aktarma sonuçları bölümünü inceleyin, ardından kurulum politikasını ve gerekli uygulamaları yapılandırmak için içe aktarılan her eklentiyi açın.

Günlük eşitlemeyi beklemeden güncelleme istemek için Yönetici > Eklentiler > Pazarlar altından pazarı açın ve Şimdi eşitle seçeneğini belirleyin.

Desteklenen biçimler

Seçilen dizin şu dosyalardan birini içermelidir:

Dosya Biçim
.agents/plugins/marketplace.json plugins dizisine sahip bir Codex pazarı.
.claude-plugin/marketplace.json plugins dizisine sahip Claude uyumlu bir pazar.
.claude-plugin/plugin.json Pazar manifesti bulunmadığında bağımsız bir Claude eklentisi.

Bir pazardaki girdiler; .codex-plugin/plugin.json ile Codex biçimindeki eklentilere, Claude uyumlu eklentilere, Agent Plugins 1.0 paketlerine veya desteklenen beceri paketlerine başvurabilir.

Codex pazarı için aynı depodaki eklentilerde yerel yollar kullanın:

{
  "name": "team-plugins",
  "interface": {
    "displayName": "Team plugins"
  },
  "plugins": [
    {
      "name": "team-tools",
      "source": {
        "source": "local",
        "path": "./plugins/team-tools"
      }
    }
  ]
}

Yol, .agents/plugins/ konumuna değil, seçilen pazar köküne göredir.

Claude uyumlu bir pazar, her yerel eklenti için bir yol dizesi kullanabilir:

{
  "name": "team-plugins",
  "plugins": [
    {
      "name": "team-tools",
      "source": "./plugins/team-tools"
    }
  ]
}

Codex pazar girdileri ayrıca GitHub deposunun kökündeki bir eklenti için source: "url" ve GitHub alt dizinindeki bir eklenti için source: "git-subdir" öğesini destekler. Örneğin:

{
  "name": "team-tools",
  "source": {
    "source": "git-subdir",
    "url": "https://github.com/example/team-tools.git",
    "path": "./plugins/team-tools",
    "ref": "main"
  }
}

Git kaynakları bir ref veya 40 karakterlik tam bir commit sha seçebilir. Yetkilendirme için kullanılan GitHub hesabı, başvurulan her depoyu okuyabilmelidir. Çalışma alanına içe aktarma şu anda yalnızca GitHub depolarını destekler.

Çalışma alanı erişimini yapılandırma

GitHub'dan içe aktarma ve eşitleme; AVAILABLE, INSTALLED_BY_DEFAULT, NOT_AVAILABLE, ON_INSTALL ve ON_USE dahil olmak üzere deponun kurulum veya kimlik doğrulama politikalarını uygulamaz. Çalışma alanı yöneticileri bu ayarları her eklenti için yapılandırır. Bir güncellemeyi eşitlemek veya mevcut bir eklentiyi GitHub yönetimine taşımak, eklentinin çalışma alanı politikalarını korur.

Uygun her rol için Kullanılabilir veya Yüklü seçeneğini belirlemek üzere Kurulum politikası ayarını kullanın. Gerekli uygulamalar da etkinleştirilmeli ve üyelerin bağlı hizmete erişimi olmalıdır. Bir eklentiyi içe aktarmak, uygulamaya erişim izni vermez veya üyelerin hesaplarını bağlamaz. Rol, uygulama ve eylem denetimleri için Eklenti denetimleri bölümüne bakın.

Mevcut bir eklentiyi GitHub yönetimine taşıma

Mevcut eklentinin pazar girdisine pluginId ekleyin:

{
  "name": "team-tools",
  "pluginId": "plugin_0123456789abcdef0123456789abcdef",
  "source": {
    "source": "local",
    "path": "./plugins/team-tools"
  }
}

Eklentiyi Yönetici > Eklentiler bölümünden açın ve URL'sindeki /admin/plugins/ sonrasında yer alan kimliği kopyalayın. Pazar girdisinde pluginId öğesini name ve source öğelerinin yanına yerleştirin. Mevcut eklenti aynı çalışma alanında bulunmalıdır.

Bu işlem, yüklenmiş veya başka bir şekilde yönetilmeyen bir çalışma alanı eklentisini GitHub yönetimine taşır. Eklenti; kimliğini, paylaşım ayarlarını ve çalışma alanı politikalarını korur. Gelecekteki güncellemeler GitHub'dan gelir; arşiv yüklemeleri artık yönetilen eklentinin yerini alamaz. Başka bir GitHub kaynağı tarafından zaten yönetilen bir eklenti bu yöntemle devralınamaz.

Yalnızca masaüstünde çalışan eklentiler

mcp.json veya .mcp.json içinde MCP server bileşenleri bildiren tüm içe aktarılmış eklentiler Yalnızca masaüstü olarak işaretlenir ve yalnızca ChatGPT masaüstü uygulamasında çalışır. Buna uzak bir HTTPS URL'si kullanan sunucular da dahildir. Aynı kısıtlama, satır içi sunucu bildirimleri gibi desteklenen diğer MCP yapılandırma biçimleri için de geçerlidir.

Mevcut bir uygulamaya .app.json ile başvurma

Eklenti köküne .app.json ekleyin. Dosya adı başında bir nokta içerir; noktasız app.json desteklenmez.

{
  "apps": {
    "team-tools": {
      "id": "asdk_app_example",
      "required": true
    }
  }
}

asdk_app_example öğesini mevcut uygulamanın kimliğiyle değiştirin. Desteklenen uygulama kimlikleri asdk_app_, connector_ veya templated_apps_ ile başlar. Bir plugin_... kimliği yerine uygulama kimliğini kullanın. Örneğin, plugin_asdk_app_example içeren bir eklenti URL'si asdk_app_example uygulamasını temsil eder.

team-tools anahtarı, bu dosya içindeki başvuruyu adlandırır. Eklenti uygulamaya bağımlıysa required değerini true olarak ayarlayın. Mevcut diğer uygulamalara başvurmak için daha fazla girdi ekleyebilirsiniz.

Codex biçimindeki bir eklenti için .codex-plugin/plugin.json içinde apps değerini ./.app.json olarak ayarlayın. Bu örneğin eksiksiz manifesti şöyledir:

{
  "name": "team-tools",
  "version": "1.0.0",
  "description": "Use the team's approved tools.",
  "author": {
    "name": "Example team"
  },
  "apps": "./.app.json",
  "interface": {
    "displayName": "Team tools",
    "shortDescription": "Use approved team tools",
    "longDescription": "Connect to the team's existing app.",
    "developerName": "Example team",
    "category": "Productivity",
    "capabilities": ["Read"]
  }
}

Dosyaları şu düzende tutun:

team-plugins/
├── .agents/plugins/marketplace.json
└── plugins/team-tools/
    ├── .codex-plugin/plugin.json
    └── .app.json

Başvuru, bir uygulama oluşturmaz veya izin vermez. Yöneticiler uygulamayı hedeflenen rollerin kullanımına sunmalı, üyeler de gerekli tüm kimlik doğrulama işlemlerini tamamlamalıdır. Mevcut uygulama izinleri, eylem denetimleri ve hizmet erişimi geçerliliğini korur.

Eklentileri güncel tutma

Yeni pazarlar güncellemeleri her gün denetler. Yönetici > Eklentiler > Pazarlar bölümünü açın, pazarı seçin ve otomatik eşitlemeyi beklemeden güncelleme istemek için Şimdi eşitle seçeneğini belirleyin.

Eşitleme, yeni pazar girdileri ekleyebilir ve mevcut eklentileri güncelleyebilir. Otomatik eşitleme tüm yeni eklentileri içe aktaracağından, depodaki değişiklikleri birleştirmeden önce inceleyin.

Eşitlemeden sonra durumu ve kaydedilen raporu inceleyin. Tamamlandı — N hata ifadesi, işlemin tamamlandığı ancak bazı eklentilerin işlenemediği anlamına gelir. Mevcut bir eklentinin güncellemesi geçersizse son çalışan sürümü korunur. Bildirilen sorunu GitHub'da düzeltin, ardından yeniden denemek için Şimdi eşitle seçeneğini belirleyin.

Bir girdiyi depodan kaldırmak, içe aktarılmış çalışma alanı kopyasını silmez. Bu kopya Artık kaynakta yok olarak işaretlenir. ChatGPT'de pazarı silmek, bu pazardan içe aktarılan tüm eklentileri siler.

GitHub erişimini yeniden bağlama veya değiştirme

GitHub erişimini yeniden bağlamak için önce içe aktarmada kullanılan GitHub hesabının depoya ve başvurulan tüm depolara hâlâ erişebildiğini doğrulayın. Ardından, pazar eşitlemesi bu yöneticinin GitHub bağlantısını kullandığından, pazarı ilk içe aktaran yönetici ChatGPT'deki GitHub eklentisini açıp hesabını yeniden bağlamalıdır.

Yeni bir sahibe devretmek için yeni çalışma alanı yöneticisi Yönetici > Eklentiler > Ekle > Pazarı içe aktar bölümünü açmalı ve aynı Kaynak, Yol ve Dal, etiket veya commit değerlerini kullanarak aynı pazarı içe aktarmalıdır. Gelecekteki eşitlemeler bu yöneticinin GitHub bağlantısını kullanır.

Pazarı yalnızca yeniden bağlamak veya sahipliği değiştirmek amacıyla silmeyin: Silme işlemi, pazardan içe aktarılan eklentileri de kaldırır.