> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Kore Agent AI integration guide

**Artemis** is the next-generation agent platform for designing, deploying, and operating intelligent agent systems. The platform unifies conversational AI and agentic AI under a single programming model, so a single agent definition can combine deterministic workflows with autonomous reasoning.

Configuring Artemis in Agent AI generates better next best action (NBA) suggestions in the Agent AI widget.

## Prerequisites

Before configuring Artemis in Agent AI, verify you meet the following prerequisites on Artemis side:

* An active project. For more details, see [Create and manage projects](/agent-platform/projects).
* A configured model. For more details, see [Create models](/agent-platform/administration/general-settings#models).
* An active agent. For more details, see [Create agents](/agent-platform/create-agents).
* An active deployment. For more details, see [Create a deployment](/agent-platform/deployment#create-a-deployment).
* An active connection. For more details, see [Channels](/agent-platform/channels).

## Configure Artemis in Agent AI

### Step 1: Set up a connection in Artemis

1. Sign in to **Artemis**.
2. Create a **Project**, if you don't have one.
3. Go to **Agents** and create an agent.
4. Go to **Deployments** > **Environments** and create a deployment in one of the following environments — **Development**, **Staging**, or **Production**.
5. Go to the **Channels** tab and locate the **Kore Agent Assist** channel.
6. Select **Kore Agent Assist** and select **+ New**.
7. In the **New Kore Agent Assist Connection** window, enter the following details:
   | **Field**      | **Description**                      |
   | -------------- | ------------------------------------ |
   | Display Name   | Enter a name for the connection.     |
   | Environment    | Select an environment from the list. |
   | Initial Status | Select Active or Inactive.           |
8. Select **Create**.
9. Select the connection you created.
10. In the **Overview** tab, note the **Domain URL**, **Environment**, **App ID**, and **API Key**. The App ID is the project ID, and the system generates the API Key when you create the connection.

    <Note> Copy and store the **API Key** for future use, as it is visible only once. If you lose it, select the channel you created, go to the **Overview** tab, and select **Rotate** to regenerate the API key. </Note>

### Step 2: Configure an Artemis app in Agent AI

Configuring an Artemis app in Agent AI is a three-step process: entering app details, selecting conversation metadata, and adding custom metadata.

**First request trigger**

Select one of the following options to define how Artemis receives its first request. These options are mutually exclusive.

| Option                                                        | Description                                                                                              |
| ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Use 'Trigger Welcome message' as the first request to Agentic | Sends a welcome message to Artemis as soon as the widget loads, regardless of any customer message.      |
| Pass landing summary as first request to Agentic App          | Sends the bot-customer conversation's landing summary as the first request to Artemis on agent transfer. |

<Note> If you don't select either option, Artemis doesn't generate NBAs until the customer sends a message. </Note>

**App details**

| Field       | Description                                                                 |
| ----------- | --------------------------------------------------------------------------- |
| App Name    | A name for the app (up to 50 characters). For example, Travel Agent.        |
| Domain URL  | The Artemis app's host URL. For example, `https://agents-staging.kore.ai/`. |
| Environment | The environment name as configured in the Artemis app.                      |
| App ID      | The Artemis app ID generated in the Artemis app.                            |
| API Key     | The API key from the Artemis app's API Key section.                         |

**Conversation metadata**

Select the metadata to pass to the Artemis app. This preserves context during transfers from automation to human agents.

| Metadata                    | Description                                                                         |
| --------------------------- | ----------------------------------------------------------------------------------- |
| Landing Summary             | Summary of the customer-bot conversation before transfer to a human agent.          |
| Agent-Customer Chat History | Conversation history between the customer and human agent up to the latest message. |
| Custom Data                 | Collected custom data.                                                              |
| Intermittent Summary        | Agent-generated mid-conversation summary.                                           |

**Custom metadata**

Add a custom metadata script in the code editor to pass to the Artemis app. The system validates and highlights errors as you enter the script.

To configure an Artemis app:

1. Sign in to **AI for Service**.
2. Go to **Agent AI** > **Configurations** > **Linked Services** > **Agentic Configuration**.
3. Select **+ Add Agentic Copilot App**.
4. Enter the app name.
5. Enter the **Domain URL**, **Environment**, **App ID**, and **API Key** from your Artemis app.
6. Select **Use 'Trigger Welcome message' as the first request to Agentic** or **Pass landing summary as first request to Agentic App**.
7. Expand the **Pass Metadata** section and select the metadata to pass.
8. Expand the **Add Custom Metadata** section and enter your script in the code editor. Use the **enlarge** or **copy** buttons as needed.
9. Select **Test Connection & Save**.