Test en lokal agent med en udviklertunnel

En udviklingstunnel giver Azure Bot Service et offentligt HTTPS-endpoint, der videresender anmodninger til din lokalt kørende agent. Brug en tunnel, når du skal teste gennem Microsoft Teams, Microsoft 365 Copilot eller en anden kanal, der ikke kan forbinde direkte til localhost.

For tests, der ikke kræver en hostet kanal, brug i stedet Microsoft 365 Agents Playground.

Forudsætninger

Før du starter:

• Kør din agent lokalt og identificer dens port. Agents SDK-samples bruger port 3978 som standard.
• Provisionér en Azure Bot-ressource og aktivér den kanal, du vil teste.
• Konfigurér agentforbindelsen med legitimationsoplysninger, der matcher Azure Bot-ressourcen.
• Installer devtunnel CLI. For installationsmuligheder på Windows, macOS og Linux, se Opret og host en tunnel.

Vigtigt!

Brug en klienthemmelighed eller certifikat til lokal test gennem en udviklingstunnel. Administreret identitet og fødererede legitimationsoplysninger kræver, at agentkoden kører i sit konfigurerede Azure-hostingmiljø.

Start agenten

Kør agenten og verificér, at dens aktivitetsendepunkt lytter lokalt. Standardendepunktet er:

http://localhost:3978/api/messages

Hvis dit projekt bruger en anden port eller rute, brug den værdi i de følgende trin.

Opret og vært for tunnelen

Log ind i udviklertunneler:

devtunnel user login

Host den lokale agentport:

devtunnel host -p 3978 --allow-anonymous

--allow-anonymousgør det muligt for Azure Bot Service at nå det offentlige tunnel-endepunkt. Agentautentificering validerer stadig anmodninger ved /api/messages.

Kommandoen returnerer en offentlig URL, der ligner følgende:

https://<tunnel-id>-3978.<region>.devtunnels.ms

Hold kommandoen kørende, mens du tester.

Konfigurer Azure Bot-meddelelsesendepunktet

1. I Azure-portalen skal du åbne din Azure Bot-ressource.

2. Vælg Indstillinger>Konfiguration.

3. Sæt Messaging-endpointet til den offentlige tunnel-URL efterfulgt af din agentrute:

   https://<tunnel-id>-3978.<region>.devtunnels.ms/api/messages
   

4. Gem konfigurationen.

Hvis tunnel-URL'en ændrer sig, opdater beskedendepunktet, før du tester igen. Du kan oprette en persistent navngiven tunnel, hvis du har brug for en stabil URL; se CLI-referencen for udviklertunneler.

Test gennem kanalen

Send en besked til agenten fra den konfigurerede kanal. Anmodningen flyder fra kanalen til Azure Bot Service, gennem udviklingstunnelen og ind i det lokale /api/messages endepunkt.

Brug dev tunnel inspect URL'en, som CLI'en viser, til at diagnosticere, om anmodninger når tunnelen. Brug dine agentlogs til at diagnosticere autentificerings-, routing- og håndterfejl, efter at anmodningen når den lokale proces.

Advarsel!

En offentlig tunnel eksponerer den valgte lokale port for internettet. Kør kun den service, du har tænkt dig at teste, hold autentificeringen aktiveret, og stop tunnelen, når testen er færdig.