Genel bakış

Bu makale, bir GPT'de eylemlerin nasıl yapılandırılacağını; harici API'lere nasıl bağlanılacağını, GPT'nin neler yapabileceğinin nasıl tanımlanacağını ve kimlik doğrulama, şemalar ile çalışma alanı kısıtlamalarının nasıl yönetileceğini açıklar.

Bir eylemi yapılandırmak için, bağlanmak istediğiniz hizmete ait API ayrıntılarına; kimlik doğrulama bilgilerine ve bir OpenAPI şemasına ihtiyacınız olacaktır. Bir GPT, uygulamaları veya eylemleri kullanabilir, ancak ikisini aynı anda kullanamaz.

Her eylem iki ana bileşenle tanımlanır: GPT'nin API ile nasıl kimlik doğruladığı ve API'nin neler yapabildiğini tanımlayan bir şema.

Sınırlamalar

Çalışma alanınız sıfır eylem etki alanına izin veriyorsa, hiçbir eylem etki alanı izin listesi kontrollerini geçemeyeceği için GPT özel eylemleri yürütülemez. Bu, tüm GPT görünürlüğünün veya erişiminin engellendiği anlamına gelmez.

Eylemler Pro modu için kullanılamaz; özel eylemlere sahip bir GPT oluşturmak, içinde seçim için yalnızca Instant ve Thinking modellerinin kullanılabilir olmasına yol açar.

Bir eylem oluşturma

GPT düzenleyicisinde Eylemler bölümüne gidin ve Yeni eylem oluştur'u seçin.

Ardından GPT'nizin harici bir API'ye nasıl bağlanacağını ve onu nasıl kullanacağını yapılandıracaksınız.

Bir eylemi yapılandırdıktan sonra, beklendiği gibi davrandığını doğrulamak için Önizleme'de test edin.

Kimlik doğrulama

Kimlik doğrulama, GPT'nizin harici bir API'ye nasıl bağlandığını kontrol eder.

Kullanılabilir seçenekler:

• Yok: Kimlik doğrulama gerekmez

• API anahtarı: İstekleri yetkilendirmek için gizli bir anahtar kullanır

• OAuth: Hesap tabanlı erişim için kullanıcı oturum açmayı kullanır

API anahtarı

Sunucudan sunucuya erişim için API anahtarı kimlik doğrulamasını kullanın. Şu şekilde yapılandırılabilir:

• Basic

• Bearer

• Özel üst bilgi

OAuth

Eylemler kullanıcı hesapları gerektiriyorsa OAuth kullanın. OAuth şunları gerektirir:

• Client ID ve Client Secret

• Authorization URL ve Token URL

• Scope ve token değişim yöntemi

Düzenleyici, OAuth akışını tamamlamak için bir geri çağrı URL'si sağlar.

Şema

Şema, API'nizin neler yapabileceğini tanımlar. ChatGPT'ye şunları söyler:

• Hangi sunucunun çağrılacağını

• Hangi uç noktaların kullanılabilir olduğunu

• Hangi parametreleri kabul ettiklerini

• Her eylemin nasıl tanımlandığını (operation ID'leri)

Şema, JSON veya YAML biçiminde bir OpenAPI spesifikasyonu olarak sağlanmalıdır.

Şema ekleme

Bir şemayı üç şekilde ekleyebilirsiniz:

• Doğrudan düzenleyiciye yapıştırın

• Bir URL'den içe aktarın

• Yerleşik bir örnekle başlayın:

  • Hava durumu (JSON)

  • Pet Store (YAML)

  • Boş şablon

Şema geçerliyse düzenleyici algılanan eylemleri gösterir. Geçersizse doğrulama hataları görüntülenir.

Çalışma alanı kısıtlamaları (Enterprise ve Edu)

Şu iletiyi görüyorsanız:

“Çalışma alanınızın ayarları tarafından hiçbir etki alanına izin verilmiyor.”

Bu, eylemlerin çalışma alanı ayarlarınız tarafından kısıtlandığı anlamına gelir.

• Yöneticiler tüm etki alanlarına izin verebilir veya eylemleri onaylı etki alanlarıyla sınırlayabilir.

• Hiçbir etki alanına izin verilmiyorsa eylemleri kullanamazsınız.

Eylemler ve etki alanı kısıtlamaları için çalışma alanı düzeyindeki denetimler hakkında bilgi için bkz.: Enterprise ve Edu çalışma alanlarında GPT erişimini yönetme.

Gizlilik ve kullanıcı denetimleri

• Her eylem bir Gizlilik Politikası URL'si içerebilir.

• Eylemlere sahip herkese açık GPT'ler (bağlantı veya GPT Store) geçerli bir gizlilik politikası URL'si içermelidir.

• Kullanıcılardan, eylemler çalıştırılmadan önce onları onaylamaları istenebilir.

• OAuth eylemlerinde kullanıcılar bağlı hesapları inceleyip yönetebilir.

Ek yardım

Eylem yazma veya hata ayıklama konusunda yardım için resmî ActionsGPT'yi kullanın.