Cipta pemalam kod asas untuk digunakan dengan Copilot (pratonton)

2024-08-05

[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 atau Microsoft Dataverse memanggil API luaran. Dalam artikel ini, anda mencipta pemalam kod asas asas yang menambah dua integer bersama-sama dan pemalam yang lebih kompleks yang boleh digunakan untuk menghantar pemberitahuan yang boleh digunakan untuk mencipta tindakan dalam Microsoft Copilot Studio.

Penting

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 bermula, pastikan anda mempunyai prasyarat berikut:

Akses kepada Dataverse persekitaran yang termasuk Dataverse Aplikasi Pemecut untuk mencipta pemalam kod asas.
Akses ke dalam Copilot Studio persekitaran yang sama dengan persekitaran anda Dataverse .

Contoh pemalam kod asas

Dalam contoh ini, anda mencipta pemalam segera kod asas yang menambah dua nombor dan mengembalikan jumlah nombor tersebut. Anda kemudian mencipta tindakan Copilot yang memanggil pemalam kod asas ini untuk melaksanakan 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 asas anda, ikut langkah berikut:

Buka Dataverse Apl Pemecut dalam persekitaran anda Dataverse dengan pergi ke Apl Semua > · > Dataverse Apl Pemecut dan pilih Main.
Daripada Dataverse Aplikasi Pemecut, pilih Pemalam baharu dan pilih Pemalam segera.
Masukkan nama paparan deskriptif untuk pemalam anda. Contohnya Jumlah nombor, dan kemudian pilih Cipta .
Dalam bahagian Parameter :
- Tambah parameter input berikut:
  - Nama Parameter: Nombor 1, Jenis ·: Terapung
  - Nama Parameter: Nombor 2, Jenis ·: Terapung
- Tambah parameter output berikut:
  - Nama Parameter: Hasil, Jenis: Terapung
Dalam bahagian Ungkapan, masukkan kod berikut:
```
{Result: Number1 + Number2}
```
Pilih Simpan untuk menyimpan pemalam anda.

Cipta Copilot untuk memanggil pemalam kod asas asas anda

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

Cipta Copilot. Maklumat lanjut: Buat dan konfigurasikan pemalam Copilot
Dayakan tindakan generatif pada Copilot. Maklumat lanjut: Dayakan tindakan generatif
Tambah tindakan AI generatif. Apabila anda menambah tindakan, cari "Lakukan tindakan tidak terikat dalam persekitaran yang dipilih" dan pilih tindakan tersebut. Maklumat lanjut: Gunakan Tindakan Generatif dalam Microsoft Copilot Studio
Konfigurasikan tindakan dengan butiran berikut:
- Tambahkan perihalan model yang membolehkan Copilot mengetahui masa untuk 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 diberi 2 nilai titik terapung." Maklumat lanjut: Pengarang perihalan
- Gunakan Input ini:
  - Tukar Bagaimana Copilot akan mengisi input ini untuk parameter Organisasi untuk Ditetapkan sebagai nilai.
  - Pilih persekitaran semasa anda (persekitaran di mana anda mencipta pemalam kod asas anda) sebagai nilai untuk parameter Organisasi .
  - Tukar Bagaimana Copilot akan mengisi input ini untuk parameter Nama Tindakan kepada Tetapkan sebagai nilai.
  - Pilih pemalam kod asas yang anda cipta sebagai nilai untuk parameter Nama Tindakan . Jika anda tidak pasti nama pemalam anda, anda boleh menemuinya dalam Dataverse Apl Pemecut dengan memilihnya daripada senarai dan memilih Salin cebisan 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: Nombor 2
Simpan dan terbitkan Copilot.

Uji tindakan Copilot anda

Ikuti langkah-langkah ini dalam anak tetingkap Copilot ujian dalam Copilot Studio.

Pilih ikon kilauan 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 Copilot anda menggunakan tindakan generatif
Masukkan teks dalam tetingkap sembang Tambah 5.2 dan 10.3 dan pilih Hantar .

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

Sekiranya 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 pemberitahuan contoh pemalam kod asas

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

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

Buka Dataverse Apl Pemecut dalam persekitaran anda Dataverse dengan pergi ke Apl Semua > · > Dataverse Apl Pemecut dan pilih main.
Daripada Dataverse Aplikasi Pemecut, pilih Pemalam baharu dan kemudian pilih Pemalam segera.
Masukkan nama paparan deskriptif untuk pemalam anda. Contohnya, Hantar pemberitahuan dalam apl kepada pengguna dan pilih Buat.
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 ·
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 ketahui tentang orang tersebut 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"}
```
Pilih Simpan untuk menyimpan pemalam anda.

Cipta Copilot untuk memanggil pemalam kod asas hantar pemberitahuan anda

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

Cipta Copilot. Maklumat lanjut: Buat dan konfigurasikan pemalam Copilot
Dayakan tindakan generatif pada Copilot. Maklumat lanjut: Dayakan tindakan generatif
Tambah tindakan AI generatif. Apabila anda menambah tindakan, cari "Lakukan tindakan tidak terikat dalam persekitaran yang dipilih" dan pilih tindakan tersebut. Maklumat lanjut: Gunakan Tindakan Generatif dalam Microsoft Copilot Studio
Konfigurasikan tindakan dengan butiran berikut:
- Tambahkan perihalan model yang membolehkan Copilot mengetahui masa untuk memanggil tindakan ini. Gunakan bahasa Inggeris biasa untuk menerangkan keadaan di mana tindakan ini harus dipanggil. Sebagai contoh, anda boleh memasukkan "Memanggil Dataverse API untuk menghantar pemberitahuan kepada pengguna untuk Dataverse mengingatkan atau memaklumkan mereka tentang sesuatu yang penting dengan tajuk, isi dan pautan pilihan untuk butiran lanjut." Maklumat lanjut: Pengarang perihalan
- Gunakan Input ini:
  - Tukar Bagaimana Copilot akan mengisi input ini untuk parameter Organisasi untuk Ditetapkan sebagai nilai.
  - Pilih persekitaran semasa anda daripada senarai juntai bawah (persekitaran di mana anda mencipta pemalam kod asas anda) sebagai nilai untuk parameter Organisasi . Anda perlu meletakkan kursor anda dalam kotak teks agar senarai persekitaran yang tersedia dipaparkan.
  - Tukar Bagaimana Copilot akan mengisi input ini untuk parameter Nama Tindakan kepada Tetapkan sebagai nilai.
  - Pilih pemalam kod asas 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 asas, seperti org_SendInAppNotificationToUser. Jika anda tidak pasti nama skema pemalam anda, anda boleh menemuinya dalam Dataverse Apl Pemecut dengan memilihnya daripada senarai dan memilih Salin cebisan 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: Nama Pengguna
    - Nama Parameter:Tajuk ·
    - Nama Parameter: Badan
    - Nama Parameter: Url
Simpan dan terbitkan Copilot.

Uji tindakan Copilot hantar pemberitahuan anda

Ikuti langkah-langkah ini dalam anak tetingkap Copilot ujian dalam Copilot Studio.

Pilih ikon kilauan 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 Copilot anda menggunakan tindakan generatif
Masukkan teks dalam tetingkap sembang Hantar pemberitahuan kepada pengguna saya untuk menyemak url https://copilotstudio.microsoft.com ini, dan kemudian pilih Hantar .

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

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

Lihat juga

Gunakan pemalam kod asas dalam Dataverse

Kongsi melalui