Overview
The Kore AI integration connects an app on the Kore AI Agent Platform to Roark for 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.
Creating the Integration in Roark
1
Open the integration form
Navigate to Agents, click Connect Agent in the top right, choose Existing Platform, and select Kore AI.
2
Fill in the configuration
3
Save
On save, Roark stores the credentials encrypted and auto-provisions:
- One Roark agent named after the integration
- One
KOREchat endpoint linked to the integration
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.
How Conversations Are Driven
Each chat simulation runs through a three-leg session lifecycle against your Kore app:
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
Run Chat Simulations
Test your Kore app with persona-driven chats
Build Scenarios
Define the conversations to test
Collectors
Automate evaluation on every chat
Integration Overview
Explore other integrations