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

# Kore AI

> Run chat simulations against Kore AI Agent Platform apps

<Badge color="purple">Chat simulations</Badge> <Badge color="gray" stroke>Live monitoring</Badge> <Badge color="gray" stroke>Voice simulations</Badge>

## Overview

The Kore AI integration connects an app on the [Kore AI Agent Platform](https://docs.kore.ai/agent-platform/) to Roark for [chat simulations](/documentation/simulation-testing/chat-simulations). Roark talks to your app over the Agent Platform v2 HTTP API — bootstrapping a session, sending each persona turn through `/runs/execute`, and tearing the session down when the conversation ends.

***

## Prerequisites

Before connecting, you'll need from the Kore AI Agent Platform:

* An **App ID** (UUID) for the agent app you want to test
* An **Environment name** the app is deployed to (e.g. `production`)
* An **API key** (`x-api-key`) with permission to create sessions and execute runs against that app
* The **base URL** of your Kore tenant, if you're on a non-default or self-hosted Kore domain. Most customers can leave this blank and Roark will use `https://agent-platform.kore.ai/api/v2`.

See the [Kore AI Agent Platform API reference](https://docs.kore.ai/agent-platform/apis/agentic-apps/overview/) for where to find these in the Kore console.

***

## Creating the Integration in Roark

<Steps>
  <Step title="Open the integration form">
    Navigate to **Settings → Integrations**, click **Add Integration**, and select **Kore AI**.
  </Step>

  <Step title="Fill in the configuration">
    | Field                     | Description                                                                                                                    |
    | :------------------------ | :----------------------------------------------------------------------------------------------------------------------------- |
    | **Integration Name**      | Friendly name for this integration                                                                                             |
    | **API Key**               | Your Kore `x-api-key`. Stored encrypted at rest.                                                                               |
    | **App ID**                | UUID of the Kore agent app                                                                                                     |
    | **Environment**           | Environment name the app is deployed to (e.g. `production`)                                                                    |
    | **Base URL** *(optional)* | Override the Kore API base URL for enterprise or self-hosted deployments. Defaults to `https://agent-platform.kore.ai/api/v2`. |
  </Step>

  <Step title="Save">
    On save, Roark stores the credentials encrypted and auto-provisions:

    * One **Roark agent** named after the integration
    * One **`KORE` chat endpoint** linked to the integration

    The endpoint is immediately usable in run plans. Credentials never leave the integration — the endpoint references them by ID.
  </Step>
</Steps>

<Note>
  In edit mode, leave the **API Key** field blank to keep the existing key. Only fill it in if you want to rotate the credential.
</Note>

***

## How Conversations Are Driven

Each chat simulation runs through a three-leg session lifecycle against your Kore app:

| Phase         | Request                                                                                                                                                                                          |
| :------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Bootstrap** | `POST {baseUrl}/apps/{appId}/environments/{env}/sessions` — creates a session and returns a session reference.                                                                                   |
| **Per turn**  | `POST {baseUrl}/apps/{appId}/environments/{env}/runs/execute` — sends the persona's message as text input under the bootstrapped session, and reads the agent's reply from `outputs[0].content`. |
| **Teardown**  | `POST {baseUrl}/apps/{appId}/environments/{env}/sessions/terminate` — closes the session when the chat ends.                                                                                     |

All requests are sent with your `x-api-key` in the header. The API key is decrypted in memory only for the lifetime of the chat session and is never logged.

***

## What's Not Supported

* **Voice simulations** — Kore AI integrations are chat-only in Roark.
* **Live monitoring / call import** — Roark does not pull historical conversations from Kore. Chat simulations are the way to evaluate your Kore app's behavior in Roark.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Run Chat Simulations" icon="play" href="/documentation/simulation-testing/chat-simulations">
    Test your Kore app with persona-driven chats
  </Card>

  <Card title="Build Scenarios" icon="book-open" href="/documentation/simulation-testing/scenarios">
    Define the conversations to test
  </Card>

  <Card title="Metric Policies" icon="shield" href="/documentation/metrics/metric-policies">
    Automate evaluation on every chat
  </Card>

  <Card title="Integration Overview" icon="plug" href="/documentation/integrations/overview">
    Explore other integrations
  </Card>
</CardGroup>