Teams, Copilot App and QualiChat | QualiWare Center of Excellence

Purpose

This is a helping document to update teams/copilot app config update before they are uploaded and published into Organization teams center, and also to help setup the QualiChat in QualiWare.

Role Required

1. Teams Admin

Steps/Process to upload and copilot app for an organization:

1. Download the teams/copilot app (appPackage.zip) file from QualiWare product download site.

2. Contents of this zip would need to be updated. Admin should unzip the file and use any editor to edit the manifest.json file. Need to add AppId of bot from Azure into it. $ {{BOT_ID}} should be replaced with App ID of managed Identity(that was created during Azure configurationsd) from Azure.

Refer the client id of managed identity that was created during Azure configurations. Copy the client id as BOT_ID in this manifest.json.

3. Admin should re-zip the files with updated contents with other two images files.

4. Admin should upload it as custom apps in the Teams Center and enable it for Organization. They need to make sure it is enabled only for their organization not outside of their organization.

5. Standard user in same organization should be able add the QualiWareAI agent app in the teams. Go to Apps section and click on “Built for your org” . Click on Add button in the QualiWareAI agent card.

6. User should be able to use it as Teams chat or open with copilot.

Enable QualiChat inside QualiWare

To display the QualiChat panel inside QualiWare (as shown in the screenshot),
add the required settings in:

QualiWare Admin Console → Repository Administrator → (Your Repository) → Properties

Before you begin, collect the following values from your Azure setup:

Azure OpenAI – Chat Completions URL
Obtain this from the Azure App Service – Create section of the setup guide.
Use the App Service hostname and append /api/messages, for example: https://<AZURE_APP_SERVICE_HOSTNAME>/api/messages
Azure OpenAI – Chat Completions API Key
Obtain this from the Azure App Service – Deploy section of the setup guide.
This is specifically described in Bot Application Deployment – Step 6.
Azure OpenAI – Index Name
This value must match the exact name of your QualiWare repository,
as described in Azure AI Search – Indexing (Step 9)
Optional:
If your Azure AI Search index name does not match the repository name,
you can configure the optional property
QualiChat.API.altRepId
in QualiWare and set it to the index name instead.

These values must be configured as individual key/value properties.
The examples in the following steps use placeholder values.

Add the individual properties (key/values)

Property	Value (example / placeholder)
`QualiChat.API.key`	`<YOUR_MESSAGE_API_KEY>`
`QualiChat.API.url`	`https://<AZURE_APP_SERVICE_HOSTNAME>/api/messages`
`QualiChat.API.altRepId` (Optional)	`<AZURE_AI_SEARCH_INDEX_NAME>`

Replace the placeholders with your actual values from Azure.
The optional QualiChat.API.altRepId property is only required if
your Azure AI Search index name does not match your QualiWare repository name.

Security note: store secrets only in the Repository Administrator Properties (not on public pages). Limit access to users who administer the repository.

API Architecture Metamodel

An Application Programming Interface (API) is a construct that enables communication between systems. Integration between systems in complex environments continues to be a business priority to support automation activities. An API can be purpose-built for a bespoke integration (typical of legacy systems), or alternatively a standard connector can be developed between industry standard systems such as ERP’s and Service Management platforms. Managing these integrations becomes a complex operational task as updates and new releases to the integrated systems (and enabling technologies), can lead to intensive release management and testing activities. Security is also of utmost concern when managing integrations as the API provides a potential entry-point from either system integration direction – the API has become a preferred target for malicious attacks on systems and networks.

Model Gallery

QualiWare 10.8 introduces a new Model Gallery feature. The model gallery is a visualization that enables a group of processes, integrations, or applications to be decomposed or expanded into a single canvas or gallery of models. The gallery view allows a focused view of multiple models without having to open separate tabs or windows.

Clustering

Clustering provides users with a new way of interacting with content in their repository. It provides an enhanced analysis capability directly from the 3D Visualizer by logically grouping objects based on their relationships, concepts, and definitions. Filters can be applied to the clusters through the table-based view using existing functionality to focus analysis efforts (for example only clustering objects that are related to a risk with a high impact). The number of clusters can also be defined by the user to provide a broader or more concise result.