Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Titik akhir perpesanan agen adalah tempat Anda mengirim pesan notifikasi agen ke agen Anda.
Menghapus titik akhir perpesanan agen
Gunakan a365 cleanup blueprint --endpoint-only perintah untuk menghapus pendaftaran titik akhir pesan agen. Perintah ini tidak memengaruhi kode agen Anda atau titik akhir yang disebarkan. Perintah ini hanya menghapus entri pendaftaran melalui Teams Graph (MCP Platform).
a365 cleanup blueprint --endpoint-only
Mengonfigurasi titik akhir perpesanan di a365.config.json
Sebelum mengatur titik akhir perpesanan, tentukan di file konfigurasi a365.config.json Anda. File ini berisi konfigurasi inti untuk penyebaran agen Anda.
Tambahkan atau perbarui properti konfigurasi titik akhir pesan berikut:
{
"messagingEndpoint": "https://your-endpoint-url.com/api/messages",
"deploymentProjectPath": "."
}
messagingEndpoint: Tentukan URL titik akhir yang tepat tempat Anda dapat mengirim pesan ke agen.deploymentProjectPath: Jalur ke direktori proyek agen Anda. Properti ini tidak relevan jika agen Anda sudah disebarkan dan Anda tidak perlu memperbarui konfigurasi lingkungan. AturdeploymentProjectPathke.hanya jika kode agen tidak berada di mesin Anda.
Properti konfigurasi
| Properti | Deskripsi | Wajib | Default | Contoh |
|---|---|---|---|---|
messagingEndpoint |
URL tempat agen Anda menerima pesan | Ya | Tidak ada | https://your-app.azurewebsites.net/api/messages |
deploymentProjectPath |
Jalur ke direktori proyek agen Anda untuk pembaruan konfigurasi | Tidak | . |
./my-agent atau . |
Opsi konfigurasi titik akhir
Nilai dari messagingEndpoint tergantung skenario penyebaran Anda:
Untuk penyebaran Azure:
- Aplikasi Web Azure:
https://your-app-name.azurewebsites.net/api/messages
Untuk penyebaran non-Azure:
- AWS:
https://your-api-gateway-url.amazonaws.com/api/messages - GCP:
https://your-cloud-run-url.run.app/api/messages - Penyedia cloud lainnya: URL titik akhir kustom Anda
Untuk pengujian lokal dengan Dev Tunnels:
- Dev Tunnel URL:
https://abc123xyz.devtunnels.ms:3978/api/messages
Penting
deploymentProjectPath menentukan lokasi tempat CLI mencari file proyek dan memperbarui konfigurasi lingkungan, seperti file .env.
Catatan
Saat menggunakan Dev Tunnels untuk pengujian lokal, perbarui messagingEndpoint di a365.config.json dengan URL Dev Tunnel Anda sebelum menjalankan perintah penyiapan. Untuk informasi selengkapnya, lihat pengujian dengan Dev Tunnels.
Atur titik akhir perpesanan agen
Setelah memperbarui file a365.config.json, jalankan perintah berikut untuk mendaftarkan titik akhir messaging agar layanan Agent 365 dapat mengirim notifikasi ke agen Anda. Operasi --endpoint-only digunakan untuk mendaftarkan titik akhir melalui Teams Graph (MCP Platform).
a365 setup blueprint --endpoint-only
Anda juga dapat meneruskan URL secara langsung dengan --messaging-endpoint, bukan mengedit a365.config.json:
a365 setup blueprint --endpoint-only `
--messaging-endpoint https://your-app.azurewebsites.net/api/messages
Selama pengujian lokal, Anda dapat mengonfigurasi titik akhir ini ke titik akhir Dev Tunnel sebelum melakukan deployment agen ke cloud. Untuk informasi selengkapnya, lihat pengujian dengan Dev Tunnels.
Untuk memperbarui URL titik akhir yang ada:
a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages
Penyebaran titik akhir
Jika Anda belum menyebarkan agen ke cloud, pelajari cara menyebarkan agen ke Azure.
Jika Anda sudah menyebarkan agen ke cloud, Anda dapat mengatur titik akhir perpesanan seperti yang ditunjukkan sebelumnya.
Pelajari cara mengatur titik akhir perpesanan di beberapa cloud populer lainnya: