Aracı mesajlaşma uç noktası

Aracı mesajlaşma uç noktası, aracınınıza aracıik bildirim mesajları gönderdiğiniz uç noktadır.

Aracı mesajlaşma uç noktasını sil

Aracı mesajlaşma uç noktası kaydını temizlemek için a365 cleanup blueprint --endpoint-only komutunu kullanın. Bu komut ne aracı kodunuzu ne de dağıtılan uç noktayı etkiler. Bu işlem, kayıt girişini yalnızca Teams Graph (MCP Platformu) üzerinden kaldırır.

a365 cleanup blueprint --endpoint-only

Mesajlaşma uç noktasını a365.config.json dosyasında yapılandırın

Mesajlaşma uç noktasını ayarlamadan önce, bunu a365.config.json yapılandırma dosyanızda belirtin. Bu dosya, aracı dağıtımının temel yapılandırmasını içerir.

Aşağıdaki mesajlaşma uç noktası yapılandırma özelliklerini ekleyin veya güncelleyin:

{
  "messagingEndpoint": "https://your-endpoint-url.com/api/messages",
  "deploymentProjectPath": "."
}

  • messagingEndpoint: Aracıya mesaj gönderebileceğiniz tam uç nokta URL'sini belirtin.

  • deploymentProjectPath: Aracı proje dizininize giden yol. Bu özellik, aracınınız zaten konuşluysa ve ortam yapılandırmasını güncellemenize gerek yoksa geçerli değildir. deploymentProjectPath değerini . olarak yalnızca aracı kodu makinenizde bulunmuyorsa ayarlayın.

Yapılandırma özellikleri

Özellik Açıklama Zorunlu Varsayılan Örnek
messagingEndpoint Aracınızın mesajları aldığı URL Evet Yok https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Yapılandırma güncellemeleri için aracı proje dizininin yolu Hayır . ./my-agent veya .

Uç nokta yapılandırma seçenekleri

messagingEndpoint değeri dağıtım senaryonuza bağlıdır:

Azure dağıtımları için:

  • Azure Web Uygulaması: https://your-app-name.azurewebsites.net/api/messages

Azure dışı dağıtımlar için:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Diğer bulut sağlayıcıları: Özel uç nokta URL'niz

Dev Tunnels ile yerel test için:

  • Dev Tunnel URL: https://abc123xyz.devtunnels.ms:3978/api/messages

Önemli

deploymentProjectPath, CLI'nin proje dosyalarını aradığı ve ortam yapılandırmasını (örneğin .env dosyaları) güncellediği yeri belirtir.

Not

Yerel test için Dev Tunnels kullanırken, kurulum komutunu çalıştırmadan önce a365.config.json dosyasındaki messagingEndpoint değerini Dev Tunnel URL'niz ile güncelleyin. Daha fazla bilgi için Dev Tunnels ile test bölümüne bakınız.

Aracı mesajlaşma uç noktasını ayarla

a365.config.json dosyanızı güncelledikten sonra, Agent 365 servisinin aracınınıza bildirim gönderebilmesi için bu komutu kullanarak mesajlaşma uç noktasını kaydedin. --endpoint-only işlemi, uç noktayı Teams Graph (MCP Platformu) üzerinden kaydeder.

a365 setup blueprint --endpoint-only

URL'yi doğrudan --messaging-endpoint ile iletebilirsiniz, a365.config.json dosyasını düzenlemek yerine:

a365 setup blueprint --endpoint-only `
  --messaging-endpoint https://your-app.azurewebsites.net/api/messages

Yerel test sırasında, bu uç noktayı Dev Tunnel uç noktasına ayarlayabilirsiniz ve ardından aracıı buluta dağıtabilirsiniz. Daha fazla bilgi için Dev Tunnels ile test bölümüne bakınız.

Mevcut bir uç nokta URL'sini güncellemek için:

a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages

Uç noktanın dağıtımı

Aracınınız henüz buluta dağıtılmadıysa, aracıı Azure'a dağıtmayı öğrenin.

Aracınınızı buluta zaten dağıttıysanız, daha önce gösterildiği gibi mesajlaşma uç noktasını ayarlayabilirsiniz.

Mesajlaşma uç noktasını diğer bazı popüler bulut platformlarında nasıl ayarlayacağınızı öğrenin:

  • Last updated on