Genel bakış

Bu makale; harici API'lere bağlanma, GPT'nin neler yapabileceğini tanımlama ve kimlik doğrulama, şemalar ve çalışma alanı kısıtlamalarını yönetme dahil olmak üzere bir GPT'de eylemlerin nasıl yapılandırılacağını açıklar.

Bir eylemi yapılandırmak için bağlanmak istediğiniz hizmetin kimlik doğrulama bilgileri ve bir OpenAPI şeması dahil API ayrıntılarına ihtiyacınız vardı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 yapabileceğini tanımlayan bir şema.

Sınırlamalar

Çalışma alanınız hiçbir eylem alan adına izin vermiyorsa, hiçbir eylem alan adı izin verilenler listesi kontrollerinden 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 mutlaka engellendiği anlamına gelmez.

Eylemler Pro modu için kullanılamaz. Özel eylemlere sahip bir GPT oluşturduğunuzda veya düzenlediğinizde, model seçici yalnızca eylemleri destekleyen Pro olmayan modelleri gösterir.

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ğlanacağını denetler.

Mevcut 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çmasını kullanır

API anahtarı

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

• Basic

• Bearer

• Özel üstbilgi

OAuth

Eylemler kullanıcı hesapları gerektirdiğinde OAuth kullanın. OAuth şunları gerektirir:

• İstemci Kimliği ve İstemci Gizli Anahtarı

• Yetkilendirme URL'si ve Token URL'si

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

Düzenleyici, OAuth akışını tamamlamak için bir geri çağırma 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 mevcut olduğunu

• Hangi parametreleri kabul ettiklerini

• Her eylemin nasıl tanımlandığını (işlem kimlikleri)

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

Şema ekleme

Üç şekilde şema ekleyebilirsiniz:

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

• Bir URL'den içe aktarın

• Yerleşik bir örnekten 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 mesajı görürseniz:


“Çalışma alanınızın ayarlarında hiçbir alan adına izin verilmiyor.”

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

• Yöneticiler tüm alan adlarına izin verebilir veya eylemleri onaylanmış alan adlarıyla kısıtlayabilir.

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

Eylemler ve alan adı 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.

• Eylemleri olan 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 bunları onaylamaları istenebilir.

• OAuth eylemleri için kullanıcılar bağlı hesapları inceleyebilir ve yönetebilir.

Ek yardım

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