Skip to main content
Folders keep a growing list of AI instructions readable, and each instruction’s settings decide where and when the AI may use it. Use this page when your instructions outgrow a flat list, or when an instruction should apply only to some channels, some customers or a limited period.
AI Training → Knowledge in your OpenCX dashboard. Viewing needs the AI knowledge base permission. Creating, moving, scheduling, restricting or publishing needs AI knowledge base with write access. Pins and your own folder order only need view access.

Organize instructions in folders

In AI Training, Knowledge, clicking + next to AI instructions, choosing New folder, naming it Billing, and the folder appearing above Refunds and Shipping

Click + next to AI instructions, choose New folder, type a name and press Enter.

Folders live in the AI instructions section of the sidebar. A folder can hold instructions and sub-folders, and sub-folders can nest further. The number next to a folder counts every instruction inside it, including its sub-folders.
1

Create a folder

Click + next to AI instructions and choose New folder. To create one inside another folder, use that folder’s + or … menu and choose New sub-folder. The folder appears as New folder with its name ready to edit: type a name and press Enter.
2

Add instructions

Click + on a folder and choose New instruction. An empty, open folder also shows Add instruction.
3

Move instructions and folders

Drag an instruction or a folder onto another folder. Hovering over a closed folder while dragging opens it so you can drop deeper inside. To take a nested item out of every folder, drop it on Move to top level. Without dragging, use Move on an instruction’s menu or Move to… on a folder’s menu.
A folder’s … menu also has Rename, Visibility, Export as CSV and Delete. Folder names must be unique within the same parent folder, and a folder can’t move into itself or one of its own sub-folders.
Deleting a folder also deletes its sub-folders and every instruction inside them. This can’t be undone.

Pin folders and set your own order

Pins and order change only your view. They follow you to other browsers, and they don’t change what teammates see or what the AI uses. Pinned folders stay on top in both modes. In Custom order, folders and instructions you haven’t placed yet appear after the ones you have arranged. Reordering is personal, but moving an item into a different folder changes it for everyone.

Limit an instruction to channels or segments

Open an instruction, then choose Settings from the ⋮ menu in the editor header or from the instruction’s menu in the sidebar. The Instruction settings dialog has three parts: Active period, Restrict by Channel and Restrict by Contact Segments.
  • Restrict by Channel: turn on the channels where the AI may use the instruction. The list covers Web, Email, Phone, Slack, API, Web Voice, WhatsApp, Instagram, Messenger, SMS, X (Twitter), X Mentions, App Reviews and Internal. Leave every channel off to allow all of them.
  • Restrict by Contact Segments: pick one or more contact segments. The AI uses the instruction only when the session’s contact belongs to at least one of them. A session without a known contact never gets a segment-restricted instruction. Leave it empty to allow everyone.
When you set both, a session must match both. A shield icon next to an instruction in the sidebar marks it as restricted; hover it to see the channels and the number of segments.
Channel and segment changes save as you make them and take effect right away, even on a published instruction. They don’t wait for Publish.

Apply the same limits to a whole folder

Choose Visibility on a folder’s … menu, set channels and segments, then click Apply to All. This replaces the limits on every instruction in the folder and its sub-folders. The folder itself keeps no rule: instructions you add or move into it later keep their own settings. If all the instructions already share the same limits, the dialog opens with them filled in; otherwise it starts empty.

Schedule an instruction

Under Active period, turn on Limit to a time period and pick a start and an end. Either side can stay empty: a start alone means “from then on”, an end alone means “until then”. The end must be after the start. Turning the switch off removes the window.
  • Time zone. The picker uses your workspace time zone from Settings → Office Hours, or UTC until one is set. The start and end are stored as fixed moments when you save, so a later time zone change doesn’t move them.
  • Outside the window, the AI doesn’t see the instruction on any channel, including phone agents. The instruction isn’t deleted when the window ends; it stays in your list and can be rescheduled.
  • Publish to apply. On a published instruction, a schedule change is saved with the draft and goes live when you click Publish. Discard draft drops it.
A scheduled instruction shows a clock icon instead of the page icon in the sidebar. Hover it to see the window, for example Starts Mar 3, 9:00 AM or Ended Mar 10, 5:00 PM. A schedule that isn’t published yet reads Draft · first. Clicking the icon opens the settings.

Drafts, publishing and versions

Edits save automatically as you type. What the AI uses depends on the instruction’s state:
  • Publish makes the draft live and records a new version. It stays disabled while the instruction has suggested changes you haven’t accepted or rejected.
  • Discard draft, in the version menu, throws away pending edits, including a pending schedule change, and returns to the published version.
  • Unpublish, in the ⋮ menu, removes the instruction from your live AI agents and turns it back into a draft holding its last published content. Pending edits are dropped; version history is kept.
  • Duplicate creates a draft copy named ”… (Copy)” in the same folder, with the same limits and schedule.

Review and restore versions

Click the version label in the editor header to open Version History. Each row shows the version number, who published it and when; the live one is marked Active. Click an older version to preview it read-only. While previewing, click Restore to publish that version’s content and schedule as a new version. Unpublished edits are discarded, and the instruction’s current channel and segment limits and folder stay as they are. The AI profile, shown as Agent Identity in the sidebar, has a draft and Publish too, but no version history.

Troubleshooting


AI Instructions overview

AI profile, instructions and folders.

Training scenarios

Write and format an instruction.

Test and measure

Test panel, insights and CSV export.

Office hours

The workspace time zone schedules use.