Copilot integration guide
Foreword
This guide gives an overall view of how Copilot integration works with DeliwiAi software, how it is installed and workarounds for possible issues. This document is intended for IT administrators responsible for the installation of DeliwiAi. It should be noted that Copilot and Microsoft Graph Connectors are relatively new technologies and like all new Microsoft tech, they can and will cause issues during installation and usage.
Overall architecture
DeliwiAi is connected to Copilot via Microsoft Graph Connectors. During the installation process, a connector is created by DeliwiAi server backend and schema is installed. Connector creation process is done using Entra application identity (which is consented by
administrator during the installation).
DeliwiAi backend will update user data periodically to the connector. As of the time of writing this guide, the update is done every 60 minutes, the exact timing depending on the backend startup time.
Graph connector results must be added to the All Search Vertical for Copilot to be able to access them.
DeliwiAi stores the connector id into CosmosDB.
Installation process
1. Follow DeliwiAi installation process
2. The Graph connector is created during the Teamsbot installation process.
3. Connector creation should be completed after 15 minutes from the creation process
4. Enable the connector results in the All Vertical
5. DeliwiAi will update indexes periodically. Number of indexed items can be seen in the connector info
DeliwiAI –installer
The installer can be started from address, sent to the admin email after software packages have been pushed to Azure resources.
Before going to the installer, please accept companywide consents links from the completion email. As of 07.05.2024 these links do not forward browser properly and give errors (even though consent was given succesfully).
Upon navigating to the DeliwiAi setup page, the installer will use pop-ups to ask for a second set of Entra ID consents. Some browsers block these by default. Unblock pop-ups from the site and reload/refresh site again to get it working.
In the installation process, teamsbot application will be installed (as of 07.05.2024, teamsbot installation through installer does not work and must be installed manually, see below).
The installer will also ask which people from Entra ID will be given admin status. Ensure that you give yourself admin status to avoid getting locked out of the system.
Teamsbot installation
Currently Teams bot must be manually installed to company Teams application catalog.
This can be done from Teams admin center:https://admin.teams.microsoft.com/policies/manage-appsFrom top right corner select “Actions” and “Upload new app”. Upload Teams bot manifest.zip there and email created “App ID” to Deliwi team (see email in the beginning).
Download the manifest.zip below:
We will get back to you when the backend setup has been done.
Possible issues and workarounds
The installation process fails to create a working connector
This can randomly happen. To fix this problem, DeliwiAi engineers must install the connector manually. Please send an email to contact@decliving.com and include your Tenant ID in the email.
