Nasazení agenta do Azure

Vytvořili jste svého agenta a lokálně jej otestovali. Nyní jej oživte v cloudu. Tento krok je nepovinný. Můžete jej přeskočit, pokud jste už nasadili svého agenta do nějakého cloudu (nemusí to být ani Azure).

Tento průvodce vás provede nasazením kódu vašeho agenta do Azure a jeho publikováním v centru pro správu Microsoft, kde se stane registrovaným majetkem vaší organizace.

Chcete-li aktualizovat koncový bod pro zasílání zpráv, projděte si následující materiály. V nich se dozvíte, jak můžete aktualizovat koncový bod pro zasílání zpráv, pokud jste nasadili agenta u jiných poskytovatelů cloudových služeb, jako jsou Amazon Web Services nebo Google Cloud Platform:

Předpoklady

Než začnete, zkontrolujte, zda máte následující položky:

Požadované účty a oprávnění

Předplatné Azure s oprávněním přispěvatele.
Funkční kód agenta s platným a dostupným komunikačním koncovým bodem. Ujistěte se, že jste svého agenta otestovali lokálně a případně také otestovali s Microsoft 365 pomocí Dev Tunnels, abyste ověřili, že kód agenta lze sestavit a spustit, jak se očekává.
Platný podrobný plán agenta provedením nastavení kroku podrobného plánu agenta.
Aktuální konfigurační soubory a365.config.json, a365.generated.config.json a konfigurační soubor v kódu (například soubor .env).

Požadované nástroje

Nainstalovaný a ověřený Azure CLI (Instalace Azure CLI)

Nasazení do Azure

Kód aplikace aplikaci agenta nasazujte do Azure pomocí standardních nástrojů Azure, jako je Azure CLI, Azure Portal nebo GitHub Actions.

Nasazení aplikace agenta

K nasazení aplikace použijte příkaz Azure CLI az webapp deploy:

# Build your project first (example for .NET)
dotnet publish -c Release -o ./publish

# Deploy to Azure Web App
az webapp deploy --name <your-web-app> --resource-group <your-resource-group> --src-path ./publish

Pro GitHub Actions použijte akci Nasazení webových aplikací Azure.

Upozornění

Správa tajných kódů: Proměnné prostředí, včetně klíčů a tajných kódů API, uchovávejte jako nastavení aplikace Azure namísto v kódu nebo konfiguračních souborech. V případě provozních prostředí používejte Azure Key Vault pro ukládání citlivých tajných kódů. Více informací najdete v částech Bezpečné ukládání tajných kódů aplikace při vývoji v ASP.NET Core a Poskytovatel konfigurace Azure Key Vault. Nikdy nenahrávejte soubory .env s citlivými informacemi do správy zdrojového kódu.

Ověření nasazení

Po dokončení nasazení použijte tento seznam a pokyny v následujících sekcích k ověření nasazení.

✅ Příkaz k nasazení dokončen bez chyb
✅ Webová aplikace je spuštěna
✅ Protokoly aplikace potvrzují úspěšné spuštění
✅ Proměnné prostředí jsou konfigurovány
✅ Koncový bod pro zasílání zpráv reaguje

Ověření, že příkaz nasazení byl dokončen bez chyb

Po dokončení nasazení ověřte úspěšné dokončení v protokolech nasazení:

Přejděte do vaší webové aplikace v portálu Azure.
Přejděte na Nastavení>Konfigurace a ověřte nastavení aplikace.
Zkontrolujte záznamy o nasazení v centru nasazení.

Pro zobrazení podrobné historie nasazení:

Přejděte do Azure Portal. > Vaše webová aplikace
Nasazení>Centrum nasazení
Zobrazení protokolů posledního nasazení

Pokud sestavení selže:

Nejprve místně proveďte vyčištění a opětovné sestavení, abyste ověřili, že sestavení funguje.
Ověřte, zda nechybí některé závislost a nedochází k chybám syntaxe.
Viz Selhání příkazu nasazení.

Pokud se aplikace po nasazení zhroutí:

V protokolech vyhledejte konkrétní chybové zprávy.
Ověřte, že jsou nastaveny všechny požadované proměnné prostředí.
Viz Aplikace havaruje při spuštění.

Ověřte, že běží webová aplikace

Použijte příkaz az webapp show pro ověření, zda webová aplikace běží.

az webapp show --name <your-web-app> --resource-group <your-resource-group> --query state

Očekávaný výstup tohoto příkazu je Running.

Ověření, že protokoly aplikace vykazují úspěšné spuštění

Pro zobrazení protokolů webové aplikace v Azure Portal:

Vyhledejte webovou aplikaci podle názvu v Azure Portal.
Přejděte na Přehled>Protokoly>Stream protokolu.

Alternativně můžete použít příkaz PowerShellu az webapp log tail ke čtení protokolů webových aplikací:

az webapp log tail --name <your-web-app> --resource-group <your-resource-group>

Pokud se v protokolech vyskytují zprávy o zhroucení nebo chybové zprávy, viz Aplikace havaruje při spuštění.

Ověření konfigurace proměnných prostředí

Na webu Azure Portal:

Přejděte do své webové aplikace.
Přejděte na Nastavení>Proměnné prostředí.
Ověřte, že existují vaše nastavení.

Pokud nejsou nastaveny proměnné prostředí:

Znovu spusťte nasazení pro synchronizaci ze souboru .env.
Nebo je ručně nastavte v Azure Portal.
Viz Proměnné prostředí nejsou nastaveny nebo nejsou správné.

Ověření, že reaguje koncový bod pro zasílání zpráv

