Cipta pemalam kod rendah untuk digunakan dengan copilot (pratonton)

[Topik ini ialah dokumentasi prapelancaran dan tertakluk pada perubahan.]

Tindakan copilot ialah satu cara untuk memperluaskan keupayaan bot copilot anda. Dengan tindakan AI generatif Copilot, anda mencipta tindakan tersuai yang dicetuskan oleh bot copilot anda. Tindakan ini digunakan untuk melaksanakan pelbagai tugas, seperti menghantar e-mel, mencipta rekod dalam Microsoft Dataverse atau memanggil API luaran. Dalam artikel ini, anda mencipta pemalam kod rendah asas yang menambah dua integer bersama-sama dan pemalam yang lebih kompleks yang boleh digunakan untuk menghantar pemberitahuan yang salah satu daripadanya boleh digunakan untuk mencipta tindakan dalam Microsoft Copilot Studio.

Penting

• Pemalam kod rendah segera dinyahutamakan dan tidak dihantar sebagai ciri. Pemalam kod rendah segera digantikan dengan fungsi. Maklumat lanjut: Fungsi dalam Microsoft Dataverse (pratonton)
• Ini adalah ciri pratonton.
• Ciri pratonton bukan untuk kegunaan pengeluaran dan kefungsian mungkin terbatas. Ciri ini tersedia sebelum keluaran rasmi agar pelanggan boleh mendapat akses awal dan memberikan maklum balas.

Prasyarat untuk menggunakan pemalam dengan Microsoft Copilot

Sebelum anda memulakan, pastikan anda mempunyai prasyarat berikut:

• Akses kepada persekitaran Dataverse yang termasuk Apl Pemecut Dataverse untuk mencipta pemalam kod rendah.
• Akses kepada Copilot Studio dalam persekitaran yang sama dengan persekitaran Dataverse anda.

Contoh pemalam kod rendah asas

Dalam contoh ini, anda mencipta pemalam segera kod rendah yang menambah dua nombor dan mengembalikan jumlah nombor tersebut. Anda kemudian mencipta tindakan Copilot yang memanggil pemalam kod rendah ini untuk melakukan penambahan. Copilot yang anda cipta berfungsi untuk nombor dan pertanyaan teks sewenang-wenangnya yang mengandungi nombor dan pecahan yang dieja.

Untuk mencipta pemalam segera kod rendah asas anda, ikut langkah berikut:

1. Buka Apl Pemecut Dataverse dalam persekitaran Dataverse anda dengan pergi ke AplSemua> Apl >Pemecut Dataverse dan pilih Main.

2. Daripada Apl Pemecut Dataverse, pilih Pemalam baharu dan pilih Pemalam segera.

3. Masukkan nama paparan deskriptif untuk pemalam anda. Contohnya Jumlah nombor, dan kemudian pilih Cipta.

4. Dalam bahagian Parameter :

   • Tambah parameter input berikut:
     • Nama Parameter: Nombor1, Jenis: Apungan
     • Nama Parameter: Nombor2, Jenis: Apungan
   • Tambah parameter output berikut:
     • Nama Parameter: Hasil, Jenis: Terapung

5. Dalam bahagian Ungkapan , masukkan kod berikut:

   {Result: Number1 + Number2}
   

   

6. Pilih Simpan untuk menyimpan pemalam anda.

Buat copilot untuk memanggil pemalam kod rendah asas anda

Pergi ke Copilot Studio, dan buka persekitaran yang mempunyai pemalam.

1. Buat juruterbang. Maklumat lanjut: Buat dan konfigurasikan pemalam copilot
2. Dayakan tindakan generatif pada copilot. Maklumat lanjut: Dayakan tindakan generatif
3. Tambah tindakan AI generatif. Apabila anda menambah tindakan, cari 'Lakukan tindakan tidak terikat dalam persekitaran yang dipilih' dan pilih tindakan. Maklumat lanjut: Gunakan Tindakan Generatif dalam Microsoft Copilot Studio
4. Konfigurasikan tindakan dengan butiran berikut:
   • Tambah perihalan model yang memberitahu juruterbang bila hendak memanggil tindakan ini. Gunakan bahasa Inggeris biasa untuk menerangkan keadaan di mana tindakan ini harus dipanggil. Sebagai contoh, anda boleh memasukkan "Menambah nombor dan mengembalikan jumlah nombor tersebut yang diberikan 2 nilai titik terapung." Maklumat lanjut: Perihalan pengarang
   • Gunakan Input ini:
     • Tukar Bagaimanakah juruterbang akan mengisi input ini untuk parameter Organisasi untuk Tetapkan sebagai nilai.
     • Pilih persekitaran semasa anda (persekitaran di mana anda mencipta pemalam kod rendah anda) sebagai nilai untuk parameter Organisasi .
     • Tukar Bagaimanakah juruterbang akan mengisi input ini untuk parameter Nama Tindakan untuk Tetapkan sebagai nilai.
     • Pilih pemalam kod rendah yang anda cipta sebagai nilai untuk parameter Nama Tindakan . Jika anda tidak pasti apakah nama pemalam anda, anda boleh menemuinya dalam Apl Pemecut Dataverse dengan memilihnya daripada senarai dan memilih Salin coretan kod dan kemudian menampal kod ke dalam editor teks.
   • Input Tambahan:
     • Tambah dan parameter input berikut. Menambah input tambahan pada masa ini tidak menunjukkan butiran dalam Copilot Studio. Anda boleh mengesahkan bahawa input telah ditambah dengan betul dengan memilih Buka edit kod dan menyemak kod, yang sepatutnya menunjukkan input tambahan di bawah bahagian input dalam tindakan YAML:
       • Nama Parameter: Nombor1
       • Nama Parameter: Nombor2
