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:

• Tworzenie i konfigurowanie agenta
• Aprowizuj zasób usługi Azure Bot i skonfiguruj uwierzytelnianie dla zasobu
• Wdrażanie agenta na platformie Azure
• Opcjonalnie wdroż swojego agenta w Teams lub Microsoft Copilot

Ten dokument obejmuje wdrożenie stworzonego agenta na Azure i Teams lub Microsoft 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 na platformie Azure jako aplikacji internetowej

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

   • Wdrażanie pakietu ZIP do aplikacji Azure App Service
   • Publikowanie aplikacji z programu Visual Studio do 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

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

1. 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 rozmowie internetowej

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.

Przygotuj manifest dla aplikacji Teams i Microsoft Copilot

W przypadku Microsoft Teams i Microsoft Copilot musisz stworzyć i przesłać manifest. Nie da się podać przykładu manifestu, który obejmiałby wszystkie potrzeby związane z Teams lub Microsoft 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 na platformie Microsoft 365

1. Upewnij się, że zasób usługi Azure Bot ma kanał Microsoft Teams dodany w obszarze Kanały.

2. Przejdź do portalu administracyjnego firmy Microsoft (MAC).

3. W obszarze Ustawienia i zintegrowane aplikacje wybierz pozycję Przekaż aplikację niestandardową.

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

Po krótkim czasie agent pojawia się w Microsoft Teams i Microsoft Copilot.