--- title: Hero AI Companion slug: hero-ai-companion docTags: createdAt: 2025-08-11T11:13:45.000Z --- The Hero AI Companion is Swimlane’s agentic AI chat experience in Turbine. Use it to ask questions about records, reports, and cybersecurity topics in natural language. :::hint{type="info"} The companion uses **one panel** across Turbine. On most screens you get the **general companion**; on a playbook or component canvas you get **Playbook Building Mode** or **Component Building Mode** instead. See [Hero AI Modes and Context](https://docs.swimlane.com/hero-ai-companion#hero-ai-modes-and-context) or the [Hero AI](docId\:swZ8uETVmVoOJwGm_xNK-) overview. ::: :::hint{type="info"} The Hero AI Companion is behind a feature flag and must be enabled. To enable this feature, contact Swimlane Support. Once enabled, the **Hero AI** icon appears at the top-right corner of the screen. ::: ## Choose Your Path | I want to… | Go to | | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | Open and use the chat panel | [Open the Hero AI Companion](https://docs.swimlane.com/hero-ai-companion#open-the-hero-ai-companion) | | Clear the current chat without closing the panel | [Reset Conversation History](https://docs.swimlane.com/hero-ai-companion#reset-conversation-history) | | Control what data Hero can read | [Configure Hero AI Visibility Settings](https://docs.swimlane.com/hero-ai-companion#configure-hero-ai-visibility-settings) | | Understand companion vs building modes | [Hero AI Modes and Context](https://docs.swimlane.com/hero-ai-companion#hero-ai-modes-and-context) | | Build or change playbook flows with AI | [Create and Modify Playbooks with Hero AI](docId\:TmMNjGlC0e9lIPO37KZPB) | | See what the Playbook Generator Agent can do | [Playbook Generator Agent Reference](docId:3JkvN5yplM_U06tfjHiAC) | | Build or change a component on the canvas with AI | [Create and Modify Components with Hero AI](docId\:ikUKoTgCOrZumuwb-JDsb) | | Build or change a widget with AI | [Build Widgets with Hero AI](docId\:QEu5rG5RnOmE41WK1cxpT) | | Run a component from chat (not edit the canvas) | [How Hero AI Executes Components](docId\:MGZX3dKiIv_vi2MHOynEV) | | Send feedback on a response | [Thumbs Up/Down Functionality and Feedback Options](https://docs.swimlane.com/hero-ai-companion#thumbs-updown-functionality-and-feedback-options) | If you are viewing an application record, Hero recognizes record context so you can ask about "this case," "this user," or "this host." ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/lmqO1Lfr8ip0XMIPqxj49_hero-ai-chat.png" size="60" width="800" height="404" darkWidth="800" darkHeight="404" position="center" showCaption="false"} The general companion can **read** application records. It cannot update playbook or component canvas layouts from the main toolbar chat alone. To **edit** a playbook flow or component on the canvas, use the matching **Building Mode** (see below). ## Hero AI Modes and Context Hero AI uses **one panel** across Turbine. The **mode** depends on **which screen you are on**, not on a separate setting you turn on in the menu. | Where you are | Hero AI mode | What it does | | --------------------------------------------------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Most screens (records, reports, **Components** list, and so on) | **General companion** | Questions about tenant data, records, reports, cybersecurity topics; can **run** components marked **Visible to Hero AI** (see [How Hero AI Executes Components](docId\:MGZX3dKiIv_vi2MHOynEV)) | | **Playbook** open in the canvas editor | **Playbook Building Mode** | Create or modify flows with the Playbook Generator Agent — [Create and Modify Playbooks with Hero AI](docId\:TmMNjGlC0e9lIPO37KZPB) | | **Component** open in the Component Builder | **Component Building Mode** | Create or modify the component on the canvas — [Create and Modify Components with Hero AI](docId\:ikUKoTgCOrZumuwb-JDsb) | | **Widget editor** open (record or report widget) | **Widget Building Mode** | Edit widget **Code** with the widget builder agent — [Build Widgets with Hero AI](docId\:QEu5rG5RnOmE41WK1cxpT) | ### How Mode Changes When You Navigate 1. Open **Hero AI** from the toolbar on any screen → you start in (or return to) the **general companion** unless you are already inside a playbook, component, or widget editor. 2. Open a **playbook**, **component**, or **widget** in the editor and open **Hero AI** (toolbar, **Build with Hero AI**, or **Start building with Hero AI** on an empty playbook) → the panel enters **Playbook Building Mode**, **Component Building Mode**, or **Widget Building Mode**. You should see a banner such as **Entered Playbook Building Mode**, **Entered Component Building Mode**, or **Entered Widget Building Mode**, and a footer label with the same name. 3. **Navigate away** from that editor (for example, back to the **Components** list or **Playbooks** list) → canvas context clears and the panel returns to the **general companion** welcome (for example, **Hello! How can I help you today?**). You do **not** need to close and reopen Hero AI. :::hint{type="info"} **Playbook Building Mode**, **Component Building Mode**, and **Widget Building Mode** are for **editing automation or widget code on the canvas**. **How Hero AI Executes Components** describes running published components from the **general companion** when **Visible to Hero AI** is enabled — not editing the component definition. ::: See the Hero AI Companion in action in [this](https://swimlane.com/resources/videos/demo-hero-agentic-ai-secops-companion/) demo video. ## Open the Hero AI Companion 1. Click the **Hero AI** icon at the top-right of the screen. 2. The **Hero AI** panel opens on the right (docked) or full screen, depending on your last layout choice. 3. Type a question in the input area and send it. ## Hero AI Companion Panel Controls The panel header shows **Hero AI** and action icons on the right. | Control | Icon / location | What it does | | ------------------------------------- | ------------------------------ | ------------------------------------------------------------ | | **Maximize chat** / **Minimize chat** | Expand or collapse icon | Switches between docked (right side) and full-screen layout. | | **More options** | Vertical ellipsis (three dots) | Opens a menu with additional actions. | | **End chat** | **X** | Closes the companion panel. | ### Reset Conversation History Use **Reset conversation history** when you want a **new chat in the same open panel** without closing Hero AI. 1. Open the **Hero AI** panel. 2. Click the **More options** menu (vertical ellipsis) in the panel header. 3. Click **Reset conversation history**. Hero clears the visible messages and starts a new conversation. Any in-flight request is canceled so it does not affect the new chat. :::hint{type="info"} **Reset conversation history** is not the same as closing the panel. **End chat** (**X**) closes the panel and also clears history when you reopen it. **Reset conversation history** clears the thread while the panel stays open. ::: On a **playbook or component canvas**, reset also starts a fresh session for Playbook Building Mode or component building (history and session context are cleared). ## Uses of the Hero AI Companion ### Efficient Record Access Hero AI reduces manual filtering by letting you ask direct questions about tenant data. Responses can include links to records or pages so you can open the exact item in the UI. ### Record Context When you view an application record, Hero uses that record as context. You can ask questions about the current case, user, host, or other fields on the record. ### Conversations and Context Window The companion keeps context for follow-up questions (for example, "give me a shorter answer" or "tell me more about those cases"). Context is typically limited to the most recent five prompts and responses to manage token use. | Action | Effect on conversation | | ------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | **Reset conversation history** (menu) | Clears messages and starts a new thread; panel stays open. | | **End chat** (**X**) | Closes the panel; history is cleared. | | Refresh the browser page | History is cleared. | | Leave a playbook or component canvas editor | Panel can stay open; mode returns to the **general companion** (building banners clear). | | Navigate to another screen (still in general companion) | Panel can stay open; chat history usually continues until you reset, close, or refresh. | ### Large Result Sets and Reports When a response matches many records, Hero shows a preview (up to five records) and the total count. A link can open a full report in the Swimlane UI with the same filters applied. You can sort, export, or save that report like any other report view. ## RBAC The Hero AI Companion inherits the RBAC settings of the user chatting with Hero. If a user cannot read an application or field, Hero cannot use that application or field in answers. ## Hero AI Companion Windows The companion supports two layouts: | Mode | Description | | -------------------- | ------------------------------------------------------------------- | | **Full-screen mode** | Occupies the entire screen; suited to longer sessions. | | **Docked mode** | Panel on the right side; suited to multitasking and record context. | Use **Maximize chat** or **Minimize chat** in the panel header to switch layouts. ## Configure Hero AI Visibility Settings Application and field visibility control which data Hero can access when answering questions. - Enable visibility on an application or field so Hero can use it in answers. - Disable visibility to restrict Hero from that data even if the user can read it in the UI. ### Configure Applications Configure whether an application is visible to Hero AI from **App Settings**. For new applications, **Visible to Hero AI** is on by default. When the toggle is on, the **Description** field is required so Hero understands the application purpose. Use this pattern for application descriptions: **The \[Application Name] (\[Application Acronym]) application is designed to \[purpose]. It contains information about \[data stored]. Each record in \[Acronym] includes \[main fields and formats]. This application is commonly used to \[use case]. \[Terminology specific to this application.]** Example (Case and Incident Management): The **Case and Incident Management (CIM)** application supports Security Operations Center (SOC) operations. It stores case records investigated by analysts, including status, priority, severity, users, hosts, assets, observables, and determination. Analysts often work oldest cases first (**First Created**), highest **Priority** (P0 is highest), highest **Severity** (**Critical** is highest), and open status (**New**). ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/1Iqo0e56dEP3ggJg660lU_description-ai-window.png" size="24" width="800" height="1208" position="center" showCaption="false" darkWidth="800" darkHeight="1208"} ### Turn On Visible to Hero AI for an Application 1. Navigate to **APPLICATIONS & APPLETS** and open **Create a New Application**, or open an existing application **App Settings**. 2. In **Create Application** or **App Settings**, set **Visible to Hero AI** to on (default for new applications). 3. Enter a **Description** (required when visibility is on). 4. Save the application. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/9_fDYZK79E2ku7MvcxKmu_application-hero-ai.png" size="42" width="800" height="545" position="center" indent="2" showCaption="false" darkWidth="800" darkHeight="545"} ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/w7sOcXI6AOVqYjlfyEf8V_visible-to-hero-ai.png" size="50" width="800" height="390" position="center" indent="2" showCaption="false" darkWidth="800" darkHeight="390"} :::hint{type="info"} If **Visible to Hero AI** is off for an application, you cannot turn it on for individual fields in that application. ::: ### Configure Fields Configure field visibility from **Field Properties** on the form layout. By default, fields are **not** visible to Hero AI. When you turn visibility on, **Description** is required. Good field descriptions are one short sentence with meaning and sample values when helpful. Example: The primary CVE ID of the vulnerability. **Value format:** CVE-YYYY-XXXXX. **Sample value:** CVE-2019-12345. ### Turn On Visible to Hero AI for a Field 1. In **Form Layout**, select the field. 2. In **Field Properties**, turn on **Visible to Hero AI**. 3. Enter a **Description** (required when visibility is on). ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/laA44Oo7lWB5uux32J1b6_application-ai-1.png" size="80" width="800" height="405" position="center" showCaption="false" darkWidth="800" darkHeight="405"} ### Visibility Logic Table | Application Visible to Hero AI | Field Visible to Hero AI | Hero AI can use the field | | ------------------------------ | ------------------------ | ------------------------- | | On | On | Yes | | On | Off | No | | Off | On | No | | Off | Off | No | ## Thumbs Up/Down Functionality and Feedback Options Use the thumbs up and thumbs down icons under each reply to send feedback. ### Thumbs Up – Positive Feedback Click **thumbs up** when the response: - Answers your question accurately - Is helpful, clear, or complete - Matches the expected format or logic ### Thumbs Down – Negative Feedback Click **thumbs down** when the response: - Is partially correct, incorrect, or irrelevant - Is hard to understand because of formatting - Does not match the context or logic of your request ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/66hqDUO4BA7G7HG3xPCLU_heroaifeedback.png" size="20" width="800" height="1661" position="center" indent="2" showCaption="false" darkWidth="800" darkHeight="1661"} After **thumbs down**, a feedback panel appears with options: | Option | When to use it | | --------------------- | -------------------------------------------------------------- | | **Partially Correct** | Some information is useful but incomplete or has minor issues. | | **Incorrect Answer** | The response is wrong or does not apply. | | **Irrelevant** | The response does not address your prompt. | | **Poor Formatting** | The answer is hard to read (for example, broken code blocks). | You can add notes in **Additional Feedback**. By default, **Include last prompt and response** is checked so reviewers see full context. ### Use Case Example You ask: "Can you filter applications created in the last two days?" Hero AI replies with SQL that uses syntax your environment does not support. You click **thumbs down**, select **Incorrect Answer**, add a note (for example, "Use DATE\_SUB() for MySQL. Clarify created\_at field type."), leave **Include last prompt and response** checked, and click **Submit**. ## See Also - [Create and Modify Playbooks with Hero AI](docId\:TmMNjGlC0e9lIPO37KZPB) - [Create and Modify Components with Hero AI](docId\:ikUKoTgCOrZumuwb-JDsb) - [How Hero AI Executes Components](docId\:MGZX3dKiIv_vi2MHOynEV) - [Components](docId\:c7ipCS5NdR9sGu4z6Pjs0) - [Hero AI](docId\:swZ8uETVmVoOJwGm_xNK-) — overview of all Hero AI features