Delen via

Azure Portal gebruiken om een Azure Bot-resource te maken

  • Artikel

VAN TOEPASSING OP: SDK v4

Met de Azure Bot-resource (botresource) kunt u uw bot registreren bij Azure AI Bot Service en uw bot verbinden met kanalen. U kunt bots bouwen, verbinden en beheren om met uw gebruikers te communiceren, waar ze ook zijn, van uw app of website naar Teams, Messenger en vele andere kanalen.

In dit artikel wordt beschreven hoe u een botresource maakt via Azure Portal.

Resources beheren

Wanneer u een botresource maakt, worden in Azure gekoppelde resources gemaakt. Sommige van de gemaakte resources zijn afhankelijk van hoe u besluit de identiteit van uw bot te beheren.

Uw bot-identiteit kan op verschillende manieren worden beheerd in Azure.

  • Als een door de gebruiker toegewezen beheerde identiteit, zodat u de referenties van de bot niet zelf hoeft te beheren.
  • Als een app met één tenant .
  • Als een app met meerdere tenants .

Ondersteuning voor de door de gebruiker toegewezen beheerde identiteit en app-typen met één tenant is toegevoegd aan de Bot Framework SDK voor C#, JavaScript en Python. Deze app-typen worden niet ondersteund in de andere talen of in Bot Framework Composer, Bot Framework Emulator of ngrok.

Type app Ondersteuning
Door de gebruiker toegewezen beheerde identiteit Azure AI Bot Service en de C#-, JavaScript- en Python SDK's
Eén tenant Azure AI Bot Service en de C#-, JavaScript- en Python SDK's
Multi-tenant Azure AI Bot Service, alle Bot Framework SDK-talen, Composer, de Emulator en ngrok

Vereisten

  • Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
  • De Bot Framework SDK voor C# of JavaScript versie 4.15.0 of hoger voor door de gebruiker toegewezen beheerde identiteit en bots met één tenant.

De resource maken

Maak de Azure Bot-resource , waarmee u uw bot kunt registreren bij de Azure AI Bot Service.

Tip

Er kunnen geen nieuwe web-app-bot - en botkanalen-registratiebronnen worden gemaakt. Bestaande resources die zijn geconfigureerd en geïmplementeerd, blijven echter werken. Bots die zijn gemaakt op basis van een VSIX- of Yeoman-sjabloon op basis van SDK-versie 4.14.1.2 of hoger, bevatten ARM-sjablonen waarmee een Azure Bot-resource wordt gegenereerd.

  1. Ga naar de Azure Portal.

  2. Selecteer een resource maken in het rechterdeelvenster.

  3. Druk in het zoekvak op Enter.bot

  4. Selecteer de Azure Bot-kaart .

    Azure-botresource selecteren

  5. Selecteer Maken.

  6. Voer waarden in de vereiste velden in en controleer en werk instellingen bij.

    1. Geef informatie op onder Project-details. Selecteer of uw bot een globale of lokale gegevenslocatie heeft. Momenteel is de functie voor lokale gegevenslocatie beschikbaar voor resources in de regio 'westeurope' en 'centralindia'. Zie Regionalization in Azure AI Bot Service voor meer informatie.

      De instellingen voor projectdetails voor een Azure Bot-resource

    2. Geef informatie op onder Microsoft App ID. Selecteer hoe uw bot-identiteit wordt beheerd in Azure en of u een nieuwe identiteit wilt maken of een bestaande identiteit wilt gebruiken.

      De microsoft-app-id-instellingen voor een Azure Bot-resource

  7. Selecteer Controleren + maken.

  8. Als de validatie is geslaagd, selecteert u Maken.

  9. Zodra de implementatie is voltooid, selecteert u Ga naar de resource. De bot en gerelateerde resources worden weergegeven in de resourcegroep die u hebt geselecteerd.

  10. Als u de Bot Framework SDK nog niet hebt, selecteert u Downloaden vanuit GitHub om te leren hoe u de pakketten voor uw voorkeurstaal kunt gebruiken.

    Bot maken in SDK

U bent nu klaar om uw bot te bouwen met de Bot Framework SDK.

Tip

Wanneer Azure een nieuwe Azure Bot-resource met één tenant of meerdere tenants met een nieuwe app-id maakt, wordt er ook een wachtwoord gegenereerd.

Informatie over botidentiteit

Volg deze stappen om identiteitsgegevens toe te voegen aan het configuratiebestand van uw bot. Het bestand verschilt, afhankelijk van de programmeertaal die u gebruikt om de bot te maken.

Belangrijk

