---
title: How Hero AI Executes Components
slug: how-hero-ai-executes-components
docTags: 
createdAt: 2025-08-11T11:13:48.000Z
---

Hero AI enables users to trigger component-based automation directly from natural language prompts in the **general companion** (Hero AI panel). This functionality is available for components that are marked **Visible to Hero AI** in the Component Builder.

:::hint{type="info"}
This page is about **running** components from chat. To **build or change** a component on the canvas with AI, open the component in the Component Builder and use **Component Building Mode**. See [Create and Modify Components with Hero AI](docId\:ikUKoTgCOrZumuwb-JDsb). For how modes switch when you navigate, see [Hero AI Companion](docId\:crQKFVnGpCz_wJ8xtHDs7).
:::

## Component Discovery

When a user sends a prompt in the Hero AI Companion (for example, “send Slack message to the networking team”), Hero AI interprets the intent and searches for matching components based on:

- The component's name and description
- Input field names and expected schema
- Associated interfaces or user-defined configuration

When a match is found, Hero AI displays a component card with a message prompting the user to review the inputs and confirm execution.

## Review and Edit Inputs

Click **Review Details** to inspect the component's input fields. If needed, you can modify the values pre-filled by Hero AI. These values may be inferred from:

- The current workspace or record context
- User profile details
- Defaults defined in the component

You can adjust values for strings, numbers, booleans, arrays, and object structures. Click **Save** to confirm your changes.

## Execution

After reviewing the details, click **Run** to execute the component. Hero AI sends the inputs to the component and triggers execution. The result will appear in the chat window, confirming that the automation completed.

If the component is configured for auto-execution (**Requires Confirmation to Execute** is disabled), the component runs immediately after a match is found—no review or approval is needed.

**Note:** If Hero AI is unable to resolve required inputs from context, it will prompt the user to manually provide those values before continuing.

## Which Components are best suited for Hero AI?

As a best practice, we generally recommend making simple, modular and straight forward Turbine components visible to Hero AI. Components that require complex nested JSON objects as input may be more difficult for Hero AI to populate.

For naming, schemas, descriptions, and AI SOC behavior, see [AI-Friendly Component Best Practices](docId:3pKnx5VXkQsJlLTojRO7b).

## Component Execution - Current Limitations

- **RBAC**: Components marked as "**Visible to Hero Al**" will be available to be called by all users in the tenant. There are no current permissions we can configure to specify which users can use which components.
- **Component Runtime Errors:**
  - In scenarios where component executions result in errors, Hero Al in some instances will show a generic error without a lot of error details.
  - Users without access to Orchestration features will not be able to independently troubleshoot and view.