Udostępnij przez


Ręczne wdrażanie agenta na platformie Azure

Uruchomienie agenta zestawu SDK agentów usługi Microsoft 365 na platformie Azure wymaga wykonania następujących kroków:

W tym dokumencie opisano wdrażanie utworzonego agenta na platformie Azure i w usłudze Teams lub programie Microsoft 365 Copilot.

Jeśli jeszcze nie utworzono agenta, zacznij od przewodnika Szybki start: tworzenie i testowanie podstawowego agenta przy użyciu języka C#.

Publikowanie agenta w aplikacji internetowej

Agent zestawu SDK to aplikacja internetowa. Aby opublikować agenta, można użyć metod zwykle używanych do wdrażania aplikacji internetowych na platformie Azure:

  • Wdrażanie jako pakietu ZIP w aplikacji usługi Azure App Service
  • Publikowanie z programu Visual Studio do aplikacji usługi Azure App Service lub kontenera
  • Inne wdrożenia kontenerów obsługiwane przez platformę Azure
  • Wdrażanie zestawu narzędzi agentów usługi Microsoft 365

Ważne

Jeśli używasz aplikacji usługi Azure App Service i poświadczeń federacyjnych lub tożsamości zarządzanej użytkownika, musisz dodać tożsamość w obszarze Ustawienia, a następnie w polu Tożsamość.

Po wdrożeniu kodu agenta zyskuje on podstawowy adres URL, taki jak example.azurewebsites.net.

Na platformie Azure przejdź do zasobu usługi Azure Bot. W obszarze Konfiguracja w polu Punkt końcowy obsługi wiadomości zmień wartość na https://{yourwebsite}/api/messages. Zastąp ciąg {yourwebsite} podstawowym adresem URL aplikacji internetowej.

Testuj w czacie internetowym

Aby wyświetlić wiadomość w czacie internetowym, wybierz pozycję Testuj w czacie internetowym w zasobie usługi Azure Bot i wyślij wiadomości do agenta.

Przygotowywanie manifestu aplikacji Teams i funkcji Microsoft 365 Copilot

W przypadku aplikacji Microsoft Teams i Microsoft 365 Copilot należy utworzyć i przekazać manifest. Nie można podać przykładu manifestu, który obejmuje wszystkie potrzeby usługi Teams lub Microsoft 365 Copilot. Funkcje usługi Teams wymagają określonej zawartości manifestu.

Te kroki zawierają omówienie podstawowego agenta w stylu czatu usługi Teams.

  1. Utwórz pusty folder w projekcie.
  2. Skopiuj zawartość plików manifestu usługi Teams do folderu.
  3. W folderze otwórz plik manifest.json i wprowadź następujące zmiany:
    • Wszędzie, gdzie widzisz symbol zastępczy <<AAD_APP_CLIENT_ID>>, zastąp go identyfikatorem ClientId swojego zasobu usługi Azure Bot.
    • Zastąp ciąg <<BOT_DOMAIN>> podstawowym adresem URL agenta.
    • Spakuj zawartość folderu, aby utworzyć element manifest.zip z zawartością:
      • manifest.json
      • outline.png
      • color.png

Wdrażanie w usłudze Microsoft 365

  1. Twój zasób usługi Azure Bot powinien mieć dodany kanał usługi Microsoft Teams w obszarze Kanały.

  2. Przejdź do portalu administracyjnego Microsoft (MAC). W obszarze Ustawienia > Zintegrowane aplikacje wybierz opcję Przekaż aplikację niestandardową.

  3. Wybierz plik manifest.zip utworzony w poprzedniej sekcji i przekaż go.

Po krótkim czasie agent pojawi się w usłudze Microsoft Teams i rozwiązaniu Microsoft 365 Copilot.