HTTP istekleri oluşturma

Copilot Studio'da, HTTP İsteği düğümünü kullanarak dış REST API'lerini çağırarak bir aracının özelliklerini genişletebilirsiniz. Dış bir sistemden veri almanız veya sistemdeki verileri değiştirmeniz gerektiğinde bu görüşme yararlı olabilir.

Önkoşullar

• Konuları oluşturma ve düzenleme

HTTP İsteği düğümünü kullanma

1. Düğüm ekle'yi (+) seçin. Gelişmiş alt menüsünü açın ve ardından HTTP isteği gönder'i seçin.

   

2. URL kutusuna, çağırmak istediğiniz API uç noktasının URL'sini girin.

3. Açılır menüden uygun istek Yöntemini seçin. GET, POST, PATCH, PUT ve DELETE yöntemleri desteklenmektedir.

   

4. Düğümdeki Başlıklar ve gövde altında, HTTP İsteği özellikleri panelini açan Düzenle düğmesini seçin.

5. Dilerseniz, HTTP isteğine bir veya daha fazla başlık ekleyebilirsiniz. Her üstbilginin anahtarını ve değerini eklemek için Ekle düğmesini seçin.

   

   Çağırdığınız API için kimlik doğrulama belirteçlerini, içerik türünü veya diğer gerekli üst bilgileri geçirmek için üst bilgiler bölümünü kullanabilirsiniz. Örneğin, isteği kimliğini doğrulamak için Authorization: Bearer <your_token> gibi bir üst bilgi ekleyebilirsiniz.

6. Varsayılan olarak, HTTP isteğinin gövdesine içerik gönderilmez, ancak gövdede içerik belirtebilirsiniz.

7. Düğümde, kullanılabilir seçeneklerden Yanıt veri türü'nü seçin.

   Genellikle aradığınız API'nin belgelerinde bulabileceğiniz bir örnek JSON yanıt verebilirsiniz. Bir Power Fx değişkeni oluşturur ve bu değişkeni, Power Fx düzenleyicide intellisense desteği ile yazarlık tuvalinizde başka bir yerde kullanmanıza olanak sağlar. Örnek Verilerden seçeneğini belirleyin ve ardından Örnek JSON'dan şemayı al seçeneğini belirleyin. Örnek yanıt düzenleyiciye yapıştırın ve Onayla'yı seçin.

8. Kullanıcı yanıtını farklı kaydet'in altında , yeni bir değişken oluşturarak veya var olan bir değişkeni seçerek HTTP isteği yanıtının depolanmasını istediğiniz yeri seçin.

HTTP istek gövdesinde içerik gönderme

1. Düğümdeki Başlıklar ve gövde altında, HTTP İsteği özellikleri panelini açan Düzenle düğmesini seçin.

2. Gövde altında, uygun içerik türünü seçin. Varsayılan olarak Gövde, istek gövdesinde hiçbir içeriğin bulunmaması gereken İçerik Yok olarak ayarlıdır; bu en yaygın olarak GET isteğiyle kullanılır. Gövdeye içerik eklemek için, kullanılabilir seçeneklerden birini belirleyin.

   

   • JSON İçeriği: JSON içeriği, istek gövdesine JSON nesnesi sağlamanıza olanak tanır. Bu nesne genellikle POST veya PUT istekleri yapılırken kullanılır. Bu seçenek belirlendiğinde, bir düzenleyici JSON içeriğinizi girmenizi sağlar.

     Ayrıca dinamik değerleri ve referans değişkenlerini dahil etmenize olanak tanıyan JSON içeriğinizi Power Fx kullanarak da belirleyebilirsiniz. JSON'u Düzenle düğmesini seçin, Formül'ü seçin ve ardından bir Power Fx nesnesi girin (girilen herhangi bir mevcut JSON, sizin için bir Power Fx nesnesine dönüştürülür), HTTP isteği yapıldığında JSON'a dönüştürülür.

     

   • Ham içerik: Ham içerik istek gövdesine bir veri dizesi eklemenize olanak tanır. Bu dize, belirttiğiniz herhangi bir içerik türü olabilir. Ham içerik, aşağıdaki örnekte gösterilen dize içeriği gibi bir Power Fx formülü kullanılarak girilir.

     

Hata işleme ve zaman aşımı

HTTP İsteği düğümü, HTTP isteğinin başarısız olabileceği veya bir hata döndürdüğü durumları işlemek için birden çok seçenek içerir.

Varsayılan olarak, özellik bir hata oluşturur. Bu, bir HTTP isteği bir hata döndürdüğünde veya yürütülemediğinde, aracının işlemini durdurduğu ve Hata Durumunda sistem konusunu tetikleyerek bir hata mesajı görüntülediği anlamına gelir.

Ancak, hata işlemeyi Hata Durumunda sistem konusunu tetiklemeyecek şekilde yapılandırabilirsiniz. Bunun yerine, HTTP durum kodunu ve herhangi bir hata yanıtı gövdesini belirttiğiniz değişkenlerde depolamasını sağlayabilirsiniz. Bu değişkenleri gerektiği gibi sorgulayabilirsiniz ve konu çalışmaya devam edebilir. Bu yapılandırma, belirli bir HTTP isteği başarısız olsa bile aracının çalışmaya devam etmesini istediğiniz senaryolarda kullanışlıdır.

Bir HTTP İsteği düğümünün hata işleme davranışını yapılandırmak için:

1. Başlıklar ve gövde'nin altında, Düzenle'yi seçin. HTTP İsteği özellikleri paneli görüntülenir.

2. Hata işleme'nin altında , istediğiniz davranışı seçin: Hata oluşturma, veya Hata durumunda devam et.

3. Hata durumunda devam et'i seçerseniz, durum kodu ve hata yanıtı gövdesi için değişkenleri yapılandırın.

   

Bu örnekte, HTTP isteği başarısız olursa, aracı HTTP durum kodunu Topic.StatusCode değişkenine, yanıt gövdesini ise Topic.ErrorResponse değişkenine depolar. Aracı, konuyla ilgili sonraki adımlarına devam eder.

Hata yanıtı değişken türü Herhangi biri'dir. Bu değişkeni Power Fx kaydına dönüştürmek için Ayrıştırma değeri düğümünü kullanabilirsiniz.

HTTP İsteği özellikleri panelinde, milisaniye cinsinden bir İstek zaman aşımı özelliği de ayarlayabilirsiniz. Varsayılan değer 30 saniyedir.