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
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.
URL kutusuna, çağırmak istediğiniz API uç noktasının URL'sini girin.
Açılır menüden uygun istek Yöntemini seçin. GET, POST, PATCH, PUT ve DELETE yöntemleri desteklenmektedir.
Düğümde Başlıklar ve gövde altında, HTTP istek özellikleri bölmesini açan Düzenle düğmesini seçin.
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.
Varsayılan olarak, HTTP isteğinin gövdesine içerik gönderilmez, ancak gövdede içerik belirtebilirsiniz.
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.
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
Düğümde Başlıklar ve gövde altında, HTTP istek özellikleri bölmesini açan Düzenle düğmesini seçin.
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 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:
Düğümde Başlıklar ve gövde altında, HTTP istek özellikleri bölmesini açan Düzenle düğmesini seçin.
Hata işleme açılır menüsünden istediğiniz davranışı seçin.
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.
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.