Skip to main content
Check an instruction before and after it goes live: chat with your AI from the editor, see how often the AI had the instruction and used it, and download your instructions as a spreadsheet for review.
AI Training → Knowledge in your OpenCX dashboard. Testing, insights and export need the AI knowledge base permission; view access is enough.

Try an instruction in the Test panel

Click the play button in the editor header (its tooltip reads Test your instruction, Test your AI profile on Agent Identity, or Test with this article on a knowledge base article). The Test panel opens beside the editor with your web chat widget, connected to your live AI agent. Close it with the same button or the × in the panel. What the test chat does and doesn’t do:
  • It answers with what is published. Drafts and unpublished edits, including a pending schedule change, are not used. Publish an instruction before you test it, and test again after each publish.
  • It is a real web chat session. It runs on the Web channel, so an instruction restricted to other channels won’t apply here. The chat doesn’t carry your teammate identity, so it doesn’t show how a segment-restricted instruction behaves for a given customer.
  • It reaches your inbox. Hover an AI reply and click the info button (View my reasoning process) to open that session in the inbox, in a new tab, with the AI’s reasoning for the reply.
The test chat goes through the same agent your customers reach. Actions the AI calls and workflows that run on incoming messages can run during a test, so test with data that is safe to act on.

Read an instruction’s insights

Open a published instruction and click Insights in the editor header (⌘2; ⌘1 returns to Editor). A draft shows Publish this instruction to start collecting insights instead. Knowledge base articles have the same tab. Below the numbers, Sessions lists the sessions that used the instruction, newest first. Sessions that ended in a handoff carry a Handed off badge, and View all … in inbox opens the full list in the inbox. The date picker above the numbers defaults to the last month. Clear it to see all time. It shares its range with the sidebar sort below, so the badges there and the numbers here always describe the same window.

Find the instructions that matter most

The sort button next to the sidebar search ranks instructions and knowledge base articles together:
  • Handoffs ranks by handoffs that referenced the item.
  • Citations ranks by how many sessions the AI used the item in.
Pick the Order and a date range in the same menu, and click Clear to return to the folder view. A high handoff count on an instruction is a prompt to read those sessions and rewrite or narrow it.

Export instructions to CSV

Choose Export as CSV from the … menu next to AI instructions to download every instruction, or from a folder’s … menu to download that folder and its sub-folders. The dialog shows the file name, how many instructions it holds and the columns; click Download CSV. For an instruction with pending edits, the file holds its published title and text. The file is UTF-8 encoded and opens in Excel, Google Sheets or any text editor.

Troubleshooting


Organize and schedule

Folders, limits, schedules and versions.

Training scenarios

Write and format an instruction.

AI Instructions overview

AI profile, instructions and folders.

Inbox

Review the sessions behind the numbers.