Använda Azure-portalen för att skapa en Azure Bot-resurs
GÄLLER FÖR: SDK v4
Med Azure Bot-resursen (robotresursen) kan du registrera din robot med Azure AI Bot Service och ansluta din robot till kanaler. Du kan skapa, ansluta och hantera robotar för att interagera med dina användare var de än befinner sig, från din app eller webbplats till Teams, Messenger och många andra kanaler.
I den här artikeln beskrivs hur du skapar en robotresurs via Azure-portalen.
- Information om hur du skapar en robot finns i snabbstarten Skapa en robot med Bot Framework SDK .
- Information om hur du etablerar och publicerar en robot till Azure finns i Distribuera din robot i Azure.
Hantera resurser
När du skapar en robotresurs skapar Azure associerade resurser. Vissa av de resurser som skapas beror på hur du bestämmer dig för att hantera robotens identitet.
Din robotidentitet kan hanteras i Azure på några olika sätt.
- Som en användartilldelad hanterad identitet så att du inte behöver hantera robotens autentiseringsuppgifter själv.
- Som en app för en enda klientorganisation .
- Som en app för flera klientorganisationer .
Stöd för de användartilldelade apptyperna för hanterad identitet och en klientorganisation har lagts till i Bot Framework SDK för C# och JavaScript i version 4.15.0. Dessa apptyper stöds inte på andra språk eller i Bot Framework Composer, Bot Framework Emulator eller ngrok.
| Apptyp | Support |
|---|---|
| Användartilldelad hanterad identitet | Azure AI Bot Service och C# och JavaScript SDK:er |
| Enskild klientorganisation | Azure AI Bot Service och C# och JavaScript SDK:er |
| Flera klientorganisationer | Azure AI Bot Service, alla Bot Framework SDK-språk, Composer, emulatorn och ngrok |
Förutsättningar
- Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.
- Bot Framework SDK för C# eller JavaScript version 4.15.0 eller senare för användartilldelade hanterade identiteter och robotar med en enda klientorganisation.
Skapa resursen
Skapa Azure Bot-resursen så att du kan registrera din robot med Azure AI Bot Service.
Dricks
Det går inte att skapa nya registreringsresurser för webbappsrobotar och robotkanaler . Alla befintliga resurser som är konfigurerade och distribuerade fortsätter dock att fungera. Robotar som skapats från en VSIX- eller Yeoman-mall från SDK version 4.14.1.2 eller senare innehåller ARM-mallar som genererar en Azure Bot-resurs.
Gå till Azure-portalen.
I den högra rutan väljer du Skapa en resurs.
I sökrutan anger du
botoch trycker sedan på Retur.Välj Azure Bot-kortet.
Välj Skapa.
Ange värden i de obligatoriska fälten och granska och uppdatera inställningarna.
Ange information under Projektinformation. Välj om din robot ska ha global eller lokal dataplacering. För närvarande är funktionen lokal datahemvist tillgänglig för resurser i regionen "westeurope" och "centralindia". Mer information finns i Regionalisering i Azure AI Bot Service.
Ange information under Microsoft App-ID. Välj hur robotidentiteten ska hanteras i Azure och om du vill skapa en ny identitet eller använda en befintlig.
Välj Granska + skapa.
Om valideringen godkänns väljer du Skapa.
När distributionen är klar väljer du Gå till resurs. Du bör se roboten och relaterade resurser i den resursgrupp som du har valt.
Om du inte redan har Bot Framework SDK väljer du Ladda ned från GitHub för att lära dig hur du använder paketen för önskat språk.
Nu är du redo att skapa din robot med Bot Framework SDK.
Dricks
När Azure skapar en ny Azure Bot-resurs med en enda klientorganisation eller flera klientorganisationer med ett nytt app-ID genereras även ett lösenord.
Information om robotidentitet
Följ de här stegen för att lägga till identitetsinformation i robotens konfigurationsfil. Filen skiljer sig beroende på vilket programmeringsspråk du använder för att skapa roboten.
Viktigt!
Java- och Python-versionerna av Bot Framework SDK stöder endast robotar för flera klientorganisationer. C#- och JavaScript-versionerna stöder alla tre programtyperna för att hantera robotens identitet.
| Språk | Filnamn | Kommentar |
|---|---|---|
| C# | appsettings.json | Stöder alla tre programtyperna för att hantera robotens identitet. |
| JavaScript | .Env | Stöder alla tre programtyperna för att hantera robotens identitet. |
| Java | application.properties | Stöder endast robotar med flera klientorganisationer. |
| Python | config.py | Stöder endast robotar med flera klientorganisationer. Ange identitetsegenskaperna som argument för metodanropen os.environ.get . |
Identitetsinformationen som du behöver lägga till beror på robotens programtyp. Ange följande värden i konfigurationsfilen.
Endast tillgängligt för C#- och JavaScript-robotar.
| Property | Värde |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
Klient-ID för den användartilldelade hanterade identiteten. |
MicrosoftAppPassword |
Ej tillämpbart. Lämna detta tomt för en användartilldelad hanterad identitetsrobot. |
MicrosoftAppTenantId |
Klientorganisations-ID för den användartilldelade hanterade identiteten. |
Så här uppdaterar du din apptjänst
Om du har en befintlig App Service-resurs (webbapp) för din robot och roboten är ett användartilldelat program för hanterad identitet kan du behöva uppdatera robotens apptjänst:
- Gå till App Service-bladet för robotens webbapp.
- Under Inställningar väljer du Identitet.
- På bladet Identitet väljer du fliken Användartilldelad och Lägg till (+).
- På bladet Lägg till användartilldelad hanterad identitet:
Välj din prenumeration.
För Användartilldelade hanterade identiteter väljer du den hanterade identiteten för din robot. Om den hanterade identiteten genererades automatiskt åt dig har den samma namn som roboten.
Välj Lägg till för att använda den här identiteten för din robot.
Hämta din app eller ditt klient-ID
Så här hämtar du robotens app- eller klient-ID:
- Gå till Azure Bot-resursbladet för din robot.
- Gå till robotens konfigurationsblad. På det här bladet kan du kopiera robotens Microsoft App-ID eller appklient-ID.
Så här genererar du ett nytt lösenord
Robotar med en klientorganisation och flera klientorganisationer har en apphemlighet eller ett lösenord som du behöver för vissa åtgärder. Azure AI Bot Service döljer din robothemlighet. Ägaren till robotens App Service-resurs kan dock generera ett nytt lösenord:
- Gå till Azure Bot-resursbladet för din robot.
- Gå till robotens konfigurationsblad.
- Välj Hantera bredvid Microsoft App-ID för att gå till bladet Certifikat + hemligheter för apptjänsten.
- Följ anvisningarna på bladet för att skapa en ny klienthemlighet och registrera värdet på en säker plats.
Ytterligare information
- Information om identitetshantering med Microsoft Entra-ID finns i Vad är Microsoft Entra-ID?.
- Information om Azure App Service- och App Service-planer finns i Översikt över App Service.
- Information om Azure-resurser och hur de hanteras i allmänhet finns i Översikt över Azure Resource Manager.
Kommentar
Bot Framework Composer och Bot Framework-emulatorn stöder för närvarande endast robotar för flera klientorganisationer. Bot Framework SDK för C# eller JavaScript version 4.15.0 eller senare krävs för användartilldelade hanterade identiteter och robotar med en enda klientorganisation.
Kompetensstöd
Vissa typer av kunskapskonsumenter kan inte använda vissa typer av kunskapsrobotar. I följande tabell beskrivs vilka kombinationer som stöds.
| Kompetens för flera klientorganisationer | Kompetens för enskild klientorganisation | Användartilldelad kompetens för hanterad identitet | |
|---|---|---|---|
| Konsument för flera klientorganisationer | Stöds | Stöds inte | Stöds inte |
| Enskild klientorganisationskonsument | Stöds inte | Stöds om båda apparna tillhör samma klientorganisation | Stöds om båda apparna tillhör samma klientorganisation |
| Användartilldelad hanterad identitetskonsument | Stöds inte | Stöds om båda apparna tillhör samma klientorganisation | Stöds om båda apparna tillhör samma klientorganisation |
Information om hur du konfigurerar en kunskaps- eller kunskapskonsument finns i Implementera en färdighet eller Implementera en kunskapskonsument.