Punkt końcowy wiadomości agenta

Punkt końcowy wiadomości agentów to ten, do którego wysyłasz powiadomienia agentowe do swojego agenta.

Usuń punkt końcowy wiadomości agenta

Użyj polecenia a365 cleanup blueprint --endpoint-only, aby usunąć rejestrację punktu końcowego wiadomości agenta. To polecenie nie wpływa na kod agenta ani na wdrożony punkt końcowy. Usuwa jedynie wpis rejestracyjny za pośrednictwem Teams Graph (platforma MCP).

a365 cleanup blueprint --endpoint-only

Konfiguracja punktu końcowego wiadomości w a365.config.json

Przed skonfigurowaniem punktu końcowego wiadomości należy określić go w pliku konfiguracyjnym a365.config.json. Ten plik zawiera podstawową konfigurację dla wdrożenia agenta.

Dodaj lub zaktualizuj te właściwości konfiguracyjne punktów końcowych komunikatów:

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

  • messagingEndpoint: Podaj dokładny adres URL punktu końcowego, na który możesz wysyłać wiadomości do agenta.

  • deploymentProjectPath: Ścieżka do katalogu projektu agenta. Ta właściwość nie jest istotna, jeśli Twój agent jest już wdrożony i nie musisz aktualizować konfiguracji środowiska. Ustaw deploymentProjectPath na . tylko jeśli kod agenta nie znajduje się na twoim komputerze.

Konfiguracja właściwości

Właściwość Opis Wymagani Wartość domyślna Przykład
messagingEndpoint Adres URL, pod którym agent odbiera wiadomości Tak Brak https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Ścieżka do katalogu projektu agenta do aktualizacji konfiguracji Nie . ./my-agent lub .

Opcje konfiguracji punktu końcowego

Wartość messagingEndpoint zależy od scenariusza wdrożenia:

Dla wdrożeń platformy Azure:

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

Dla wdrożeń nieopartych na Azure:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Inni dostawcy chmury: adres URL niestandardowego punktu końcowego

Do lokalnych testów z Dev Tunnels:

  • Adres URL tunelu developera: https://abc123xyz.devtunnels.ms:3978/api/messages

Ważne

deploymentProjectPath wskazuje, gdzie CLI szuka plików projektu i gdzie aktualizuje konfigurację środowiska, takich jak pliki .env.

Notatka

Podczas korzystania z tuneli deweloperów do lokalnych testów, zaktualizuj messagingEndpoint w a365.config.json, wpisując adres URL tunelu deweloperskiego przed uruchomieniem polecenia setup. Więcej informacji: zobacz testowanie za pomocą tuneli deweloperskich.

Ustaw punkt końcowy komunikacji agenta

Po aktualizacji pliku a365.config.json, użyj tego polecenia, aby zarejestrować punkt końcowy wiadomości, dzięki czemu usługa Agent 365 będzie mogła wysyłać powiadomienia do Twojego agenta. Operacja --endpoint-only rejestruje punkt końcowy poprzez Teams Graph (platforma MCP).

a365 setup blueprint --endpoint-only

Możesz też przekazać adres URL bezpośrednio za pomocą --messaging-endpoint, zamiast edytować a365.config.json:

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

Podczas testów lokalnych możesz skonfigurować ten punkt końcowy jako punkt końcowy tunelu deweloperskiego przed wdrożeniem agenta do chmury. Więcej informacji: zobacz testowanie za pomocą tuneli deweloperskich.

Aby zaktualizować istniejący adres URL punktu końcowego:

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

Wdrażanie punktu końcowego

Jeśli nie masz jeszcze wdrożonego agenta w chmurze, dowiedz się, jak wdrożyć agenta na platformie Azure.

Jeśli masz już wdrożonego agenta w chmurze, możesz ustawić punkt końcowy wiadomości tak, jak pokazano wcześniej.

Dowiedz się, jak ustawić punkt końcowy komunikatora na innych popularnych chmurach:

  • Last updated on