Dela via


Använd Azure Portal 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.

Den här artikeln beskriver hur du skapar en robotresurs via Azure Portal.

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 användartilldelade hanterade identiteter och apptyper med en enda klient lades till i Bot Framework SDK för C#, JavaScript och Python. Dessa apptyper stöds inte på andra språk eller i Bot Framework Composer, Bot Framework Emulator eller Dev Tunnels.

Apptyp Support
Användartilldelad hanterad identitet Azure AI Bot Service och SDK:er för C#, JavaScript och Python
Enskild klientorganisation Azure AI Bot Service och SDK:er för C#, JavaScript och Python
Flera klientorganisationer Azure AI Bot Service, alla Bot Framework SDK-språk, Composer, emulatorn och Dev Tunnels

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.

  1. Gå till Azure-portalen.

  2. I den högra rutan väljer du Skapa en resurs.

  3. I sökrutan anger du botoch trycker sedan på Retur.

  4. Välj Azure Bot-kortet.

    Välj Azure-robotresurs

  5. Välj Skapa.

  6. Ange värden i de obligatoriska fälten och granska och uppdatera inställningarna.

    1. 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.

      Inställningarna för projektinformation för en Azure Bot-resurs

    2. 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.

      Microsofts app-ID-inställningar för en Azure Bot-resurs

  7. Välj Granska + skapa.

  8. Om valideringen godkänns väljer du Skapa.

  9. 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.

  10. 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.

    Skapa robot i SDK

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-versionen av Bot Framework SDK stöder endast robotar med flera klientorganisationer. C#-, JavaScript- och Python-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 alla tre programtyperna för att hantera robotens identitet.

Identitetsinformationen som du behöver lägga till beror på robotens programtyp. Ange följande värden i konfigurationsfilen.

Tillgänglig för C#-, JavaScript- och Python-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:

  1. Gå till App Service-bladet för robotens webbapp.
  2. Under Inställningar väljer du Identitet.
  3. På bladet Identitet väljer du fliken Användartilldelad och Lägg till (+).
  4. På bladet Lägg till användartilldelad hanterad identitet:
    1. Välj din prenumeration.

    2. 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.

    3. Välj Lägg till för att använda den här identiteten för din robot.

      Bladet App Service-identitet med den hanterade identiteten för den valda roboten.

Hämta din app eller ditt klient-ID

Så här hämtar du robotens app- eller klient-ID:

  1. Gå till Azure Bot-resursbladet för din robot.
  2. 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:

  1. Gå till Azure Bot-resursbladet för din robot.
  2. Gå till robotens konfigurationsblad.
  3. Välj Hantera bredvid Microsoft App-ID för att gå till bladet Certifikat + hemligheter för apptjänsten.
  4. 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.

Nästa steg