5. Simpan dan terbitkan copilot.

Uji tindakan juruterbang anda

Ikut langkah ini dalam anak tetingkap Uji copilot dalam Copilot Studio.

1. Pilih ikon berkilauan di bahagian atas tetingkap sembang untuk memulakan mod pengesanan. Ini membolehkan anda mengesahkan bahawa tindakan anda sedang dipanggil dan mengesahkan input dan output tindakan anda. Maklumat lanjut: Menguji juruterbang anda menggunakan tindakan generatif
2. Masukkan teks dalam tetingkap sembang Tambah 5.2 dan 10.3 dan pilih Hantar.

Jika semuanya dikonfigurasikan dengan betul, anda melihat hasil yang dijangkakan daripada output 15.5 dalam tetingkap sembang dan anak tetingkap jejak menunjukkan input dan output tindakan anda. Anak tetingkap surih kelihatan serupa dengan contoh berikut. Anda boleh mencuba beberapa gesaan lain untuk menguji tindakan lebih lanjut dan menukar bahasa untuk melihat cara tindakan bertindak balas. Beberapa contoh:

• Jika saya mempunyai 3 epal dan rakan saya memberi saya 4 lagi, berapa banyak epal yang saya ada secara keseluruhan?
• Jika saya mempunyai 1/2 paun keju dan saya memesan 1/4 paun lagi, berapa banyak keju yang saya ada?

Hantar contoh pemalam kod rendah pemberitahuan

Dalam contoh ini, anda mencipta pemalam segera kod rendah yang membungkus API sedia ada untuk digunakan dengan copilot. Tindakan menghantar pemberitahuan kepada pengguna yang ditentukan dalam tindakan copilot apabila pengguna yang mencipta tindakan mengujinya dalam Copilot Studio. Copilot menentukan parameter yang diperlukan daripada pertanyaan bahasa biasa daripada pengguna dan menghantar pemberitahuan menggunakan pemalam kod rendah Dataverse kepada apl dipacu model dalam Power Apps.

Untuk membuat pemalam segera kod rendah anda, ikut langkah berikut:

1. Buka Apl Pemecut Dataverse dalam persekitaran Dataverse anda dengan pergi ke Apl Semua Apl Pemecut>>Dataverse dan pilih main.

2. Daripada Apl Pemecut Dataverse, pilih Pemalam baharu dan kemudian pilih Pemalam segera.

3. Masukkan nama paparan deskriptif untuk pemalam anda. Contohnya, Hantar pemberitahuan dalam apl kepada pengguna dan pilih Cipta.

4. Dalam bahagian Parameter :

   • Tambah parameter input berikut:
     • Nama Parameter: Nama Pengguna, Jenis: Rentetan
     • Nama Parameter: Tajuk, Jenis: Rentetan
     • Nama Parameter: Badan, Jenis: Rentetan
     • Nama Parameter: Url, Jenis: Rentetan
   • Tambah parameter output berikut:
     • Nama Parameter: Hasil, Jenis: Rentetan

5. Dalam bahagian Ungkapan , masukkan kod berikut. Perhatikan bahawa kami membungkus API sedia ada XSendAppNotification dengan pemalam untuk memberikan keupayaan untuk mencari pengguna mengikut nama. Tingkah laku ini membantu apabila dipanggil daripada copilot, yang hanya boleh memberikan maklumat yang pengguna tahu tentang orang itu dan bukan ID rekod yang lebih esoterik yang dijangkakan oleh API asas:

   XSendAppNotification(Title,
   First(Filter(Users, UserName in 'Full Name')), 
   Body,
   [XCreateUrlAction("Click Here", Url)]
   );
   {Result: "Success"}
   

   

