Aracılığıyla paylaş

Konularda YAML yazmak ve düzenlemek için kod düzenleyicisini kullanma

Konular, YAML kullanımını destekleyen kod düzenleyicide yazılıp düzenlenebilir. YAML, "YAML İşaretleme Dili Değildir" anlamına gelir. YAML genellikle yapılandırma dosyaları yazmak için kullanılır ve XML veya JSON'dan daha kolay okunur. YAML dosyalarında .yaml veya .yml dosya uzantısı kullanılır. YAML dosyalarını, dizeler, sayılar, Boolean değerleri, listeler ve sözlükler gibi veri yapılarını temsil etmek için boşluk ve girinti ile biçimlendirirsiniz.

Bir konudan kod düzenleyiciye erişmek için araç çubuğunda (...) Daha fazla seçeneğini seçin ve ardından Kod düzenleyiciyi aç seçeneğini seçin.

Kod düzenleyicisinde YAML'nin nasıl kullanılacağına ilişkin genel bakış için bu videoyu izleyin:

Önemli

Herhangi bir oluşturucu, bir konunun yapılandırmasını keşfetmek için kod düzenleyicisini kullanabilir. Geliştiriciler ve ileri düzey kullanıcılar, kod düzenleyicisi içinde tasarım ve düzenleme yapmayı seçebilir. Ancak, kod düzenleyicide revizyon yaparken dikkatli olun. Noktalama veya sözdizimi hataları karmaşık hata mesajlarına yol açabilir veya mevcut konuşmayı bozabilir. Teknik destek ekiplerimiz kod düzenleyici hatalarını düzeltmeye yardımcı olamıyor. YAML'yi revize etmeye yeniysen, herhangi bir değişiklik yapmadan önce konuyu kopyala .

Kod düzenleyicisini kullanırken

Copilot Studio sıfırdan YAML yazmanızı gerektirmez. Bunun yerine, konu tuvalinde nesneler oluşturduğunuzda YAML otomatik olarak oluşturulur. Daha sonra ayarları daha iyi anlamak için kod düzenleyicisinde yapılandırmayı inceleyebilir veya YAML'de değişiklik yapmayı seçebilirsiniz. Kod düzenleyicisi için örnek kullanım örnekleri:

  • Kod düzenleyicisi, konudaki tek tek iletişim kutusu öğeleriyle etkileşime girmeye gerek kalmadan bir konunun tam yapılandırmasını görüntüler. Bir konudaki tüm ayarları görüntülemek için tek durak noktasıdır.
  • Üreticiler, Kopyala ve Yapıştır simgelerini kullanmak yerine, belirli düğümleri bir konudan kopyalayıp diğer konulara yapıştırmayı tercih edebilir. Bu, yapılandırmada birden fazla düğüm seçmekten daha kolay olabilir.
  • Oluşturucular, Arama ve Eylem menüsünde eşitlemeyi beklemek yerine YAML'de Power Automate akış kimliğini güncelleştirmeyi seçebilir.
  • Üreticiler, benzer olduklarında Soru düğümlerini veya İleti düğümlerini klonlamayı ve revize etmeyi seçebilirler. Ancak, bu gibi durumlarda, tüm kimliklerin ve değişkenlerin benzersiz kalmasını sağlamak çok önemlidir. Klonlanan kimlikleri benzersiz kimliklere dönüştürmek için gözden geçirmeyi unutmayın.
  • Yapımcılar, metni YAML koduna daha hızlı yazmak veya kopyalayıp yapıştırmak mümkün olduğu için konu ifadelerine terim eklemek gibi basit düzenlemeler yapmayı tercih edebilir.

Kod düzenleyicisinde YAML'yi anlama

Aşağıdaki görselde tipik bir YAML bloğunun örneği gösterilmektedir.

Kod düzenleyicisinde örnek YAML kodu bloğunun ekran görüntüsü.

Bu kodun tuval'da göründüğü şekliyle ilgili konuya nasıl uygulandığı aşağıda açıklanmıştır.

  • Satır 1: Konu türü.
  • Satırlar 2-3: Konuşmayı güçlendiren bir konunun başlangıcını belirtin.
  • Satır 7: Üretken bir yanıt düğümünü gösterir.
  • Satır 9: İlgili değişken.
  • 11-12. Satırlar: İstek ve özel talimatlarla ilgili detaylar.
  • Satırlar 20-26: Bilgi kaynağı bağlantıları.
  • Satırlar 28-32: Durum grubu. Her koşulun benzersiz bir kimliği vardır, ayrıca koşulun formül detayları ve yönlendirmeleri bulunur.

Kod düzenleyicisinde YAML'yi test etme

Bu kodu test etmek istiyorsanız Copilot Studio'da aşağıdaki adımları tamamlayın:

  1. Bir temsilci oluşturun.

  2. Aracınızın Ayarlar sayfasına gidin, Üretken Yapay Zeka'yı seçin ve Üretken'i tıklayın.

  3. Konular sayfasına gidin, Sistem ve Konuşma yükseltme konusunu seçin.

  4. Kod düzenleyicisini açın.

  5. Mevcut kodu aşağıdaki örnek YAML koduyla değiştirin.

     kind: AdaptiveDialog
 beginDialog:
  kind: OnUnknownIntent
  id: main
  priority: -1
  actions:
    - kind: SearchAndSummarizeContent
      id: search-content
      userInput: =System.Activity.Text
      variable: Topic.Answer
      moderationLevel: Medium
      additionalInstructions: Include emojis to make responses more fun.
      publicDataSource:
        sites:
          - "www.chessusa.com/"
          - "www.chess.com/"
          - "www.lichess.org/"

      sharePointSearchDataSource: {}

    - kind: ConditionGroup
      id: has-answer-conditions
      conditions:
        - id: has-answer
          condition: =!IsBlank(Topic.Answer)
          actions:
            - kind: EndDialog
              id: end-topic
              clearTopicQueue: true

  6. Kaydet'i seçip kod düzenleyicisini kapatın.

  7. Test panelinde, "Bir at nasıl hareket eder?" gibi satrançla ilgili bir soru sorarak aracıyı test edin.

  • Last updated on