Gunakan activity trace untuk debug agen Anda

Pelacakan aktivitas pada agen yang didukung oleh harness GitHub Copilot di Microsoft Copilot Studio menunjukkan secara tepat bagaimana agen Anda memproses setiap pesan. Gunakan ini untuk memahami penalaran chain-of-thought agen Anda, memverifikasi atribusi sumber pengetahuan, mengonfirmasi eksekusi alat, dan menangani kesalahan.

Note

Fitur-fitur dalam artikel ini didukung oleh harness GitHub Copilot, yang menggunakan Kredit Copilot untuk penagihan berbasis penggunaan. Pelajari lebih lanjut tentang Kredit Copilot dalam Ikhtisar penagihan untuk agen yang didukung oleh harness GitHub Copilot.

Penagihan berbasis penggunaan berlaku untuk penggunaan, pembuatan, pengujian, dan evaluasi agen. Tindakan-tindakan ini mungkin menghabiskan Kredit Copilot.

Prasyarat

  • Agen yang dibuat dengan harness GitHub Copilot
  • Minimal satu percakapan pengujian di tab Pratinjau

Membuka jejak aktivitas

  1. Buka agen Anda di Copilot Studio dan pilih tab Pratinjau.

  2. Pastikan sakelar pengalih Pratinjau Pengguna Akhir dinonaktifkan (tampilan pembuat default). Pelacakan aktivitas ditampilkan di samping panel obrolan, menampilkan detail pemrosesan untuk setiap pesan.

  3. Kirim pesan ke agen Anda. Jejak diperbarui secara real time saat agen memproses pesan.

Memahami jejak

Pelacakan aktivitas menampilkan tampilan rantai pemikiran (CoT) dari pemrosesan agen Anda. Setiap langkah dalam jejak aktivitas muncul sebagai node yang menampilkan tindakan agen serta alasannya.

Jenis Node

Jejak dapat mencakup jenis simpul berikut:

Jenis node Apa yang ditampilkannya
Pesan pengguna Pesan yang Anda kirim ke agen
Tanggapan agen Respons yang dihasilkan agen
Pengetahuan Sumber pengetahuan yang dirujuk oleh agen sebagai dasar. Ditampilkan sebagai kartu yang dapat diciutkan "Pengetahuan yang dicari" yang menampilkan sumber untuk setiap sumber pengetahuan yang diakses, serta tautan kutipan jika tersedia.
Tindakan yang dijalankan Pemanggilan konektor atau alat yang disajikan sebagai kartu yang dapat diciutkan menampilkan konektor, parameter input yang diisi, dan durasi pengiriman
Alat Alat yang dipanggil agen untuk melakukan tindakan atau mengambil data
Konektor Konektor yang digunakan agen untuk mengakses data eksternal
Alur Alur agen yang telah dipicu
Keterampilan Keterampilan yang dieksekusi
Error Kesalahan yang terjadi selama pemrosesan
Selesaikan Indikator tanda centang hijau ditampilkan di bagian bawah pelacakan ketika semua panggilan alat telah selesai.

Lihat detail simpul

  1. Pilih node apa pun dalam pelacakan untuk memperluas detailnya.

  2. Tinjau informasi yang ditampilkan, yang dapat mencakup:

    • Input yang dikirim agen ke langkah tersebut
    • Output atau hasil yang dikembalikan
    • Waktu pemrosesan dan metrik
    • Detail kesalahan jika langkah gagal

Men-debug masalah sumber pengetahuan

Saat agen Anda menggunakan pengetahuan untuk menjawab pertanyaan, jejak menunjukkan sumber mana yang dirujuk:

  1. Temukan simpul Knowledge dalam jejak.

  2. Tinjau sumber untuk melihat sumber pengetahuan mana yang diakses.

  3. Pilih sumber untuk melihat konten spesifik yang diambil.

  4. Pastikan bahwa agen menggunakan sumber yang benar dan bahwa konten yang diambil sudah relevan.

Jika agen menggunakan sumber yang salah atau memberikan informasi yang tidak akurat, periksa konfigurasi pengetahuan Anda di tab Build.

Eksekusi alat debug

Saat agen Anda memanggil alat, pelacakan menampilkan detail eksekusi:

  1. Temukan node Alat, Konektor, Alur, atau Keterampilan di jejak.

  2. Tinjau detail eksekusi, termasuk parameter input dan hasil output.

  3. Verifikasi bahwa alat yang benar dipanggil dan hasilnya seperti yang diharapkan.

  4. Jika eksekusi alat gagal, tinjau detail kesalahan di node.

Untuk mengonfigurasi ulang alat, buka tab Build dan temukan alat tersebut dalam konfigurasi agen Anda.

Memecahkan masalah kesalahan

Ketika kesalahan terjadi selama pemrosesan, pelacakan menyorotinya:

  1. Cari node yang ditandai dengan indikator kesalahan pada pelacakan.

  2. Pilih node kesalahan untuk melihat detail kesalahan, termasuk pesan kesalahan dan konteksnya.

  3. Masalah umum mencakup:

    • Kegagalan autentikasi untuk alat atau konektor
    • Kesalahan saat mengakses sumber pengetahuan
    • Kesalahan batas waktu untuk panggilan tool yang berjalan lama
    • Penanda moderasi konten

  4. Atasi akar penyebab di tab Build atau Pengaturan, lalu uji ulang.

Pelacakan aktivitas terintegrasi dengan tab Build untuk pengeditan cepat.

  1. Pilih sumber, alat, atau komponen apa pun dalam pelacakan.

  2. Copilot Studio menavigasi ke komponen yang sesuai di tab Build .

  3. Buat perubahan dan kembali ke tab Pratinjau untuk menguji ulang.

  • Last updated on