6. Pilih Simpan untuk menyimpan pemalam anda.

Cipta copilot untuk memanggil pemalam kod rendah pemberitahuan hantaran anda

Pergi ke Copilot Studio, dan buka persekitaran yang mempunyai pemalam.

1. Buat juruterbang. Maklumat lanjut: Buat dan konfigurasikan pemalam copilot
2. Dayakan tindakan generatif pada copilot. Maklumat lanjut: Dayakan tindakan generatif
3. Tambah tindakan AI generatif. Apabila anda menambah tindakan, cari 'Lakukan tindakan tidak terikat dalam persekitaran yang dipilih' dan pilih tindakan. Maklumat lanjut: Gunakan Tindakan Generatif dalam Microsoft Copilot Studio
4. Konfigurasikan tindakan dengan butiran berikut:
   • Tambah perihalan model yang memberitahu juruterbang bila hendak memanggil tindakan ini. Gunakan bahasa Inggeris biasa untuk menerangkan keadaan di mana tindakan ini harus dipanggil. Sebagai contoh, anda boleh memasukkan "Memanggil API Dataverse untuk menghantar pemberitahuan kepada pengguna dalam Dataverse untuk mengingatkan atau memaklumkan mereka tentang sesuatu yang penting dengan tajuk, isi dan pilihan pautan untuk butiran lanjut." Maklumat lanjut: Perihalan pengarang
   • Gunakan Input ini:
     • Tukar Bagaimanakah juruterbang akan mengisi input ini untuk parameter Organisasi untuk Tetapkan sebagai nilai.
     • Pilih persekitaran semasa anda daripada senarai juntai bawah (persekitaran di mana anda mencipta pemalam kod rendah anda) sebagai nilai untuk parameter Organisasi . Anda perlu meletakkan kursor anda dalam kotak teks agar senarai persekitaran yang tersedia dipaparkan.
     • Tukar Bagaimanakah juruterbang akan mengisi input ini untuk parameter Nama Tindakan untuk Tetapkan sebagai nilai.
     • Pilih pemalam kod rendah yang anda cipta sebagai nilai untuk parameter Nama Tindakan . Anda perlu meletakkan kursor anda dalam kotak teks agar senarai API yang tersedia dipaparkan. Nilai yang perlu dimasukkan di sini ialah nama skema pemalam kod rendah, seperti org_SendInAppNotificationToUser. Jika anda tidak pasti apakah nama skema pemalam anda, anda boleh menemuinya dalam Apl Pemecut Dataverse dengan memilihnya daripada senarai dan memilih Salin coretan kod dan kemudian menampal kod ke dalam editor teks.
   • Input Tambahan:
     • Pilih Tambah dan tambah parameter input berikut. Perhatikan bahawa menambah input tambahan pada masa ini tidak menunjukkan butiran dalam Copilot Studio. Ini isu yang diketahui. Anda boleh mengesahkan bahawa input telah ditambah dengan betul dengan memilih Buka edit kod dan menyemak kod, yang sepatutnya menunjukkan input tambahan di bawah bahagian input dalam tindakan YAML:
       • Nama Parameter: UserName
       • Nama Parameter: Tajuk
       • Nama Parameter: Badan
       • Nama Parameter: Url
5. Simpan dan terbitkan copilot.

Uji tindakan juruterbang hantar pemberitahuan anda

Ikut langkah ini dalam anak tetingkap Uji copilot dalam Copilot Studio.

1. Pilih ikon berkilauan di bahagian atas tetingkap sembang untuk memulakan mod pengesanan. Ini membolehkan anda mengesahkan bahawa tindakan anda sedang dipanggil dan mengesahkan input dan output tindakan anda. Maklumat lanjut: Menguji juruterbang anda menggunakan tindakan generatif
2. Masukkan teks dalam tetingkap sembang Hantar pemberitahuan kepada pengguna saya untuk menyemak url https://copilotstudio.microsoft.comini , dan kemudian pilih Hantar.

Jika semuanya dikonfigurasikan dengan betul, anda melihat bahawa pemberitahuan telah dihantar dalam anak tetingkap copilot uji . Pemberitahuan dihantar sebagai pemberitahuan dalam apl dipacu model apabila pengguna yang ditentukan memainkan apl.

Anda boleh mencuba beberapa gesaan lain untuk menguji tindakan lebih lanjut dan anda boleh menukar pemalam untuk menjadi lebih bijak tentang cara ia mencari pengguna yang diberi nama untuk melihat bagaimana tindakan itu bertindak balas. Contohnya, anda boleh menambah langkah untuk mencari pengguna mengikut alamat e-mel jika nama tidak mengembalikan hasil.

Lihat juga

Gunakan pemalam kod rendah dalam Dataverse