# Jira

The **Jira** data source in Epsilla allows users to connect and retrieve issues directly from their Jira projects or specific issues. This type of data source is ideal for managing tickets, project progress, and collaboration data stored in **Jira**.

### Select Knowledge Base Type

Choose **Jira** to continue.

<figure><img src="https://2532879721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM0ZX7fId7ifK45ldHWEp%2Fuploads%2FJu4n9AVL4OgSXTNRjLig%2FScreenshot%202024-12-24%20at%2012.05.19%E2%80%AFPM.png?alt=media&#x26;token=dba4f0a2-59f4-4bac-a2fa-4af94fa09504" alt="" width="325"><figcaption></figcaption></figure>

### Knowledge Base Name

Provide a **Knowledge Base Name**. A valid name should start with a letter or `_`, and can contain only letters, digits, underscores, and whitespaces. Example: `MyJiraDocs`.

<figure><img src="https://2532879721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM0ZX7fId7ifK45ldHWEp%2Fuploads%2Fbuj3lO4DnX57pTlkCQbu%2FScreenshot%202024-12-24%20at%2012.05.49%E2%80%AFPM.png?alt=media&#x26;token=e8737bd2-875d-4990-97c1-6e83708fa078" alt="" width="563"><figcaption></figcaption></figure>

### Configure Jira Connection

Fill in the required fields to connect your Jira instance:

1. **Base URL**: The URL of your Jira instance (e.g., `https://yourcompany.atlassian.net`).
2. **Token**: A Jira API token generated for your account. To access your Jira API token:
   * Log in to your Atlassian account.
   * Navigate to your profile settings.
   * Select **"Create and manage API tokens"** under the Security section.
   * Generate a new API token and copy it.
3. **User Name**: The email address associated with your Jira account.

<figure><img src="https://2532879721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM0ZX7fId7ifK45ldHWEp%2Fuploads%2FWfvwrbbJMzptLtZFMWnh%2FScreenshot%202024-12-24%20at%2012.07.03%E2%80%AFPM.png?alt=media&#x26;token=62714df4-aac2-4bc1-9383-2b97c6a5bba0" alt="" width="563"><figcaption></figcaption></figure>

### Load Data from Jira

There are two options for specifying the data to load from **Jira**:

1. **Project Key**: Provide the key of the Jira project to load all issues from that project.
2. **Issue Keys**: Specify individual issue keys to load selected tickets. If issue keys are provided, the project key will be ignored.

<figure><img src="https://2532879721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM0ZX7fId7ifK45ldHWEp%2Fuploads%2FXZ4LxEiFyCj1OlFcgBDH%2FScreenshot%202024-12-24%20at%2012.07.36%E2%80%AFPM.png?alt=media&#x26;token=b8867d42-593c-42ca-a6c4-0da849bc5132" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2532879721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM0ZX7fId7ifK45ldHWEp%2Fuploads%2FWy3nOU599vFuEJ8DPPju%2FScreenshot%202024-12-24%20at%2012.07.55%E2%80%AFPM.png?alt=media&#x26;token=e8d26c6f-66c5-4023-835c-d2af43c4f41b" alt="" width="563"><figcaption></figcaption></figure>

To add multiple issue keys:

* Click **Add Multiple Issue Keys**, enter the keys separated by new lines, and click **Add**.

<figure><img src="https://2532879721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM0ZX7fId7ifK45ldHWEp%2Fuploads%2FYptIAkO8kbf0cGsXRhhp%2FScreenshot%202024-12-24%20at%2012.08.20%E2%80%AFPM.png?alt=media&#x26;token=f690f0ec-da04-4516-bc7d-f1b193b55433" alt="" width="375"><figcaption></figcaption></figure>

### Data Processing

Once the connection details are entered, click **Create**:

Epsilla will automatically process the tickets. During this process, the platform loads, chunks, and embeds the documents into vectors for efficient retrieval. You can monitor the progress of data processing in real-time:

<figure><img src="https://2532879721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM0ZX7fId7ifK45ldHWEp%2Fuploads%2FhDTqvYwChJ40rjjM0raa%2FScreenshot%202024-12-24%20at%2012.08.40%E2%80%AFPM.png?alt=media&#x26;token=b44375e4-1a19-42de-a6a4-3bd0eb097ad9" alt="" width="563"><figcaption></figcaption></figure>

After the data is processed, the list of pages imported from **Jira** will be visible in the **Loaded Issues** section. Tickets that are ready for use will be marked as **Ready**, while those still processing will show a status of **Processing data**.

<figure><img src="https://2532879721-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM0ZX7fId7ifK45ldHWEp%2Fuploads%2FQ8Y3tLRGBMu0V9G3L4hI%2FScreenshot%202024-12-24%20at%2012.09.20%E2%80%AFPM.png?alt=media&#x26;token=bd52339b-e5b7-46dd-a21f-6199acc5a3d9" alt="" width="563"><figcaption></figcaption></figure>

You can update or edit your Jira configuration by navigating to the **Data Sources** tab under your knowledge base.
