Testování agentů pomocí Dev Tunnels

Pomocí Dev Tunnels můžete testovat svého agenta Agent 365 s aplikacemi Microsoft 365 (například Teams, Outlook nebo Word), zatímco agent běží lokálně na vašem vývojovém počítači. Tento přístup propojuje lokální vývoj a testování v reálném prostředí, takže můžete ověřit chování agenta v prostředích Microsoft 365 před nasazením do cloudu.

Předpoklady

Před použitím Dev Tunnels se ujistěte, že máte nainstalovaný nástroj příkazového řádku Dev Tunnels.

Nastavení vývojového tunelu

Nastavte vývojový tunel, abyste zpřístupnili koncový bod místního agenta službám Microsoft 365.

Vytvoření a spuštění tunelu

  1. Přihlaste se do Dev Tunnels:

    devtunnel user login

  2. Vytvořte trvalý tunel:

    devtunnel create --allow-anonymous

    Tento příkaz vrací ID tunelu. Uložte si tento identifikátor pro pozdější použití.

  3. Konfigurujte port tunelu:

    Zadejte port, který používá server vašeho agenta (obvykle 3978):

    devtunnel port create <tunnel-id> -p <port-number>

  4. Spusťte tunel:

    devtunnel host <tunnel-id>

    Příkaz zobrazí URL tunelu (například https://abc123xyz.devtunnels.ms:3978). Zkopírujte tuto URL pro další krok.

Zpropitné

Použijte devtunnel list ke zobrazení všech tunelů a devtunnel delete <tunnel-id> k odstranění tunelů, které již nepotřebujete.

Konfigurace koncového bodu pro zasílání zpráv agenta

Zaregistrujte URL pro vývojový tunel (například https://abc123xyz.devtunnels.ms:3978/api/messages) jako koncový bod pro zasílání zpráv agenta, aby služba Microsoft 365 věděla, kam směrovat zprávy. Nezapomeňte na příponu /api/messages u koncového bodu.

Další informace naleznete v části Nastavení koncového bodu pro zasílání zpráv agenta

Testování v Microsoft 365

S aktivním vývojovým tunelem a registrovaným koncovým bodem otestujte svého agenta v aplikacích Microsoft 365.

Testování v Microsoft Teams

  1. Spusťte svého místního agenta podle pokynů v části Instalace závislostí a spuštění serveru aplikace agenta.

  2. Ověřte možnosti připojení tunelu:

    devtunnel list

    Zkontrolujte, že váš tunel vykazuje aktivní připojení hostitele. Sloupec „Připojení hostitele“ by měl zobrazovat číslo větší než 0.

  3. Komunikujte se svým agentem v aplikaci Teams:

    • Otevřete Microsoft Teams (webová nebo desktopová aplikace)
    • Ve vyhledávacím poli Teams vyhledejte svého agenta podle jména nebo e-mailu
    • Zahajte konverzaci s agentem
    • Pošlete zprávu a sledujte odpověď
    • Zkontrolujte místní konzoli pro příchozí požadavky a aktivitu agenta

Testování e-mailových oznámení

Pokud je váš agent nastaven na e-mailová oznámení:

  1. Pošlete e-mail na e-mailovou adresu svého agenta
  2. Přidejte svého agenta do kopie e-mailového vlákna
  3. V místní konzoli čekejte na webhook oznámení
  4. Ověřte, že váš agent zpracoval a odpověděl na e-mail

Testování integrace s Word

Pro agenty odpovídající na komentáře v aplikaci Word:

  1. Otevřete dokument Word, ke kterému má váš agent přístup.
  2. Přidejte komentář, ve kterém zmíníte svého agenta.
  3. V místní konzoli sledujte zobrazení oznámení.
  4. Ověřte, že odpověď vašeho agenta je zobrazena v aplikaci Word.

Monitorování aktivity tunelů

Dev Tunnels poskytuje inspekci přenosů, aby pomohl ladit problémy s připojením a pochopit tok požadavků:

devtunnel show <tunnel-id>

Tento příkaz zobrazuje:

  • Aktivní připojení a podrobnosti relace.
  • Informace o požadavcích a odpovědích.
  • Statistiky objemu přenosu.
  • Chyby a varování ohledně připojení.

Aktivitu tunelu můžete také monitorovat v reálném čase pomocí výstupu z příkazu devtunnel host.

Udržování připojení tunelů

Dev Tunnels vyžaduje, aby proces devtunnel host zůstal spuštěný. Pokud dojde k přerušení připojení kvůli neaktivitě, problémům v síti nebo uspání počítače, musíte tunel restartovat.

Zkontrolujte stav tunelu

Ověřte, zda je váš tunel aktivní:

devtunnel list

Ve výstupu se zobrazí:

  • ID tunelu: ID vašeho tunelu
  • Připojení hostitele: Počet aktivních připojení (měl by být jedno nebo více, když běží devtunnel host)
  • Porty: Konfigurované porty
  • Expirace: Doba vypršení tunelu

Pokud Připojení hostitele vykazují 0, tunel existuje, ale momentálně není hostován.

Restart odpojeného tunelu

Pokud je přerušeno připojení k tunelu, restartujte jej pomocí stejného ID tunelu:

devtunnel host <tunnel-id>

Adresa URL tunelu zůstává stejná, takže nemusíte aktualizovat konfiguraci koncového bodu pro zasílání zpráv agenta.

Během vývoje udržujte tunely aktivní

Pro udržení stabilních připojení:

  • Nechte okno terminálu otevřené – Nezavírejte terminál, ve kterém běží tunel devtunnel host.
  • Zabraňte uspání počítače – Nakonfigurujte systém tak, aby se během testování neuspal.
  • Sledujte chyby připojení – Monitorujte výstup terminálu devtunnel host, zda neobsahuje zprávy o odpojení.
  • Restartujte po změně sítě – Pokud přepnete síť nebo se znovu připojíte k VPN, restartujte tunel.

Zpropitné

Pokud se váš tunel často odpojuje, zkontrolujte nastavení sítě a nastavení brány firewall, abyste se ujistili, že neblokují připojení.

Vyčištění

Až dokončíte testování pomocí Dev Tunnels:

Ukončete tunel

Stiskněte Ctrl+C v terminálu, ve kterém běží devtunnel host, abyste zastavili tunel.

Tento příkaz odstraní adresu URL vývojářského tunelu z koncového bodu pro zasílání zpráv agenta. Při nasazení do provozního prostředí nastavte URL koncového bodu hostovaného v cloudu.

Poznámka:

Tunel zůstává k dispozici pro budoucí použití, dokud jej explicitně nesmažete použitím devtunnel delete <tunnel-id>.

Omezení

Zvažte tato omezení při testování pomocí Dev Tunnels:

  • Pouze pro vývoj: Používejte Dev Tunnels pouze pro vývoj a testování, ne pro provoz.
  • Výkon: Vzhledem ke směrování sítě očekávejte vyšší latenci než u cloudových agentů.
  • Stabilita připojení: Připojení tunelů mohou občas vypadnout a vyžadovat ruční restart.
  • Bezpečnostní aspekty: Příznak --allow-anonymous je praktický pro testování, ale nepoužívejte ho s citlivými daty.
  • Správa relací: Možná budete muset čas od času znovu ověřit totožnost v závislosti na délce relace.

Další kroky

Po úspěšném otestování vývojářského tunelu:

Řešení problému

Pokud narazíte na problémy při testování prostřednictvím Dev Tunnels, začněte zde s běžnými opravami tunelů, možností připojení a koncových bodů. Pro podrobnější řešení problémů se službou Agent 365 (nastavení, ověřování a zasílání zpráv) najdete v sekci Řešení problémů.

Chyba připojení tunelu

Příznaky: Vývojový tunel se nespustí nebo se ihned odpojí.

Řešení:

  • Ověřte, že jste přihlášeni: devtunnel user login
  • Zjistěte, zda jiný proces používá stejný port
  • Ujistěte se, že brána firewall umožňuje připojení vývojového tunelu
  • Odstraňte a znovu vytvořte tunel: devtunnel delete <tunnel-id>, pak vytvořte nový

Zprávy nejsou doručeny místnímu agentovi

Příznaky: Microsoft 365 uvádí, že zpráva byla odeslána, ale místní agent ji neobdrží.

Řešení:

  • Ověřte, že váš agent běží lokálně
  • Ověřte, že tunel je aktivní: devtunnel list by měl vykazovat „Připojeno“
  • Zkontrolujte konfiguraci koncového bodu v a365.config.json a ověřte, že adresa URL vývojového tunelu je nastavena jako koncový bod pro zasílání zpráv
  • Zkontrolujte chyby připojení v protokolech vývojového tunelu v terminálu, ve kterém běží devtunnel host
  • Ujistěte se, že váš lokální port odpovídá portu tunelu (oba by měly být ve výchozím nastavení 3978)

Chyby ověřování prostřednictvím vývojového tunelu

Příznaky: Chyby 401 nebo 403 při testování přes vývojový tunel.

Řešení:

  • Ověřte, že je nakonfigurováno ověřování agenta (ověřování pomocí nosného tokenu nefunguje s Dev Tunnels v případě integrace s Microsoft 365).
  • Zkontrolujte přihlašovací údaje podrobného plánu agenta v a365.generated.config.json.
  • Ověřte, že váš agent má potřebná oprávnění pro operace, které testujete.
  • Ujistěte se, že nevypršely vaše tokeny ověřování.

Adresa URL tunelu byla změněna nebo vypršela

Příznaky: Dříve funkční adresa URL tunelu již nesměruje na vašeho agenta.

Řešení:

  • Zkontrolujte stav tunelu pomocí devtunnel list.
  • Restartujte tunel pomocí devtunnel host <tunnel-id>.
  • Pokud se změnila adresa URL, aktualizujte koncový bod pro zasílání zpráv pomocí a365 setup blueprint --endpoint-only.
  • Last updated on