Iris AI

Iris Studio: topics

Create Iris topics with names, aliases, base topics, skills, tools, prompts, and runtime exposure.

Iris Studio: topics

Iris Studio lets tenant admins package knowledge and action capability into topics. A topic combines a name, alias, base topic, extra instructions, selected skills, selected tools, and exposure settings such as whether the topic can be used in the Page Builder runtime.

Topic fields

FieldPurpose
NameHuman-readable topic name shown in Iris Studio.
AliasUnique identifier used when calling Iris. It can auto-fill from the name until edited.
Base topicThe built-in Iris behaviour the tenant topic extends.
Extra promptAdditional tenant-specific instructions injected into the system prompt.
Welcome messageEmpty-state copy for PageBuilderIrisChat when this topic is embedded. When a tenant topic row exists, this field (not the page prop) is the source of truth — leave blank for no welcome text.
SuggestionsQuick-start chip labels for PageBuilderIrisChat. Same precedence as welcome message; leave blank for no chips.
SkillsMarkdown knowledge added to the prompt, such as platform vocabulary, object development, Page Builder contracts, charts, filters, forms, or reports.
ToolsApproved actions Iris may call for that topic.
Runtime exposureControls whether the topic is available to Page Builder runtime chat widgets.

Configure a topic

  1. Open Settings, then Iris Studio.
  2. Create a topic or edit an existing tenant topic.
  3. Pick the closest base topic before adding custom instructions.
  4. Select only the skills Iris needs for the job.
  5. Add tools when Iris must inspect, create, update, or perform actions.
  6. Enable Page Builder runtime exposure only for topics safe to use on rendered pages.
  7. Test with representative prompts and review tool use.

For developers