Skip to main content
Updated in 4.64 This guide provides step-by-step instructions for migrating Agent Assist1 services to the cognigy-ai-app Helm chart.
As of release 4.65, the Agent Assist services have been fully integrated into the cognigy-ai-app Helm chart. This integration implies that the services provided by this Helm chart will be incompatible with versions 4.65 and onwards of the Cognigy.AI platform. Users must migrate to the new chart to continue receiving updates and support. Note that the agent-assist-genesys-notifications-forwarder will no longer be compatible with release 4.64 and earlier versions, as it now requires integration with RabbitMQ. Users are advised to plan their upgrade strategies accordingly to ensure smooth transitions and continued functionality.
Switching the ingress as part of the migration process will create a period of downtime. The product will be unavailable until all the new pods in the cognigy-ai namespace are up and running, and the agent-assist namespace is deleted. Plan this migration accordingly to minimize the impact.

Prerequisites

Upgrade the current installation of Agent Assist to v4.64

The migration to the cognigy-ai-app Helm chart requires Agent Assist v4.64 or later. If you are running an earlier version, upgrade to v4.64 or later before proceeding with the migration.

Pre-Migration Tasks

Before starting the migration, accomplish the following preliminary tasks.

Copy Agent Assist Namespace Secrets

You need to copy the existing secrets from the agent-assist namespace to the cognigy-ai namespace. The required secret is cognigy-agent-assist (MongoDB connection string). Use the copy-secret.sh script to copy these secrets:
Run the script:

Prepare values.yaml for Migration

Configure the values.yaml file with new values for the ingress and the cognigyAgentAssist sections:
This agent-assist-api-key secret contains an api-key field and is used for authenticating both the Agent Assist API Rest and WebSocket API.

Add Environment Variables

Remove old extraEnvVars containing AGENT_ASSIST_WORKSPACE_API_ACCESS_TOKEN in case they are defined from the cognigy-ai-app Helm chart:
Update the cognigyEnv section to ensure it reflects the correct domain names for your environment:

Migration Process

To initiate the migration, complete the following tasks.

Migrate to Cognigy.AI Helm Chart

After completing the pre-migration tasks, proceed with the migration by deploying the cognigy-ai-app Helm chart with the updated values.yaml file.

Uninstall the Agent Assist Namespace

After successfully migrating, uninstall the agent-assist namespace:
The migration is complete. You can now use the cognigy-ai-app Helm chart to manage your Agent Assist services.
1: As of release 4.65, Agent Assist has been renamed to AI Copilot.
Last modified on May 28, 2026