Aracılığıyla paylaş


İsteminizin çıkışını değiştirme (önizleme)

[Bu konu yayın öncesi belgesine dahildir ve değiştirilebilir.]

Varsayılan olarak istem yanıt olarak metin oluşturur. Metin, birçok kullanım durumu için uygun olabilir. Ancak yanıtta, tek tek tanımlanması gereken birkaç öğe varsa, metin seçeneği sınırlandırılabilir.

Önemli

  • Bu, bir önizleme özelliğidir.
  • Önizleme özellikleri, üretimde kullanıma yönelik değildir ve sınırlı işlevselliğe sahip olabilir. Bu özellikler, müşterilerin erken erişim elde etmesi ve geri bildirim sağlaması amacıyla resmi sürümden önce kullanıma sunulur.

JSON çıkışı kullanmanın avantajları

JSON çıkışı, istem yanıtınız için metin yerine JSON yapısı oluşturmanıza olanak sağlar. JSON, Power Automate veya Power Apps'te birden çok öğe bulunan yanıtların daha kolay işlenmesine olanak tanır.

Aşağıda JSON çıkışı ile mümkün olan kullanım durumlarına bir örnek verilmektedir:

  • Proje zamanlaması veya ürün bilgileri gibi yapılandırılmış içeriği görüntüleyin.
  • Faturalar, satın alma siparişi, teslim formları vb. metinlerden verileri ayıklayın.
  • E-postalar veya Dataverse verileri gibi metin kaynaklarından nesne özniteliklerini belirleyin.
  • Bir metinden birden fazla kategori veya duyarlılık alın.

JSON çıkışı ile istem oluşturma

Bu bölümde, çıkış olarak JSON'un nasıl seçileceği ve JSON biçiminin nasıl düzenileceği açıklanmaktadır.

Çıkış olarak JSON seçme

İstem yanıtının işlenme şeklini değiştirmek için aşağıdaki adımları uygulayın:

  1. Panelin sağında İstem ayarları başlığı altında Çıkış>JSON (önizleme) öğesini seçin.

  2. Sol altta, İstem yanıtınızın JSON'da nasıl işlendiğini kontrol etmek için İstemi test et'i seçin.

    'JSON ile İstem' sayfasındaki seçimlerin ekran görüntüsü.

JSON biçimini düzenle

Varsayılan olarak biçim Otomatik olarak algılanır'dır. Bu biçim, isteminizi her test ettiğinizde, istemle ilişkilendirilmiş biçimin test sırasında algılanan biçimle yenilendiği anlamına gelir. İstem yönergelerinizi yinelerken ve yanıt biçiminin nasıl geliştiğini öğrenmek istediğinizde uygundur.

JSON örneğini güncelleştirirseniz biçim Özel olur ve isteminizi bir daha test ederseniz asla güncelleştirilmez. Bu biçim, istem üzerinde düzeltmenin biçimi etkilemesini istemiyorsanız veya belirli bir biçimi izlemeniz gerektiğinde kullanışlıdır.

Otomatik algılamaya dön seçeneğini belirleyerek otomatik algılama moduna geri dönebilirsiniz.

İsteminizi test etmek ve kaydetmek için aşağıdaki adımları uygulayın:

  1. Yeni değiştirilen örneği onaylamak için Uygula'yı seçin.

  2. İstem yanıtınızın yeni biçimle nasıl işlendiğini kontrol etmek için İstemi test et'i seçin.

  3. Değişikliklerinizi tamamladığınızda, özel istemi kaydet'i seçin .

    Bu adımı atlarsanız değişiklikleriniz kaybolur.

    Özel biçimin ekran görüntüsü.

İsteminizi kaydettiğinizde, en son Otomatik algılanan biçimi veya tanımlanan Özel biçimi kilitlersiniz. Bu, isteminizi veya Power Automate içinde Power Appskullandığınızda, kaydedilen biçimin kullanıldığı anlamına gelir - değişmez.

İstediğiniz zaman, </> öğesini seçerek JSON örneklerinden oluşturulan JSON şemasını denetleyebilirsiniz. Şu anda bu şemayı değiştiremezsiniz.

Power Automate'te JSON çıkışı ile istem kullanma

