Create the Agentic AI Bot

this section describes how to integrate with microsoft teams bot to create a custom teams app this enhanced integration improves user experience by streamlining itsm interactions directly within microsoft teams prerequisites enable the global constant from the configuration console > global constants > intelligentbotintegrationenabled > set it to true for more information, refer to list of global constants docid\ dgb4v84edr0axvy7mlnnf enable the chat feature if you plan to enable live agent transfer for any agent on the ai configuration hub > agentic ai > agent settings page this allows the microsoft teams bot users to interact with analysts who respond via webchat to learn how to enable the chat feature, refer to configuring the chat feature docid\ ek9ni60x4zyjksob1ocq6 ensure microsoft teams application is installed on your computer with admin credentials it is recommended to set up the chat application first, followed by the teams bot application creating the teams app from microsoft teams app studio log in to your microsoft teams account and open the microsoft teams developer portal https //dev teams microsoft com/home clients must have an account for the teams bot to function in the microsoft teams developer portal , the new user interface opens by default when customers access it, without requiring any additional configuration go to home , click create a new app in the create a new app window, provide a name for the app and select latest stable as manifest version and click create in the configuration page, click basic information enter the following details fields description app details short name and long name contextual names of the app app id this is auto generated by microsoft app studio version version number short description and long description contextual descriptions of your app developer/company name your company name website your company website url privacy statement url to the privacy statement of your organization terms of use url to the terms of use or policy page of your organization ensure that you fill in the app details (short name and long name) and the description fields (short description and long description) if any of these fields are not filled in, the app upload might fail optionally, click branding to add a branding logo or other elements of your organization click save create the microsoft teams bot app you need to create, configure, generate client secret key and link a bot to microsoft teams app create a bot log in to microsoft teams developer portal https //dev teams microsoft com/home go to apps click the app you created from the app list go to app features and then click bot select an existing bot from the dropdown or click create a new bot in the bot management , a list of existing bots is displayed to create a new bot, click new bot and enter a name for the bot, then click create bot configure the bot once the new bot is created, it automatically takes you to the configure page you need the bot id to complete the integration between microsoft teams and the bot id is displayed in the url copy and save the bot id from the url, which is the value between /bots/ and /configure example https //dev teams microsoft com/bots/your bot id/configure in the configure page, enter the bot endpoint address and click save the bot endpoint address should be in the following format https //{customer tenant id}/ivantibotservice/intelligentbot/api/messages? to maintain secure communication, restrict public access to the bot endpoint address revealing the endpoint will result in unauthorized access or misuse of the bot service only the itsm tenant address should be publicly accessible generate the client secret key for the bot on the side panel, click client secrets > create your first client secret > create client secret copy and save the secret key to use when configuring the integration between neurons for itsm and microsoft team app click done this client secret key is displayed only once ensure you save it securely link the bot to the microsoft teams app now that you have created the bot, go through the following steps to link the bot to the microsoft teams app in the microsoft teams developer portal https //dev teams microsoft com/ , go to the app , select your app from the list click on app features and click bot choose a bot from the select an existing bot dropdown or manually enter the bot id , you want to configure in the what can your bot do? section, select upload and download files under scope , select personal checkbox, and click save download the package for the microsoft teams go to publish > publish to org , and then click publish on the upper right corner of the page in the new ui of the microsoft teams developer portal, the distribute button appears in the upper right corner instead of publish select the download the app package from the pop up to download the app package for the microsoft teams bot app if this app is intended for organization‑wide use, share it with your it administrator and publish it to your organization for testing or demo purposes, download the app package and deploy it individually in your teams instance upload the new package using one of the following methods through the teams admin center directly in microsoft teams, depending on your deployment method verify that the updated version is installed and available to users this step is required by microsoft to ensure the app is properly packaged and ready for deployment within microsoft teams uploading the app in microsoft teams you can upload the teams app and make it available for employees in your organization to use only when the app is uploaded and available, users can add it to their microsoft teams client app and use it as a communication channel to chat with agentic ai log in to your microsoft teams account go to apps > manage your apps > upload an app choose an option upload a custom app – if the app is for individual or team use submit an app to your org – if the app is for organization wide use the app you built is now available for employees in your organization or team to use configure email address for microsoft teams bot access to use the microsoft teams bot with your itsm account, ensure that your email address is correctly configured in the itsm portal these steps applicable only to ism users log in to and go to the employee workspace create a new user record and enter the username and email address in the appropriate fields ensure that the user has the role specified in the defaultagenticaiuserrole global constant, or the self service user role if the defaultagenticaiuserrole global constant is not defined on the roles tab, use the link option to add the appropriate role save the changes by default, changes takes up to 30 minutes to avoid this and to reflect changes in the microsoft teams bot, clear the cache perform the following go to settings > cache management click on reset teamsbot objects this configuration step is not required for non ism users to learn how to use the agentic ai bot, refer to the sample use case docid\ ginnta2rklqrrvajebpqo