De Java-versie van de Bot Framework SDK ondersteunt alleen bots met meerdere tenants. De C#-, JavaScript- en Python-versies ondersteunen alle drie de toepassingstypen voor het beheren van de identiteit van de bot.

Taal Bestandsnaam Opmerkingen
C# appsettings.json Ondersteunt alle drie de toepassingstypen voor het beheren van de identiteit van uw bot.
JavaScript .env Ondersteunt alle drie de toepassingstypen voor het beheren van de identiteit van uw bot.
Java application.properties Ondersteunt alleen bots met meerdere tenants.
Python config.py Ondersteunt alle drie de toepassingstypen voor het beheren van de identiteit van uw bot.

De identiteitsgegevens die u moet toevoegen, zijn afhankelijk van het toepassingstype van de bot. Geef de volgende waarden op in uw configuratiebestand.

Beschikbaar voor C#-, JavaScript- en Python-bots.

Eigenschappen Weergegeven als
MicrosoftAppType UserAssignedMSI
MicrosoftAppId De client-id van de door de gebruiker toegewezen beheerde identiteit.
MicrosoftAppPassword Niet van toepassing. Laat dit leeg voor een door de gebruiker toegewezen beheerde identiteit-bot.
MicrosoftAppTenantId De tenant-id van de door de gebruiker toegewezen beheerde identiteit.

Uw app-service bijwerken

Als u een bestaande App Service-resource (web-app) voor uw bot hebt en uw bot een door de gebruiker toegewezen beheerde identiteitstoepassing is, moet u mogelijk de app-service van uw bot bijwerken:

  1. Ga naar de blade App Service voor de web-app van uw bot.
  2. Selecteer Identiteit onder Instellingen.
  3. Selecteer op de blade Identiteit het tabblad Door de gebruiker toegewezen en voeg (+) toe .
  4. Op de blade Door de gebruiker toegewezen beheerde identiteit toevoegen:

    1. Selecteer uw abonnement.

    2. Selecteer voor door de gebruiker toegewezen beheerde identiteiten de beheerde identiteit voor uw bot. Als de beheerde identiteit automatisch voor u is gegenereerd, heeft deze dezelfde naam als uw bot.

    3. Selecteer Toevoegen om deze identiteit voor uw bot te gebruiken.

      De blade App Service Identity met de beheerde identiteit voor de bot geselecteerd.

Uw app- of tenant-id ophalen

Ga als volgt te werk om de app of tenant-id van uw bot op te halen:

  1. Ga naar de resourceblade azure-bot voor uw bot.
  2. Ga naar de blade Configuratie van de bot. Vanaf deze blade kunt u de Microsoft App ID of app-tenant-id van de bot kopiëren.

Een nieuw wachtwoord genereren

Bots met één tenant en meerdere tenants hebben een app-geheim of wachtwoord dat u nodig hebt voor bepaalde bewerkingen. Azure AI Bot Service verbergt uw botgeheim. De eigenaar van de App Service-resource van de bot kan echter een nieuw wachtwoord genereren:

  1. Ga naar de resourceblade azure-bot voor uw bot.
  2. Ga naar de blade Configuratie van de bot.
  3. Selecteer Beheren, naast De Microsoft-app-id, om naar de blade Certificaten en geheimen voor de app-service te gaan.
  4. Volg de instructies op de blade om een nieuw clientgeheim te maken en de waarde op een veilige plaats vast te leggen.

Aanvullende informatie

Notitie

Bot Framework Composer en Bot Framework Emulator ondersteunen momenteel alleen bots met meerdere tenants. De Bot Framework SDK voor C# of JavaScript versie 4.15.0 of hoger is vereist voor door de gebruiker toegewezen beheerde identiteit en bots met één tenant.

Ondersteuning voor vaardigheden

Sommige typen vaardigheidsgebruikers kunnen bepaalde typen vaardigheidsbots niet gebruiken. In de volgende tabel wordt beschreven welke combinaties worden ondersteund.

  Vaardigheid voor meerdere tenants Vaardigheid met één tenant Door de gebruiker toegewezen vaardigheden voor beheerde identiteit
Consument met meerdere tenants Ondersteund Niet ondersteund Niet ondersteund
Consument met één tenant Niet ondersteund Ondersteund als beide apps deel uitmaken van dezelfde tenant Ondersteund als beide apps deel uitmaken van dezelfde tenant
Door de gebruiker toegewezen beheerde identiteitgebruiker Niet ondersteund Ondersteund als beide apps deel uitmaken van dezelfde tenant Ondersteund als beide apps deel uitmaken van dezelfde tenant

Zie Een vaardigheid implementeren of een consument implementeren voor informatie over het configureren van een vaardigheid of vaardigheidsgebruiker.

Volgende stappen