# AI feature settings and change history

Configure which AI behaviour runs for your visitors and keep a history of saved changes.

*Release 3.3 · admin, developer*

**Settings › AI › Features**

## What it is

**AI Features** defines the AI jobs available on your website. You choose a type, an account, instructions and any visitor conditions. Each save of an existing feature creates a new version, so you can inspect earlier instructions.

## Who uses it and why

Administrators configure the AI behaviour used by operators and visitors. Developers maintain more specialised instructions, functions and targeting.

## Where to find it

Open **Settings › AI › Features**. You need the **Settings** role with **AI** allowed under **Settings Permissions**, or the **Developer** role. Powerfront manages **Settings › AI › Accounts** and **Settings › AI › Models**.

## How it works

1. Choose **New** and select the job in **Select Feature Type**.
2. Enter a **Name**, choose an **Account** and configure that type's options.
3. Set **Visitor Filters (drag and drop)** if the feature should apply only to particular visitors.
4. Set **Priority**, check **Enabled** and save.

For ordinary visitor-based selection, INSIDE considers enabled features of the requested type with a suitable account and model. It checks their visitor conditions and selects the highest priority match. An empty filter matches without additional visitor conditions.

Saving an edit keeps the feature's identity and creates the next version. The previous version remains in history. Assigned skills carry forward. Autopilot saves also update its linked bot configuration.

Use the feature's history action to open **History**. It shows **Version**, **Date**, **Operator** and **Rules**, including instruction differences between versions.

## Configure it

Ask Powerfront to enable AI and prepare the required accounts and models. Then create the features you need. Use distinct priorities where visitor filters overlap, and keep names descriptive enough to distinguish similar configurations.

Configure each type's instructions and options in its editor. A positive **Max Tokens** overrides the account value; **0** keeps the account default.

### Settings

| Setting | Where | Applies to | Default | Who can change it | What it does |
|---|---|---|---|---|---|
| Enabled | Settings › AI › Features | website | On for a new feature | Settings role, Developer role | Makes the feature eligible for selection when its other requirements match. |
| Priority | Settings › AI › Features | website | 0 | Settings role, Developer role | A higher number takes precedence when several features of the same type match a visitor. |
| Max Tokens | Settings › AI › Features | website | 0, use the account default | Settings role, Developer role | A positive value overrides the account token limit for this feature. |
| Visitor Filters (drag and drop) | Settings › AI › Features | website | Not set: no visitor restriction | Settings role, Developer role | Restricts selection to visitors who meet the conditions; an empty filter adds no restriction. |
| Account | Settings › AI › Features | website | Not set: choose a configured AI account | Settings role, Developer role | Selects the configured AI account used to run the feature. |
| Type | Settings › AI › Features | website | Not set: choose the AI job when creating the feature | Settings role, Developer role | Selects the AI job, such as Autopilot, Copilot or Conversation Summary. |

### Fields

| Field | Where | Required | What it is for |
|---|---|---|---|
| Name | Settings › AI › Features | Yes | Identifies the feature in lists and selection controls. |
| Description | Settings › AI › Features | No | Records what this feature is for. |

### Permissions

| Permission | Lets you |
|---|---|
| Settings | Manage AI features when the AI permission is allowed. |
| AI | Allows access to AI configuration within Settings Permissions. |
| Developer | Manage AI features. |

## Limits and good to know

- **Name** is required and cannot exceed 1,000 characters. New feature names must be unique on the website.
- **Priority** and **Max Tokens** cannot be negative.
- History is a record of saved versions. It does not provide a documented approval or restore process.
- Proactive agent selection has additional eligibility and ordering rules. See AI-005.
- Saving a feature does not by itself prove that a visitor matches it or that its account supports its type.

## Depends on and works with

### This feature uses

