Anda dapat menggunakan editor kode untuk menulis dan mengedit YAML dalam topik

Topik dapat ditulis dan diedit di editor kode, yang mendukung penggunaan YAML. YAML adalah singkatan dari "YAML Ain't Markup Language." YAML biasanya digunakan untuk menulis file konfigurasi dan lebih mudah dibaca daripada XML atau JSON. File YAML menggunakan ekstensi file .yaml atau .yml. Anda memformat file YAML dengan spasi dan indentasi untuk merepresentasikan struktur data, seperti string, angka, nilai Boolean, daftar, dan kamus.

Untuk mengakses editor kode dari suatu topik, pilih (…) Selengkapnya di toolbar, lalu pilih Buka editor kode.

Tonton video ini untuk mendapatkan ikhtisar tentang cara menggunakan YAML di editor kode:

Penting

Setiap pembuat dapat menggunakan editor kode untuk menjelajahi konfigurasi topik. Pengembang dan pengguna tingkat lanjut mungkin memilih untuk mendesain dan mengedit dalam editor kode. Namun, berhati-hatilah saat melakukan revisi di editor kode. Kesalahan dalam tanda baca atau sintaks dapat mengakibatkan pesan kesalahan yang rumit atau menghentikan percakapan saat ini. Tim dukungan teknis kami tidak dapat membantu mengatasi kesalahan editor kode. Jika Anda belum berpengalaman dalam merevisi YAML, buat salinan topik sebelum membuat perubahan apa pun.

Saat menggunakan editor kode

Copilot Studio tidak mengharuskan Anda menulis YAML dari awal. Sebagai gantinya, YAML dihasilkan secara otomatis saat Anda membuat objek di kanvas topik. Anda kemudian dapat meninjau konfigurasi di editor kode untuk lebih memahami pengaturan, atau memilih untuk membuat perubahan pada YAML. Berikut adalah contoh kasus penggunaan untuk editor kode:

  • Editor kode menampilkan konfigurasi lengkap terkait topik tanpa perlu berinteraksi dengan elemen dialog individual dalam topik. Ini adalah tempat terpadu untuk menampilkan semua pengaturan dalam suatu topik.
  • Pembuat mungkin memilih untuk menyalin node tertentu dari sebuah topik dan menempelkannya ke topik lain, daripada menggunakan ikon Salin dan Tempel. Ini mungkin lebih mudah daripada memilih beberapa node dalam konfigurasi.
  • Pembuat mungkin memilih untuk memperbarui ID alur Power Automate dalam YAML, alih-alih menunggu sinkronisasi ke menu Panggilan dan Tindakan.
  • Pembuat mungkin memilih untuk mengkloning dan merevisi node Pertanyaan atau node Pesan ketika node tersebut serupa. Namun, dalam kasus seperti itu, sangat penting untuk memastikan bahwa semua ID dan variabel tetap unik. Ingatlah untuk merevisi ID yang dikloning agar menjadi ID yang unik.
  • Pembuat mungkin memilih untuk melakukan revisi sederhana di editor kode, seperti menambahkan istilah ke frasa topik, karena mengetik atau menyalin dan menempel teks ke dalam kode YAML bisa lebih cepat.

Memahami YAML di editor kode

Gambar berikut menunjukkan contoh blok YAML yang umum.

Cuplikan layar contoh blok kode YAML di editor kode.

Berikut cara kode tersebut diterapkan pada topik yang sesuai seperti yang muncul di kanvas.

  • Baris 1: Jenis topik.
  • Baris 2-3: Mengindikasikan dimulainya topik peningkatan percakapan.
  • Baris 7: Menunjukkan node jawaban generatif.
  • Baris 9: Variabel yang relevan.
  • Baris 11-12: Detail tentang perintah dan instruksi khusus.
  • Baris 20-26: Tautan ke sumber pengetahuan.
  • Baris 28-32: Grup kondisi. Setiap kondisi memiliki ID unik, bersama dengan detail rumus dan pengalihan kondisi.

Uji YAML di editor kode

Jika Anda ingin menguji kode ini, ikuti langkah-langkah berikut di Copilot Studio:

  1. Buat agen.

  2. Buka halaman Pengaturan untuk agen Anda, pilih AI Generatif, dan pilih Generatif.

  3. Kunjungi halaman Topik, pilih Sistem, lalu pilih topik Peningkatan percakapan.

  4. Buka editor kode.

  5. Ganti kode yang ada dengan contoh kode YAML berikut.

     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. Pilih Simpan dan tutup editor kode.

  7. Uji agen di panel Uji dengan mengajukan pertanyaan terkait catur, seperti, "Bagaimana kuda bergerak?"

  • Last updated on