# AI for ITSM

Welcome to AI for ITSM - the self-service, AI agent builder from Aisera.

<div align="left"><figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2FhWBmMyXUP59sGsH6WeOa%2Flogin_unify.png?alt=media&#x26;token=0e24e46b-10b3-4c13-addd-90bc4ca58806" alt="" width="563"><figcaption></figcaption></figure></div>

The login screen takes you directly to a default application/bot that uses the [**Aisera Assistant**](https://aisera.com/products/ai-assistant/) channel. The Aisera Gen AI platform will enable editing options according to your user permissions.

<div align="left"><figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2FuWFL8WYFUKqlucrQMpur%2Fassistant1.png?alt=media&#x26;token=bd426b2c-cf20-4119-a508-ca25d7eb5d6d" alt="" width="563"><figcaption></figcaption></figure></div>

The default application/bot represents what your users will see after you have finished setting up the bot. The options on the left navigation menu are end-user features for the completed application/bot. \
\
The **Aisera Assistant User Guide** discusses these options.

### Building Your Bot <a href="#integration-setup" id="integration-setup"></a>

The Administrator for your application/bot is usually the first person to log into the Unify application. If you are the Customer Administrator, the **AI Agent Platform** button will be enabled on your application.

<div align="left"><figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2FtwndDXK1wvSsz9AcYB2h%2Fai_agent_platform.png?alt=media&#x26;token=5f37dc1a-930f-4003-a35d-68668d8e597c" alt="" width="212"><figcaption></figcaption></figure></div>

Choose the **AI Agent Platform** button to see the Administrator options.

#### Setting Up Knowledge Sources <a href="#integration-setup" id="integration-setup"></a>

The first step in setting up your new application/bot is connecting knowledge sources that your bot can use to answer Requests. If you have Administrator privileges, the **Connect knowledge sources** button is active when you scroll over it.

<figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2FxHg0NmmosEAhQqgjokqt%2Fconnect_data.png?alt=media&#x26;token=7f3079c7-c01f-4aee-81ab-12d2026e310d" alt=""><figcaption></figcaption></figure>

The AI Agent Platform connects to your knowledge source using OAuth authorization that requires an API Key to retrieve data. At this point, you need to get an API Key for your knowledge source or find the Administrator for your company's knowledge source who can provide you with the credentials to get an API Key.

<figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2FlLrw8WBOSrVdms34ve66%2Fdata_source.png?alt=media&#x26;token=e6d8d8f4-55f5-49c5-8b8e-82af212fa40e" alt=""><figcaption></figcaption></figure>

After you have the knowledge source credentials, you are ready to begin.

#### Connect a Knowledge Source

To add a knowledge source, click the **Connect knowledge sources** button and follow the steps in the configuration wizard.

<div align="left"><figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2FxtTojtqA7Xl4VQW9mjEz%2F3_sections.png?alt=media&#x26;token=3bdf9f15-c0d8-45df-9cf9-1ce0ef80e2f6" alt="" width="563"><figcaption></figcaption></figure></div>

The **Connect knowledge sources** and the **AI Agent Platform** buttons both open the **Admin Workbench**.

1. The **Connect Knowledge Sources** (middle) section of the workbench shows you the connections that are available for your application/bot.
2. The lower section is a conversation window that you can use to test as you build your application.
3. The upper-right section shows you what you have completed so far.

#### Choose a Private Knowledge Source

When see a pill button for a private knowledge source, it means that the knowledge source has fields that are pre-mapped from the source to the Aisera Gen AI platform. However, you still need to add the authorization credentials and any required API Tokens from your company's private knowledge source.\
\
If the data source is already connected (has the word Connected under it), then you can skip this step.

At the current time, **Confluence** and **SharePoint** are the supported data source connections.

<div align="left"><figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2FIgTHSJN3Xb3Su0GukiDa%2Fconfluence_pill.png?alt=media&#x26;token=f57c407a-dd36-46c0-848f-efeef3129a90" alt="" width="155"><figcaption></figcaption></figure></div>

If you select the Confluence button, the [**New Credentials for Confluence**](https://docs.aisera.com/unify/unify/new-credentials-for-confluence) form guides you through the integration

<div align="left"><figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2FhQxk7cCNoNel6vBmeG0t%2FSharePoint.png?alt=media&#x26;token=68e7367c-da32-4ee2-b3aa-1c370219240c" alt="" width="149"><figcaption></figcaption></figure></div>

If you select the SharePoint button, the [**New Credentials for SharePoint**](https://docs.aisera.com/unify/unify/new-credentials-for-sharepoint) form guides you through the integration.

### Add the Connection Credentials

After you choose a Private Knowledge Source, you can add new credentials.

<div align="left"><figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2FllClQUh7qTuncSZRZdbN%2Fnew_cred.png?alt=media&#x26;token=d16ec681-f3d0-4cee-ba45-8aee819e8fb0" alt="" width="563"><figcaption></figcaption></figure></div>

Or you can choose existing credentials from the pull-down list.

<div align="left"><figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2FXjZvwwHXsqxphdeRmoLV%2Fexisting_cred.png?alt=media&#x26;token=817971b6-0109-4f2a-a340-4cc5abcf2277" alt="" width="563"><figcaption></figcaption></figure></div>

Select the button for the knowledge source that you want to associate with your application/bot.

Although integration parameters are similar, each knowledge source has specific requirements for connection that you will need to provide or have your knowledge source Admin provide.

#### Choose a Public Knowledge Source

You can use a public knowledge source to provide content for your application/bot. Be aware that this could cause a lot of unstructured or non-specific answers, based on the public site or domain that you're using.\
\
**To choose a Public Knowledge Source:**

A public knowledge source is a URL that contains publicly available information that you want your application/bot to pull from to provide answers for requests.

1. website Click the **Public Sources** pill button in the **Connect Knowledge Sources** window.
2. Type in the address for a publicly available web site that contains useful fulfillment content for your application/bot.

<figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2FDVUdxc5rKkspJmsnTf2t%2Fpublic_know.png?alt=media&#x26;token=697acb6f-ea1f-4fa1-b495-810ea51feaf7" alt=""><figcaption></figcaption></figure>

3. Click the **Add** button at the far right.&#x20;

{% hint style="info" %}
Note that only web addresses that contain "http\://" will be included as correctly formatted sources. If you get a 'Invalid URL(s)' error, check your spelling, address, and syntax.
{% endhint %}

After you have uploaded private data sources or pointed to public data source, you can see and test the responses in your Aisera Assistant.

### Retrieve Answers from Uploaded Data

In the screenshot below, the right-side displays the **Admin Workbench**, where the **Progress Tracker** shows you that data has been uploaded from both Confluence and SharePoint data sources.

<figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2FziTkhsBpVeLnihKDnAvH%2Fcode_of_conduct.png?alt=media&#x26;token=12dde8be-f71f-493c-afee-c9c1bffd264f" alt=""><figcaption></figcaption></figure>

At the top of the screen, you can see that a user has asked the Aisera Assistant, "`What is the code of conduct?`"  The Aisera Assistant has located and displayed a document that outlines the code of conduct. This content was in the data that was uploaded from one of the data sources.

### Citations

If a retrieved document contains citations, as shown in the screenshot below, you can click on the citation link to see the referenced document.

<figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2F5R6ayCHLFOnNgE0v4m7N%2Fcitation_click.png?alt=media&#x26;token=b83d4143-b634-42b0-9cd3-e48ea1d61598" alt=""><figcaption></figcaption></figure>

The referenced document is usually a longer version of the answer returned by the Aisera Assistant.

<figure><img src="https://1452355326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG57AmqCbftA0rZngdds2%2Fuploads%2FXRmsOw4FydVCJNNMuubd%2Fconfluence_article.png?alt=media&#x26;token=8da97cf6-274e-4f7a-8c14-90b19ab7dd87" alt=""><figcaption></figcaption></figure>
