Azure Portal gebruiken om een Azure Bot-resource te maken
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.
- Zie de quickstart over het maken van een bot met de Bot Framework SDK voor meer informatie over het maken van een bot.
- Zie hoe u uw bot in Azure implementeert en publiceert voor meer informatie over het inrichten en publiceren van een bot in Azure.
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# en JavaScript in versie 4.15.0. 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# en JavaScript SDK's |
| Eén tenant | Azure AI Bot Service en de C# en JavaScript 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.
Ga naar de Azure-portal.
Selecteer een resource maken in het rechterdeelvenster.
Druk in het zoekvak op Enter.
botSelecteer de Azure Bot-kaart .
Selecteer Maken.
Voer waarden in de vereiste velden in en controleer en werk instellingen bij.
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.
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.
Selecteer Controleren + maken.
Als de validatie is geslaagd, selecteert u Maken.
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.
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.
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- en Python-versies van de Bot Framework SDK ondersteunen alleen bots met meerdere tenants. De C#- en JavaScript-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 alleen bots met meerdere tenants. Geef de identiteitseigenschappen op als argumenten voor de os.environ.get methode-aanroepen. |
De identiteitsgegevens die u moet toevoegen, zijn afhankelijk van het toepassingstype van de bot. Geef de volgende waarden op in uw configuratiebestand.
Alleen beschikbaar voor C# en JavaScript-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:
- Ga naar de blade App Service voor de web-app van uw bot.
- Selecteer Identiteit onder Instellingen.
- Selecteer op de blade Identiteit het tabblad Door de gebruiker toegewezen en voeg (+) toe .
- Op de blade Door de gebruiker toegewezen beheerde identiteit toevoegen:
Selecteer uw abonnement.
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.
Selecteer Toevoegen om deze identiteit voor uw bot te gebruiken.
Uw app- of tenant-id ophalen
Ga als volgt te werk om de app of tenant-id van uw bot op te halen:
- Ga naar de resourceblade azure-bot voor uw bot.
- 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:
- Ga naar de resourceblade azure-bot voor uw bot.
- Ga naar de blade Configuratie van de bot.
- Selecteer Beheren, naast De Microsoft-app-id, om naar de blade Certificaten en geheimen voor de app-service te gaan.
- Volg de instructies op de blade om een nieuw clientgeheim te maken en de waarde op een veilige plaats vast te leggen.
Aanvullende informatie
- Zie Wat is Microsoft Entra-id?voor informatie over identiteitsbeheer met Microsoft Entra ID.
- Zie het App Service-overzicht voor informatie over Azure-app Service- en App Service-abonnementen.
- Zie het overzicht van Azure Resource Manager voor informatie over Azure-resources en hoe ze in het algemeen worden beheerd.
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.