> ## 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.

# Set up AI for Work

<Badge icon="arrow-left" color="gray">[Back to channels](/agent-platform/channels)</Badge>

Connect your agent to Kore.ai AI for Work, the Employee Experience (EX) platform, as a bidirectional messaging integration. Employees reach the agent through a published Autonomous Agent in AI for Work, and AI for Work reaches the agent through an endpoint URL and connection secret that you generate in Artemis.

<Note>Artemis labels this channel **AIforWork**. The product it connects to is documented as AI for Work. This article uses **AIforWork** for the on-screen label and AI for Work for the product.</Note>

## Before you begin

You need administrator access to the AI for Work Admin Console and permission to create and publish Autonomous Agents in the target workspace. You also need a project in Artemis with at least one deployed version in the environment you plan to bind the connection to.

Create the connection in Artemis first. The endpoint URL and connection secret it generates are the inputs to the AI for Work side of the setup.

## Create the channel connection in Artemis

<Steps>
  <Step title="Enter the connection details">
    Open Artemis, select the required project, and go to **Deployments** -> **Channels** -> **AIforWork** -> **+ New**. On the **New AIforWork Connection** dialog, provide the following fields.

    | Field                              | Description                                                                                                                                                                         |
    | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Display Name**                   | A label for the connection, for example `AIforWork Production`. Up to 255 characters.                                                                                               |
    | **Environment**                    | Select an environment to follow its active deployment. If no environment has an active deployment yet, leave the default and bind the connection later from the **Deployment** tab. |
    | **Provider Verification Strength** | **Weak (default)** or **Strong**. Choose **Strong** only for channels or providers whose identity assertions you trust for stronger continuity and linking decisions.               |
    | **Initial Status**                 | **Active** connections can be used immediately. **Inactive** connections stay saved but disabled until you activate them. Set this to **Active**.                                   |

    Select **Create**.
  </Step>

  <Step title="Copy the endpoint URL and connection secret">
    The **AIforWork Connection Created** dialog shows the **Endpoint URL** and the **Connection Secret**. Copy both values and store the secret securely, then select **Done**.

    <Warning>The connection secret appears only once and can't be retrieved afterward. If you lose it, open the connection and select **Rotate** on the **Overview** tab to issue a new one. Rotating the secret invalidates the previous value, so update the AI for Work configuration with the new secret.</Warning>

    AI for Work uses the endpoint URL and secret to sign its requests with HMAC.
  </Step>
</Steps>

## Link the connection in AI for Work