Ověřte, že koncový bod, který se nachází na stránce Přehled vaší webové aplikace, skutečně existuje, například pomocí PowerShell nebo jiných nástrojů. V opačném případě viz 404 na koncovém bodu zasílání zpráv.

Další kroky

Dále publikujte svou aplikaci agenta v centru pro správu Microsoft, abyste z ní mohli vytvářet instance agentů a uživatele.

Publikování agenta

Váš agent je nyní nasazen v cloudu a připraven reagovat na požadavky agenta. Při zpracování reálných požadavků vaším agentem zvažte další kroky pro váš kód:

Monitorujte výkon: Použijte funkce pozorovatelnosti pro sledování chování agenta a optimalizaci jeho odpovědí.
Přidejte další nástroje: Prozkoumejte katalog nástrojů pro rozšíření možností vašeho agenta.
Iterujte a vylepšujte: Aktualizujte kód agenta, znovu jej nasaďte a publikujte (nezapomeňte zvýšit číslo verze!).
Rozšiřujte agenta napříč organizací: Sdílejte úspěšné příběhy svého agenta, abyste podpořili jeho přijetí.

Řešení problému

Tato sekce popisuje běžné problémy při nasazování agentů do Azure.

Zpropitné

Průvodce odstraňováním problémů Agent 365 obsahuje doporučení k odstraňování problémů na vysoké úrovni, osvědčené postupy a odkazy na obsah o řešení problémů pro každou část životního cyklu vývoje Agent 365.

Selhání příkazu k nasazení

Příznak: Nasazení do Azure selže.

Běžné příčiny a řešení:

Chyby sestavení

Projekt znovu sestavte lokálně, abyste viděli detailní chyby při kompilaci:

# .NET
dotnet clean
dotnet build --verbosity detailed

# Python
uv build

# Node.js
npm install
npm run build

Platnost ověřování Azure vypršela

Znovu se přihlaste do Azure:
```
az login
az account show  # Verify correct subscription
```
Webová aplikace nebyla vytvořena

Zobrazte seznam webových aplikací a ověřte, že existuje cílová aplikace:
```
# List Web Apps in resource group
az webapp list --resource-group <your-resource-group> --output table
```
Kontrola protokolů nasazení

Použijte příkaz az webapp log tail pro zobrazení podrobných protokolů nasazení:
```
az webapp log tail --name <your-app-name> --resource-group <your-resource-group>
```

Ověření:

# Web App should be running
az webapp show --name <your-app-name> --resource-group <your-resource-group> --query state
# Expected: "Running"

Webová aplikace je zastavená

Příznak: Nasazení bylo úspěšné, ale webová aplikace neběží.

Řešení: Použijte az webapp start a az webapp show ke spuštění webové aplikace a ověření, že běží.

# Start the Web App
az webapp start --name <your-app> --resource-group <your-resource-group>

# Verify it's running
az webapp show --name <your-app> --resource-group <your-resource-group> --query state

Aplikace se zhroutí při spuštění

Příznak: Webová aplikace se spustí, ale okamžitě se zhroutí; protokoly obsahují chyby.

Běžné příčiny:

Chybějící závislosti – Zkontrolujte výstup sestavení, abyste se ujistili, že obsahuje všechny potřebné balíčky.
Chybějící proměnné prostředí – Ověřte, že všechny požadované proměnné prostředí jsou nakonfigurovány.
Nesoulad verzí modulu runtime – Ujistěte se, že modul runtime Azure odpovídá vašemu vývojovému prostředí.
Chyby v kódu – Zkontrolujte protokoly aplikace pro konkrétní výjimky.

Řešení: Použijte příkazy az webapp log tail, az webapp config appsettings list a az webapp config appsettings set pro zobrazení protokolů, kontrolu proměnných prostředí a nastavení chybějících proměnných.

# View application logs
az webapp log tail --name <your-app> --resource-group <your-resource-group>

# Check environment variables
az webapp config appsettings list --name <your-app> --resource-group <your-resource-group>

# Manually set a missing variable
az webapp config appsettings set --name <your-app> --resource-group <your-resource-group> --settings KEY=VALUE

404 na koncovém bodu zasílání zpráv

Příznak: Webová Aplikace běží, ale koncový bod /api/messages vrací chybu 404.

Řešení:

Ověřte konfiguraci směrování ve svém kódu agenta.
Zkontrolujte, zda je obslužná rutina koncového bodu správně registrována.
Ujistěte se, že při nasazení je správně definován vstupní bod.

Otestujte koncový bod odesláním požadavku GET na URL. Použijte příkaz az webapp config show pro kontrolu konfigurace webové aplikace.

curl https://<your-app-name>.azurewebsites.net/api/messages
az webapp config show --name <your-app> --resource-group <your-resource-group>

Proměnné prostředí nejsou nastaveny nebo nejsou správné

Příznak: Nasazení proběhne úspěšně, ale agent nefunguje; protokoly obsahují chyby kvůli chybějící konfiguraci.

Řešení: Ověřte a aktualizujte proměnné prostředí. Použijte příkazy az webapp config appsettings list a az webapp config appsettings set ke kontrole proměnných prostředí a nastavení chybějících proměnných. Poté opakujte nasazení.

# List all app settings
az webapp config appsettings list --name <your-app> --resource-group <your-resource-group>

# Set a specific variable
az webapp config appsettings set --name <your-app> --resource-group <your-resource-group> --settings API_KEY=your-value

Sestavení uspěje lokálně, ale v Azure selže

Příznak: Kód se bez problémů sestaví lokálně, ale při nasazení v Azure selže.