Menggunakan penerjemah kode dalam perintah untuk membuat dan menjalankan kode Python

Note

Artikel ini menjelaskan fitur yang digunakan pada agen atau alur agen yang didukung oleh harness standar.

Penerjemah kode di perintah Microsoft Copilot Studio dan pembuat perintah memungkinkan pembuat membangun agen AI yang:

  • Jalankan kode Python untuk analisis data, pemrosesan file Word, Excel, PowerPoint, dan PDF, dan visualisasi
  • Menggunakan model bahasa untuk respons generatif

Fitur ini disesuaikan untuk pengembang, analis bisnis, dan pembuat low-code. Pembuatan kode dan eksekusi terintegrasi dengan mulus dengan ekosistem Copilot Studio untuk menciptakan solusi yang kuat dan berbasis AI.

Pengembang harus membaca Penerjemah kode untuk pengembang dan meninjau sampel komponen Code interpreter Power Apps Component Framework (PCF) untuk memahami bagaimana mereka dapat menggunakan pesan Dataverse Predict untuk memanggil perintah dan memproses respons yang dikembalikan.

Prerequisites

Kemampuan penerjemah kode

Agen yang menggunakan penerjemah kode dapat menulis dan menjalankan kode Python untuk tugas tingkat lanjut. Kasus penggunaan meliputi:

  • Pemrosesan file Excel: Membuat, menyalin, dan memperbarui lembar kerja Excel dalam buku kerja, membaca dan menerapkan gaya sel, menyalin pemformatan antar sel, menyalin dan memperbarui rumus antar sel, dan lainnya.
  • Word dan pemrosesan file PowerPoint.
  • Pemrosesan file PDF: Membuat dan menyalin file PDF, membaca tabel, dan paragraf teks.
  • Pemrosesan data tabel Dataverse.
  • Komputasi matematika dan statistik yang kompleks.
  • Analisis, manipulasi, dan visualisasi data (misalnya, bagan dan grafik).

Interpreter kode menambahkan kemampuan berikut pada prompt:

  • Mendukung file sebagai jenis output dalam perintah.
  • Dukungan untuk file Excel sebagai jenis input dan output untuk permintaan.

Note

Untuk mencari konten file Excel, gunakan code interpreter daripada pencarian semantik. Pencarian semantik memiliki keterbatasan untuk pengindeksan sel.

Buat perintah dengan salah satu dari dua cara:

  • Di Power Apps: Gunakan opsi Membangun prompt Anda sendiri di AI Hub.
  • Tambahkan prompt sebagai alat di tingkat agen atau topik di Copilot Studio.

Pelajari selengkapnya tentang perintah di Gambaran umum Perintah.

Anda juga dapat menggunakan penerjemah kode dalam obrolan agen di Copilot Studio.

Mulai perintah baru di Power Apps AI Hub dan aktifkan penerjemah kode

Anda dapat memulai perintah baru di AI Hub di Power Apps dan mengaktifkan penerjemah kode di pengaturan prompt.

  1. Pergi ke Power Apps.

  2. Pilih hub AI di panel kiri.

  3. Pilih Prompts.

    Cuplikan layar memilih perintah di hub AI.

  4. Pilih buat prompt Anda sendiri.

    Cuplikan layar memilih membangun prompt Anda sendiri di hub AI.

  5. Memasukkan nama untuk perintah Anda.

  6. Di bagian Instruksi , pilih tiga titik (...), lalu pilih Pengaturan.

    Cuplikan layar cara membuka pengaturan prompt.

  7. Pada Pengaturan, aktifkan penerjemah kode.

  8. Tutup Pengaturan untuk kembali ke editor perintah.

Editor prompt terbuka dengan penerjemah kode diaktifkan. Selanjutnya, tulis instruksi untuk perintah Anda.

Mulai perintah baru sebagai alat dalam agen dan aktifkan penerjemah kode

Anda dapat memulai perintah baru sebagai alat dalam agen di Copilot Studio dan mengaktifkan penerjemah kode untuk perintah tersebut.

  1. Di Copilot Studio, buka agen tempat Anda ingin menggunakan penerjemah kode.

  2. Menambahkan perintah baru ke agen sebagai alat, baik di tingkat agen maupun tingkat topik.

    • Tambahkan perintah di tingkat agen:

      1. Buka halaman Alat .

      2. Pilih Tambahkan alat>Sigap.

    • Tambahkan perintah di tingkat topik:

      1. Buka halaman Topik dan pilih topik tempat Anda ingin menambahkan perintah.

      2. Pilih Tambahkan simpul dalam posisi dalam topik tempat Anda ingin menambahkan perintah.

      3. Pilih Tambahkan alat>Perintah baru.

    Antarmuka penulisan perintah pembuat perintah yang disematkan terbuka.

  3. Pada bilah informasi, pilih tiga titik (...), lalu pilih Pengaturan.

    Cuplikan layar pembukaan pengaturan perintah.

  4. Pada halaman Pengaturan, pilih aktifkan penerjemah kode.

  5. Tutup Pengaturan untuk kembali ke editor perintah.

Editor prompt terbuka dengan penerjemah kode diaktifkan. Selanjutnya, tulis instruksi untuk perintah Anda.

Menulis instruksi untuk perintah Anda

Selanjutnya, Anda dapat menulis instruksi perintah, mengonfigurasi perintah sesuai kebutuhan, dan menyimpan untuk membuat perintah.

Pelajari selengkapnya tentang cara menggunakan penerjemah kode dalam perintah dalam Contoh perintah penerjemah kode.

Praktik terbaik untuk penerjemah kode dalam perintah

  • Gunakan alat AI lainnya seperti Copilot untuk mendapatkan perintah yang dioptimalkan untuk memulai.
  • Gunakan perintah yang tepat dengan contoh (perintah beberapa kali coba).
  • Tentukan output (misalnya, "Return as JSON" atau "Excel" atau "PDF").

Keterbatasan

  • Menganalisis beberapa file yang diunggah dalam satu perintah tidak didukung.
  • Mengembalikan beberapa output file dalam satu prompt tidak didukung.
  • Mengajukan pertanyaan tentang file yang diunggah melalui beberapa giliran tidak didukung.
  • Untuk menggunakan penerjemah kode, Anda perlu mengonfigurasi agen, di pengaturan agen, untuk menggunakan autentikasi pengguna. Misalnya, menggunakan Direct Line dengan No authentication dipilih tidak berfungsi untuk skenario menggunakan penerjemah kode.

Troubleshooting

Jika Anda mengalami kesalahan saat menggunakan penerjemah kode, coba langkah-langkah berikut:

  1. Pastikan semua izin yang diperlukan diberikan. Verifikasi bahwa akun pengguna dan agen memiliki izin yang diperlukan untuk menjalankan perintah penerjemah kode.
  2. Verifikasi pengaturan konfigurasi. Konfirmasikan bahwa penerjemah kode diaktifkan di pengaturan perintah dan agen Anda dikonfigurasi untuk menggunakan autentikasi pengguna.
  3. Konsultasikan log kesalahan untuk informasi terperinci. Tinjau log kesalahan di Copilot Studio atau lingkungan Power Platform terkait untuk mengidentifikasi akar penyebab masalah dan mengambil tindakan korektif.