Bir Power Automate akışına GPT ile oluşturulan metin eylemi ekledikten sonra, yanıtı ayrıştırmak için karmaşık mantık eklemeden tüm JSON alanlarını dinamik değerler olarak kullanabilirsiniz.

Aşağıdaki örnekte bu makaledeki JSON çıkışıyla istem oluşturma bölümünde açıklanan istemi kullanarak e-postayla alınan bir faturayı nasıl işleyebileceğiniz gösterilmektedir.

  1. Yeni bir e-posta geldiğinde tetikleyicisiyle bir akış oluşturun.

    Daha fazla bilgi için Tetikleyicileri kullanmaya başlama bölümüne gidin.

  2. Sadece belirli e-postaları işlemeniz gerekiyorsa, filtreleri ayarladığınızdan emin olun.

  3. Eklerin metnini Resimdeki veya PDF belgesşndeki metni tanı eylemiyle ayıklayın.

    Tasarımcıda bir akışın nasıl oluşturulacağı ve değiştirileceği hakkında daha fazla bilgi için Bulut akışları tasarımcısını anlama bölümüne gidin.

  4. Önceki eylem, sayfanın bir tablosunda satır tablosu döndürdüğünde, tüm satırları benzersiz bir değişkende toplamak daha kullanışlıdır.

    Bir değişkeni başlatın ve bu değişkendeki Resim veya PDF belgesindeki metni tanı eyleminden Metin dinamik değerini ekleyin.

    Eklenen OCR metnini gösteren ekran görüntüsü.

  5. Aşağıdaki adımları gerçekleştirerek akışı tamamlayın:

    1. Akışınızda, İstem kullanarak GPT ile metin oluştur'u seçin.
    2. İstem alanının Parametreler sekmesinde, çıkış olarak JSON ile istem'i seçin.
    3. Bilgi istemi girişinde oluşturduğunuz fatura değişkenini ekleyin.

Aşağıdaki yordam, istem kullanarak bir metinden ayıklanan birden çok değeri kolayca ve güvenli bir şekilde kullanmanıza olanak sağlar.

  1. Akışınızda E-posta gönder'i seçin.

  2. Parametreler sekmesinde, JSON çıkışı ile istem tarafından ayıklanan öğeleri içeren bir e-posta gönderin.

    JSON alanları bulunan e-posta gövdesinin ekran görüntüsü.

SSS

JSON oluşturulamadı

Bir istemi test ederken aşağıdaki hatayla karşılaşabilirsiniz: Bir JSON oluşturulamadı. Bilgi istemi talimatınızı düzenleyin ve tekrar deneyin.

Bu hatanın nedeni, modelin JSON çıkışını gerekli JSON biçiminin başarılı bir şekilde doğrulanmasını engelleyen meta veri bilgileriyle çevrelemesi olabilir. Sorunu çözmek için isteminize aşağıdaki talimatı eklemeyi deneyin: Yanıtınıza JSON işaretlemesini dahil etmeyin.

Otomatik algılama modunda JSON döndürülmedi

Otomatik algılama modu etkinleştirildikten sonra İstemi test et seçildiğinde hiçbir JSON döndürülmemesi mümkündür. Bunun nedeni istem yönergelerinin bir JSON'un geri gönderilmesiyle ilgili sistem yönergeleriyle çelişiyor olması olabilir. İstem yönergesi değiştirilip yeniden test edilerek çözülebilir.

JSON biçimi, istem çalışma zamanında güncelleştirilmedi

Otomatik algılama modunda algılanan en yeni JSON biçimi veya özel modda tanımlanan en son JSON biçimi, istem kaydetme sırasında kaydedilir. Bu kaydedilen JSON biçimi, istem çalışma zamanında uygulanır ve isteme yapılan dinamik girişler değiştiğinde bile yanıt biçiminin tutarlılığı sağlanır.

Sınırlamalar

  • Bir JSON şemasını değiştiremezsiniz.
  • Alan anahtarları olmadan JSON biçimi tanımlamayı desteklemiyoruz.
    Örnek: ["abc", "def"] desteklenmez ancak [{"Field1": "abc"}, {"Field1": "def"}] desteklenir.