- **Requires** [AI accounts and shared defaults](AIP-001.md): Each feature needs a configured AI account.
- **Configured in** [Roles and permissions](ADM-008.md): Roles and permissions control AI configuration access.
- **Configured in** [AI instructions and templates](AI-002.md): Instruction sources and templates define what the feature is told to do.
- **Configured in** [AI model catalogue](AIP-002.md): For accounts that use a model, model setup determines the available AI capabilities.
- **Configured in** [Visitor event targeting conditions](ENG-002.md): Visitor targeting conditions restrict feature selection.
- **Works better with** [Reusable AI skills and instructions](AI-020.md): Autopilot, Copilot and Ask AI can use assigned published skills.
- **Needs licence or module** Admin settings and feature switches (managed by Powerfront): Powerfront must enable AI for the website.

### Used by

- **Configures** [Conversation translation](CHAT-023.md): AI feature setup controls enablement, account and translation options.
- **Configures** [Streaming AI replies for visitors](VX-030.md): Streaming and interruption choices belong to the selected AI feature.
- **Configures** [Virtual Assistant tasks started by Autopilot](ENG-027.md): The AI feature determines which functions the agent can use.
- **Configures** [AI instructions and templates](AI-002.md): Instructions are saved within versioned AI features.
- **Configures** [Autopilot for live chat](AI-003.md): Autopilot is configured as a versioned AI feature.
- **Configures** [Autopilot handover and error handling](AI-004.md): Recovery options are saved in the Autopilot feature.
- **Configures** [Autonomous agents for proactive chat](AI-005.md): Feature enablement, visitor filters and priority affect agent selection.
- **Configures** [Copilot reply suggestions](AI-006.md): Feature selection uses enablement, account, visitor filters and priority.
- **Configures** [Fix and Re-Phrase for operator drafts](AI-007.md): Dedicated feature selection uses account support, visitor filters and priority.
- **Configures** [Ask AI beside a visitor conversation](AI-008.md): Ask AI selection uses feature type, visitor filters and priority.
- **Configures** [AI conversation summaries](AI-009.md): Summary features are selected using account support, visitor filters and priority.
- **Configures** [Chat Translate and language detection](AI-010.md): Language features use configured accounts, visitor filters and priority.
- **Configures** [AI spam checks for incoming conversations](AI-011.md): Feature enablement, account, priority and visitor filters control selection.
- **Configures** [Email Autopilot for tickets](AI-012.md): The feature selects the account, enablement and instructions.
- **Configures** [Voice Autopilot call handling](AI-013.md): The AI feature stores voice behaviour and account selection.
- **Configures** [AI run limits](AI-014.md): The feature selects the account and feature token allowance.
- **Configures** [Context Compiler for AI conversations](AI-015.md): Each supported feature chooses its context mode.
- **Configures** [AI functions and required inputs](AI-016.md): AI features choose the functions they can use.
- **Configures** [AI knowledge and web search](AI-017.md): The feature assigns functions and instructions to the agent.
- **Configures** [AI integrations and automation tools](AI-018.md): Feature instructions and function assignments determine available external actions.
- **Configures** [AI updates to customer and conversation data](AI-019.md): The AI feature assigns functions and supplies collection instructions.
- **Configures** [Reusable AI skills and instructions](AI-020.md): Skills are assigned to a saved AI feature version.
- **Configures** [Customer goals and AI progress tracking](AI-021.md): Each AI feature has its own goal tracking scope and instructions.
- **Configures** [AI conversation plans and task progress](AI-022.md): Work planning is enabled independently on each supported AI feature.
- **Configures** [Specialist sub-agents for AI tasks](AI-023.md): The target is a configured AI feature on the same website.
- **Configures** [AI agent service connections](AI-024.md): Supported features select the AI account used for execution.
- **Configures** [Rich content in AI replies](AI-026.md): Each supported AI feature controls its rich content settings.
- **Configures** [AI product suggestion settings](AI-027.md): Feature enablement, account, filters and priority determine which configuration applies.
- **Configures** [AI answer citations and summaries](AI-028.md): Citation Summary is a reusable feature selected by the answering feature.
- **Configures** [AI conversation quality scoring](AI-029.md): A matching enabled Conversation Scoring feature supplies the scorecards and account.
- **Configures** [AI resolution and first-contact metrics](AI-030.md): Matching feature rules, filters and account select the Metrics configuration.
- **Configures** [AI Experiments Lab for response testing](AI-032.md): Feature-mode experiments use the selected feature configuration.
- **Configures** [AI assistance activity](AI-033.md): Feature configuration sets the feature token override.
- **Configures** [Virtual Try-On with customer photos](AI-035.md): Feature configuration determines which agent can call the function.
- **Configures** [Ask AI agents in Team Chat](AI-036.md): The Ask AI feature must be active, enabled and configured with an account and model.
- **Configures** [AI reply streaming settings](AI-037.md): Streaming and interruption policy are selected on each supported feature.
- **Configures** [Conversation history tools for AI](AI-038.md): The feature controls whether each history capability is available.
- **Configures** [Images and attachments for AI agents](AI-039.md): Image analysis is configured on the supported feature.
- **Configures** [Knowledge Base connections for AI](AIP-009.md): The AI feature determines which knowledge functions it can use.
- **Configures** [Algolia Search for AI knowledge](AIP-010.md): The AI feature selects which search functions it can use.
- **Configures** [Saved responses as AI knowledge](AIP-011.md): The intended AI feature must be allowed to use the knowledge function.
- **Configures** [Shared AI service connections](AIP-013.md): Each supported AI feature selects the prepared connections it uses for prompts, tracing or memory.
- **Configures** [External AI prompts and versions](AIP-014.md): Each AI feature stores its own prompt selection and fallback instructions.
- **Configures** [AI execution tracing with Langfuse](AIP-015.md): Each supported AI feature selects its own tracing connection.
- **Configures** [Persistent AI memory connections](AIP-016.md): The feature selects the memory service, limit and identity scope.
- **Configures** [MCP tool connections for AI](AIP-017.md): The AI feature determines which tool functions it may use.
- **Configures** [Autopilot connections through A2A](AIP-019.md): Feature configuration controls availability, name, description and endpoint enablement.
- **Configures** [ACP compatibility for AI agents](AIP-020.md): Enabled, active features and their priorities determine which feature executes a run.
- **Configures** [AI platform execution limits](AIP-024.md): Max Tokens on the AI feature sets a feature-specific allowance or inherits the account default when zero.
- **Configures** [Voice Autopilot connection setup](AIP-025.md): Feature availability and saved configuration determine the voice agent used by a number.
- **Configures** [AI customer and order search](COM-011.md): AI feature configuration determines the assistant's functions and permitted use.
- **Configures** [AI commerce functions and access limits](COM-029.md): The AI Feature determines the context in which the function is available.
- **Configures** [Autonomous AI performance reports](REP-024.md): Autopilot feature selection includes the historical versions that handled conversations.
- **Configures** [AI conversation scoring reports](REP-025.md): Scoring features define the scorecards available to filter.
- **Configures** [Operator QA and coaching dashboard](REP-031.md): Enabled scorecards and their minimum message counts affect scoring and coverage.
- **Configures** [Custom integrations](EXT-017.md): AI feature function assignments control which agents can use a script-backed integration tool.

## FAQ and troubleshooting

### Why is my enabled feature not running?

Check website AI enablement with Powerfront, then check **Account**, model support and visitor filters. Another matching feature may have a higher **Priority**.

### Which feature wins when priorities are equal?

Do not rely on an ordering for ordinary selection when priorities are equal. Give overlapping features distinct priorities.

### Why can I see AI settings but cannot save?

Check the **AI** permission under **Settings Permissions**. The **Settings** role can be restricted from AI configuration.

### Can I inspect previous instructions?

Yes. Open the feature's history action and review the saved versions and instruction changes in **History**.