> For the complete documentation index, see [llms.txt](https://docs.aisera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisera.com/ai-ops/how-to-setup-ai-ops/configure-an-aisera-potential-issue.md).

# Configure an Aisera Potential Issue

You can create an **Aisera** **Potential Issue (PI)** by choosing tickets that you want to combine to define the incident.

<div align="left"><figure><img src="/files/oXnA1XX8AQmY1UTJH6yB" alt="" width="561"><figcaption></figcaption></figure></div>

Select **Gen AI Learning -> Ticket Learning** from the left navigation menu of the Aisera Administration Application. For more controls, add `?system` at the end of the URL.&#x20;

After you have finalized the relevant set of tickets, we will initiate the ticket learning job by configuring the parameters.

#### Step 1 - Configuring “Conditions” Parameters <a href="#pdf-page-wgtif7ydajmizn7i0ppx-step-1-configuring-conditions-parameters" id="pdf-page-wgtif7ydajmizn7i0ppx-step-1-configuring-conditions-parameters"></a>

1. Go to **Actions → Configuration**
2. Add the relevant conditions of the field name of the interest. These fields are self explanatory and users can easily relate to the fields in their respective ticketing system.

   <figure><img src="https://open.gitbook.com/~gitbook/image?url=https%3A%2F%2F146899349-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FGNCq9s8hwlJ0ofHi7XPJ%252Fuploads%252Fe83zUptP7afndxKr2xFo%252Fset_condition_field_name.png%3Falt%3Dmedia%26token%3D49f91e5a-999e-4e9e-944c-a65f4252ef7e&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=6fea566e&#x26;sv=1" alt=""><figcaption></figcaption></figure>

**Notes:**

* It is recommended that you set Max Ticket Count to 60,000.
* 60,000 ticket count is a healthy sample size. If we don’t limit ticket count we could possibly ingest a large number of tickets causing the job to run for multiple days and delay results.
* The conditions that we put here are later converted into a SQL query to fetch the filtered data from the Tickets database.
* Multiple selections for a single field will be of “OR” equivalent while multiple field name conditions will be of “AND” type. E.g., Conditions on Data Source and Creation Date are included by “AND” operator while Gap Prod - Incidents and Gap Prod - Ticket Learning data sources will be incorporated as “OR” if both selected.

#### Step 2 - Configuring “Preprocessor” Parameters <a href="#pdf-page-wgtif7ydajmizn7i0ppx-step-2-configuring-preprocessor-parameters" id="pdf-page-wgtif7ydajmizn7i0ppx-step-2-configuring-preprocessor-parameters"></a>

Sometimes despite scanning through tickets and assessing their quality, we might find ourselves in a situation where we have some unnecessary tickets which we should exclude.

1. We can choose what fields we want TL to be performed on, i.e., Title or Description or Both from Fields to Process
2. In the Inclusion/Exclusion Rules section, we can add specific conditions on Title/Description to filter tickets based on certain keywords.
3. Substitutions help you to substitute certain keywords in the text before passing it through the TL pipeline.
4. There are several other preprocessing options also provided which can be used pending any special requirement.

#### Step 3 - Configuring “Scoring” Parameters <a href="#pdf-page-wgtif7ydajmizn7i0ppx-step-3-configuring-scoring-parameters" id="pdf-page-wgtif7ydajmizn7i0ppx-step-3-configuring-scoring-parameters"></a>

Use the following definitions to determine how you want to set the scoring parameters.

**Skip ICM :** This option will provide the coverage of intents from Tickets. Check this option, if you only want to generate the ontology and eliminate the unnecessary data processing steps. However there is no harm in running this option either.

**Join Title and Description:** If checked, ticket title and description will be considered during the scoring process.

**Use Global Ontology (Entities):** Check if you want to use the Ontology from the content pack.

**Discover Ontology Synonyms(Entities):** Extract the synonyms from KB for the entities generated from Entity Discovery and validate against tickets, if usage found in the tickets those are extracted and attached to the entities

**Use Global Taxonomy (Intents):** Check if you want to use the Taxonomy (Intents) from the content pack

**Text Field char limit:** Maximum number of characters to consider in title and description

**Text Field word limit:** Maximum number of words consider in the title and description

<figure><img src="https://open.gitbook.com/~gitbook/image?url=https%3A%2F%2F146899349-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FGNCq9s8hwlJ0ofHi7XPJ%252Fuploads%252F0VaH1Dm0FPFYfBygGegh%252Fgen_learning_tickets.png%3Falt%3Dmedia%26token%3Ddec54b05-ac5b-4d9c-b3ca-169bb6eb2c5b&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=9544c186&#x26;sv=1" alt=""><figcaption></figcaption></figure>

#### Step 4 - Kick off Ticket Learning job <a href="#pdf-page-wgtif7ydajmizn7i0ppx-step-4-kick-off-ticket-learning-job" id="pdf-page-wgtif7ydajmizn7i0ppx-step-4-kick-off-ticket-learning-job"></a>

Click on ‘**Start Learning Job**’ after you set the conditions and configurations. You will get an acknowledgement saying the job has triggered and is in progress. We can monitor the status by clicking on ‘View Job’ in the acknowledgement or by navigating to **Settings-> System Jobs -> Generic Jobs** and then search for **Ticket Learning**.

## Creating Incidents from Existing Tickets

To create a **Potential Issues** from Existing Tickets:

1. Select an existing AI Ops agent by choosing **Settings > AiseraGPT**  from the left navigation menu of the Aisera Administrationi Application.
2. Choose **AI Observability > Potential Issues** from the left navigation menu of the Aisera Administration Application.\
   \
   ![](/files/WEu7c8sJG0yPUvFQ4Ehh)
3. Choose existing tickets that you want to add to your Incident.
4. Click the **+ New Potential Issues** button.&#x20;
5. Fill in the information for the Incident. Include the **Root Cause**, if you know it.\
   \ <br>

   <div align="left"><figure><img src="/files/XHarCvuO1mCmbJiJoA6h" alt="" width="561"><figcaption></figcaption></figure></div>
6. Fill in the **Cluster Name** and **Cluster Conditions**.
7. Click **OK**.\ <br>

   <figure><img src="/files/5VMoOyN1bYjc0rzmNIcL" alt=""><figcaption></figcaption></figure>
8. Choose the **Save Potential Issues** button.<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.aisera.com/ai-ops/how-to-setup-ai-ops/configure-an-aisera-potential-issue.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
