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: Een basisagent maken en testen voor meer informatie over het maken van een agent.
• 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 bot-resource maakt, maakt Azure bijbehorende resources. Sommige van de gemaakte resources zijn afhankelijk van hoe u besluit de identiteit van uw bot te beheren.

De identiteit van uw bot kan op verschillende manieren worden beheerd in Azure:

• Als door de gebruiker toegewezen beheerde identiteit hoeft u referenties dus niet handmatig te beheren.
• Als een app met één tenant .
• Als multitenant-app.

Ondersteunde app-typen

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.

1. Ga naar de Azure Portal.

2. Selecteer in het rechterdeelvenster Een resource maken.

3. Voer bot in het zoekvak in en druk vervolgens op Enter.

4. Selecteer de Azure Bot-kaart .

   

5. Selecteer Aanmaken.

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 gegevensresidentie beschikbaar voor resources in de regio's "westeurope" en "centralindia". Zie Regionalization in Azure AI Bot Service voor meer informatie.

      

   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.

      

7. Selecteer Beoordelen + maken.

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

9. Zodra de implementatie is voltooid, selecteert u Ga naar de resource. U zou de bot en de bijbehorende resources vermeld moeten zien 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.

    

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

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 wordt gebruikt om de bot te maken.

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

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 App Service-blade voor de web-app van uw bot.
2. Selecteer Identiteit onder Instellingen.
3. Selecteer op de blade Identiteit het tabblad Door gebruiker toegewezen en Toevoegen (+).
4. Op het blad 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.

      

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 van Azure Bot van uw bot.
2. Ga naar de blade van de bot Configuratie. 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 het geheim van uw bot. De eigenaar van de App Service-resource van de bot kan echter een nieuw wachtwoord genereren:

1. Ga naar de resourceblade van Azure Bot van uw bot.
2. Ga naar de blade van de bot Configuratie.
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 in de blade om een nieuw clientgeheim aan te maken en noteer de waarde op een veilige plaats.

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.

Ondersteuning voor vaardigheden

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

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

Volgende stappen

• Een bot maken met Bot Framework Composer
• Quickstart: Een basisagent maken en testen