Aracılığıyla paylaş


HTTP istekleri oluşturma

Copilot Studio'da, HTTP istek 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

HTTP isteğ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.

    Gelişmiş menüde HTTP isteği gönder seçeneğinin ekran görüntüsü.

  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.

    Tamamlanmış API URL'si ve yöntem açılır menüsünün ekran görüntüsü

  4. Düğümde Başlıklar ve gövde altında, HTTP istek özellikleri bölmesini 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.

    HTTP düğümü için başlıklar anahtar-değer çifti listesinin ekran görüntüsü.

  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üğümde Başlıklar ve gövde altında, HTTP istek özellikleri bölmesini 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.

    Gövde içeriği seçenekleri açılır menüsünün ekran görüntüsü

    • 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.

      Gövde içerik türü için seçilen JSON içeriğinin ekran görüntüsü.

    • 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.

      Gövde içerik türü için seçilen RAW içeriğin ekran görüntüsü.

Hata işleme ve zaman aşımı

HTTP istek 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şkenlere doldurarak bu değişkenleri gerektiği gibi sorgulamanıza ve konunun çalışmaya devam etmesine olanak tanır. 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.

Hata işleme davranışını yapılandırmak için:

  1. Düğümde Başlıklar ve gövde altında, HTTP istek özellikleri bölmesini açan Düzenle düğmesini seçin.

  2. Hata işleme açılır menüsünden istediğiniz davranışı seçin.

  3. Hatada devam et'i seçerseniz, yeni değişkenler oluşturarak veya seçicide bulunan değişkenler arasından seçim yaparak Durum kodu ve Hata yanıtı gövdesi değişkenlerini yapılandırın.

    Durum kodu ve hata yanıtı gövdesi değişkenleri belirtilmiş olarak, hatada devam et seçeneğine yapılandırılmış hata işlemenin ekran görüntüsü.

Bu kod örneğinde, 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.

Özellik bölmesinde ayrıca, milisaniye cinsinden bir değeri kabul eden bir İstek zaman aşımı özelliği de bulunur. Varsayılan değer 30 saniyedir ancak gerekirse bu değeri değiştirebilirsiniz.