Uw agent handmatig implementeren in Azure

Voor het uitvoeren van een SDK voor Microsoft 365-agenten in Azure zijn de volgende stappen vereist:

Dit document behandelt het uitrollen van een agent die je hebt gemaakt naar Azure en Teams of Microsoft Copilot.

Als u nog geen agent hebt gemaakt, begint u met quickstart: Een basisagent maken en testen met C#.

Uw agent publiceren naar Azure als web-app

  1. Implementeer uw agentcode in Azure. Een Agents SDK-agent is een webtoepassing. Als u uw agent wilt publiceren, kunt u de normale methoden gebruiken om een webtoepassing te implementeren in Azure:

    • Implementeren als een ZIP-pakket in een Azure App Service-app
    • Visual Studio publiceren naar een Azure App Service-app of -container
    • Andere containerimplementaties die worden ondersteund door Azure
    • Implementatie van Microsoft 365 Agents Toolkit

Important

Als u een Azure App Service-app gebruikt en ofwel federatieve referentiegegevens of een door de gebruiker toegewezen beheerde identiteit gebruikt, moet u die identiteit toevoegen onder Settings>Identity.

Zodra uw agentcode is geïmplementeerd, heeft deze een basis-URL, zoals example.azurewebsites.net.

  1. Ga in Azure naar uw Azure Bot-resource. Wijzig onder Configuratie het Berichteindpunt in op https://{yourwebsite}/api/messages. Vervang {yourwebsite} door de basis-URL van uw web-app.

Testen in Webchat

Als u uw bericht in webchat wilt zien, selecteert u Testen in webchat in uw Azure Bot-resource en verzendt u berichten naar uw agent.

Bereid je Teams- en Microsoft Copilot-manifest voor

Voor Microsoft Teams en Microsoft Copilot moet je een manifest maken en uploaden. Het is niet mogelijk om een voorbeeld te geven dat alle behoeften van Teams of Microsoft Copilot dekt. Teams-functies vereisen specifieke manifestinhoud.

Deze stappen bieden een overzicht van een eenvoudige Teams-agent in chatstijl.

  1. Maak een lege map in uw project.
  2. Kopieer de inhoud van Teams-manifestbestanden naar de map.
  3. Open manifest.json in de map en voer de volgende bewerkingen uit:
    • Overal waar u de tijdelijke aanduiding <<AAD_APP_CLIENT_ID>> ziet, vervangt u die door de ClientId voor uw Azure Bot-resource.
    • Vervang <<BOT_DOMAIN>> door de basis-URL van uw agent.
    • Zip de inhoud van de map om een manifest.zip te maken met de inhoud:
      • manifest.json
      • outline.png
      • color.png

Implementeren in Microsoft 365

  1. Zorg ervoor dat uw Azure Bot-resource het Microsoft Teams-kanaal heeft toegevoegd onder Kanalen.

  2. Navigeer naar de Microsoft-beheerportal (MAC).

  3. Onder Instellingen en Geïntegreerde apps, selecteert u Aangepaste app uploaden.

  4. Selecteer het manifest.zip bestand dat u in de vorige sectie hebt gemaakt en upload het.

Na een korte periode verschijnt de agent in Microsoft Teams en Microsoft Copilot.