Uji agen dengan Dev Tunnels

Dengan menggunakan Dev Tunnels, Anda dapat menguji Agent 365 Anda dengan aplikasi Microsoft 365 (seperti Teams, Outlook, atau Word) saat Agent 365 Anda berjalan secara lokal di mesin pengembangan Anda. Pendekatan ini menghubungkan pengembangan lokal dan pengujian dunia nyata, sehingga Anda dapat memvalidasi perilaku agen di lingkungan Microsoft 365 yang sesungguhnya sebelum menyebarkan ke cloud.

Prasyarat

Sebelum menggunakan Dev Tunnels, pastikan Anda telah menginstal alat baris perintah Dev Tunnels.

Menyiapkan Dev Tunnels

Konfigurasikan Dev Tunnels untuk mengekspos titik akhir agen lokal Anda ke layanan Microsoft 365.

Buat dan mulai tunnel

  1. Masuk ke Dev Tunnels:

    devtunnel user login

  2. Buat tunnel persisten:

    devtunnel create --allow-anonymous

    Perintah ini mengembalikan ID tunnel. Simpan ID ini untuk digunakan di masa mendatang.

  3. Konfigurasikan port tunnel:

    Tetapkan port yang digunakan server agen Anda (biasanya 3978):

    devtunnel port create <tunnel-id> -p <port-number>

  4. Mulai tunnel:

    devtunnel host <tunnel-id>

    Perintah ini menampilkan URL tunnel Anda (misalnya, https://abc123xyz.devtunnels.ms:3978). Salin URL ini untuk langkah berikutnya.

Kiat

Gunakan devtunnel list untuk melihat semua tunnel Anda dan devtunnel delete <tunnel-id> untuk menghapus tunnel yang tidak lagi Anda perlukan.

Konfigurasi titik akhir olahpesan agen

Daftarkan URL Dev Tunnels Anda (misalnya, https://abc123xyz.devtunnels.ms:3978/api/messages) sebagai titik akhir pesan agen agar Microsoft 365 tahu ke mana harus merutekan pesan. Jangan lupa menambahkan akhiran /api/messages pada titik akhir.

Lihat Mengatur titik akhir olahpesan agen

Uji dengan Microsoft 365

Dengan Dev Tunnels Anda aktif dan titik akhir terdaftar, uji agen Anda di aplikasi Microsoft 365.

Uji di Microsoft Teams

  1. Mulai agen lokal Anda dengan menggunakan petunjuk di Menginstal dependensi dan memulai server aplikasi agen.

  2. Verifikasi konektivitas tunnel:

    devtunnel list

    Periksa apakah tunnel Anda menampilkan koneksi host aktif. Kolom "Koneksi Host" harus menampilkan angka yang lebih besar dari 0.

  3. Berinteraksi dengan agen Anda di Teams:

    • Buka Microsoft Teams (web atau desktop)
    • Di bilah pencarian Teams, cari agen Anda dengan nama atau email
    • Mulai percakapan dengan agen
    • Kirim pesan dan amati responsnya
    • Periksa konsol lokal Anda untuk permintaan masuk dan aktivitas agen

Uji pemberitahuan email

Jika agen Anda dikonfigurasi untuk pemberitahuan email:

  1. Kirim email ke alamat email agen Anda
  2. CC agen Anda di utas email
  3. Pantau konsol lokal Anda untuk webhook pemberitahuan
  4. Pastikan agen Anda memproses dan merespons email

Uji integrasi Word

Untuk agen yang merespons komentar Word:

  1. Buka dokumen Word yang dapat diakses oleh agen Anda.
  2. Tambahkan komentar yang menyebutkan agen Anda.
  3. Periksa konsol lokal Anda untuk pemberitahuan.
  4. Pastikan respons agen Anda muncul di Word.

Pantau aktivitas tunnel

Dev Tunnels menyediakan inspeksi lalu lintas untuk membantu men-debug masalah koneksi dan memahami alur permintaan:

devtunnel show <tunnel-id>

Perintah ini menampilkan:

  • Koneksi aktif dan detail sesi.
  • Informasi permintaan dan respons.
  • Statistik volume lalu lintas.
  • Kesalahan dan peringatan koneksi.

Anda juga dapat memonitor aktivitas tunnel secara real-time dengan melihat output dari perintah devtunnel host.

Kelola koneksi tunnel

Dev Tunnels memerlukan proses devtunnel host agar tetap berjalan. Jika koneksi terputus karena tidak ada aktivitas, masalah jaringan, atau komputer Anda masuk ke mode tidur, Anda perlu memulai ulang prosesnya.

Periksa status tunnel

Verifikasi apakah tunnel Anda aktif:

devtunnel list

Output menampilkan:

  • ID tunnel: Pengidentifikasi tunnel Anda
  • Koneksi host: Jumlah koneksi aktif (seharusnya satu atau lebih saat devtunnel host berjalan)
  • Port: Port yang dikonfigurasi
  • Kedaluwarsa: Waktu kedaluwarsa tunnel

Jika Koneksi Host menunjukkan 0, tunnel ada tetapi saat ini tidak dihosting.

Mulai ulang tunnel yang terputus

Jika koneksi tunnel Anda terputus, mulai ulang dengan menggunakan ID tunnel yang sama:

devtunnel host <tunnel-id>

URL tunnel tetap sama, jadi Anda tidak perlu memperbarui konfigurasi titik akhir olahpesan agen Anda.

Jaga agar tunnel tetap aktif selama pengembangan

Untuk mempertahankan koneksi yang stabil:

  • Pastikan jendela terminal tetap terbuka - Jangan tutup terminal yang menjalankan devtunnel host.
  • Cegah komputer masuk ke mode tidur - Konfigurasikan sistem Anda agar tetap aktif selama sesi pengujian.
  • Perhatikan kesalahan koneksi - Pantau output terminal devtunnel host untuk pesan pemutusan.
  • Mulai ulang setelah perubahan jaringan - Jika Anda beralih jaringan atau menyambungkan kembali ke VPN, mulai ulang tunnel.

Kiat

Jika tunnel Anda sering terputus, periksa pengaturan jaringan dan aturan firewall untuk memastikan koneksi tidak terblokir.

Penghapusan

Saat Anda selesai menguji dengan Dev Tunnels:

Hentikan tunnel

Tekan Ctrl+C di terminal yang menjalankan devtunnel host untuk menghentikan tunnel.

Perintah ini menghapus URL Dev Tunnels dari titik akhir olahpesan agen Anda. Saat Anda menyebarkan ke produksi, atur URL titik akhir yang di-host di cloud.

Catatan

Tunnel tetap tersedia untuk digunakan di masa mendatang hingga Anda secara eksplisit menghapusnya dengan menggunakan devtunnel delete <tunnel-id>.

Pembatasan

Perhatikan batasan-batasan berikut saat melakukan pengujian dengan Dev Tunnels:

  • Hanya untuk pengembangan: Gunakan Dev Tunnels untuk pengembangan dan pengujian, bukan untuk produksi.
  • Performa: Antisipasi latensi yang lebih tinggi dibandingkan dengan agen yang dihosting cloud karena perutean jaringan.
  • Stabilitas koneksi: Koneksi tunnel dapat terputus sewaktu-waktu dan perlu dimulai ulang secara manual.
  • Pertimbangan keamanan: Flag --allow-anonymous praktis untuk pengujian, tetapi jangan gunakan dengan data sensitif.
  • Manajemen sesi: Anda mungkin perlu mengautentikasi ulang secara berkala tergantung pada durasi sesi Anda.

Langkah berikutnya

Setelah berhasil melakukan pengujian Dev Tunnels:

Pemecahan masalah

Jika Anda mengalami masalah saat melakukan pengujian melalui Dev Tunnels, mulai dari sini untuk solusi umum terkait tunnel, konektivitas, dan titik akhir. Untuk pemecahan masalah Agent 365 yang lebih luas (penyiapan, autentikasi, dan olahpesan), lihat Pemecahan Masalah.

Koneksi tunnel gagal

Gejala: Dev Tunnels gagal memulai atau langsung terputus.

Solusi:

  • Pastikan Anda sudah masuk: devtunnel user login
  • Periksa apakah ada proses lain yang menggunakan port yang sama
  • Pastikan firewall Anda memperbolehkan koneksi Dev Tunnels
  • Hapus dan buat ulang tunnel baru: devtunnel delete <tunnel-id> lalu buat yang baru

Pesan tidak sampai ke agen lokal

Gejala: Microsoft 365 menunjukkan pesan sudah dikirim, namun agen lokal Anda tidak menerimanya.

Solusi:

  • Pastikan agen Anda berjalan secara lokal
  • Verifikasi tunnel aktif: devtunnel list seharusnya menampilkan "Terhubung"
  • Periksa konfigurasi titik akhir di a365.config.json dan pastikan URL Dev Tunnels Anda disetel sebagai titik akhir pesan
  • Tinjau log Dev Tunnels di terminal yang menjalankan devtunnel host untuk memeriksa kesalahan koneksi
  • Pastikan port lokal Anda sama dengan port tunnel (keduanya harus 3978 secara default)

Kesalahan autentikasi melalui Dev Tunnels

Gejala: Kesalahan 401 atau 403 saat menguji melalui Dev Tunnels.

Solusi:

  • Verifikasi bahwa autentikasi agenik telah dikonfigurasi (autentikasi token pembawa tidak berfungsi dengan Dev Tunnels untuk integrasi Microsoft 365).
  • Periksa kredensial cetak biru agen di a365.generated.config.json.
  • Pastikan agen Anda memiliki izin yang diperlukan untuk operasi yang Anda uji.
  • Pastikan token autentikasi Anda belum kedaluwarsa.

URL tunnel berubah atau kedaluwarsa

Gejala: URL tunnel yang sebelumnya berfungsi tidak lagi mengarah ke agen Anda.

Solusi:

  • Periksa status tunnel dengan menggunakan devtunnel list.
  • Mulai ulang tunnel dengan menggunakan devtunnel host <tunnel-id>.
  • Perbarui titik akhir olahpesan jika URL berubah dengan menggunakan a365 setup blueprint --endpoint-only.
  • Last updated on