<Steps>
  <Step title="Create the Autonomous Agent">
    1. Open the AI for Work Admin Console, switch to the target workspace, and go to **AI Agents** -> **Autonomous Agents**.
    2. Select **Create agent**, then create the agent from scratch.
    3. Enter the agent name and the purpose of the app. AI for Work uses the purpose for query routing and training.
  </Step>

  <Step title="Add the Artemis credentials">
    1. In **Configure agentic app**, select **Add using credentials**.
    2. On the **Link using credentials** dialog, enter the **Endpoint URL** and the **Connection Secret** you copied from Artemis.
    3. Select **Run and Save**.

    <Tip>Select **Browse and Link Projects** on the same dialog to pick the app directly from an Agent Platform workspace instead of entering credentials. Use the credentials method when the agent is in a workspace you can't browse from AI for Work, or when you want the connection pinned to a specific Artemis channel connection.</Tip>
  </Step>

  <Step title="Set the execution mode">
    Select **Async** as the mode and test the connection. A successful test reports that the async connection succeeded.

    Async mode suits agents that take longer than the 60-second sync timeout. When you use async mode, set the **Callback Base URL** on the Artemis connection's **Configuration** tab so the agent can return responses and proactive notifications to AI for Work.
  </Step>

  <Step title="Publish the agent">
    Select **Continue**, then select **Publish**. Choose whether to publish to everyone in the account or to limited users. For the full set of publishing options, see the [AI for Work custom agents documentation](https://docs.kore.ai/ai-for-work/custom-agents#publishing-your-agent).
  </Step>
</Steps>

## Key values reference

| Value                 | Where it comes from                                                                          | Where it's used                                                                      |
| --------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| **Endpoint URL**      | The **AIforWork Connection Created** dialog in Artemis, or the connection's **Overview** tab | The **Endpoint URL** field on the AI for Work **Link using credentials** dialog      |
| **Connection Secret** | The **AIforWork Connection Created** dialog in Artemis; shown only at creation time          | The **Connection Secret** field on the AI for Work **Link using credentials** dialog |
| **Callback Base URL** | Your AI for Work instance                                                                    | The **Callback Base URL** field on the Artemis connection's **Configuration** tab    |

## Pass custom metadata

AI for Work can pass custom metadata to the connected Artemis app. In **Configure agentic app**, open **\</> Meta Data** and add the metadata you want to send.

Inside Artemis, the expression that reads the metadata differs by surface. The following examples read an `email` key.

| Surface       | Expression                          |
| ------------- | ----------------------------------- |
| Agent         | `{{_metadata.email}}`               |
| Workflow tool | `{{vars._session._metadata.email}}` |
| HTTP tool     | `{{session._metadata.email}}`       |

## Manage the channel connection

Opening a connection from **Deployments** -> **Channels** -> **AIforWork** shows three tabs: **Overview**, **Configuration**, and **Deployment**. The header shows the connection name, the bound environment, the status, and the channel type, along with **Pause** and delete actions.

<Tabs>
  <Tab title="Overview">
    The **Connection Summary** shows these fields.

    | Field           | Description                          |
    | --------------- | ------------------------------------ |
    | **Status**      | For example: *Active*                |
    | **Created**     | Timestamp the connection was created |
    | **Updated**     | Timestamp of the last change         |
    | **Environment** | For example: `dev`                   |
    | **Source Type** | `Channel Connection`                 |
    | **Source ID**   | Unique connection identifier (UUID)  |

    Under **Setup Instructions**, the tab shows the **Endpoint URL** to enter in AI for Work and the masked **Connection Secret**. Select **Rotate** to issue a new secret. The full secret is shown only at creation time and can't be retrieved.
  </Tab>

  <Tab title="Configuration">
    Under **General**, configure the following.

    | Field                              | Description                                                                                                                                                           |
    | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Display Name**                   | The label for the connection.                                                                                                                                         |
    | **Provider Verification Strength** | **Weak (default)** or **Strong**. Choose **Strong** only for channels or providers whose identity assertions you trust for stronger continuity and linking decisions. |

    Under **AIforWork Settings**, configure the following.

    | Field                 | Description                                                                                                                       |
    | --------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
    | **Callback Base URL** | The base URL where ABL sends async responses and proactive notifications. Required when AI for Work uses the async response mode. |

    #### Authorization message

    The **Authorization Message** panel controls the message shown when a tool needs the user to authorize. Edit the **Message template** directly, or use the **Insert** buttons to add the most common variables at the cursor.

    The default template asks the user to authorize the pending verifications and then lists each one as a numbered profile name with its authorization link.

    Expand **Show variables** to see the full set of supported variables.

    | Scope         | Variables                                                                  | Notes                                                                                        |
    | ------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
    | Message scope | `{{total}}`, `{{completed}}`, `{{remaining}}`                              | Counts for the session's pending authorizations. Use these anywhere in the template.         |
    | Item scope    | `{{profileName}}`, `{{authLink}}`, `{{authUrl}}`, `{{index}}`, `{{count}}` | Valid only inside the repeat block.                                                          |
    | Repeat block  | `{{#authorizations}}`, `{{/authorizations}}`                               | Wraps the item scope variables and repeats the enclosed text once per pending authorization. |

    Expand **Show preview** to see the template rendered with sample values. At runtime the platform fills these from the live session's pending authorizations.

    Select **Save Changes** to apply any changes.
  </Tab>

  <Tab title="Deployment">
    The **Deployment** tab shows these fields.

    | Field                 | Description                                                                                                             |
    | --------------------- | ----------------------------------------------------------------------------------------------------------------------- |
    | **Agent Version**     | An **Environment** dropdown (for example: `Development`) that selects which deployed version handles incoming messages. |
    | **Active Deployment** | Shows the bound deployment version and when it was deployed.                                                            |

    Select **Save Changes** after switching the environment.
  </Tab>
</Tabs>