# AI-Assisted Error Analysis

|              | sfp-pro    | sfp (community) |
| ------------ | ---------- | --------------- |
| Availability | ✅          | ❌               |
| From         | October 25 |                 |

sfp provides intelligent AI-assisted error analysis to help developers quickly understand and resolve validation failures. When enabled through the `errorAnalysis` configuration in `ai-assist.yaml`, the system automatically analyzes error patterns and provides actionable insights.

{% hint style="warning" %}
AI-assisted error analysis requires:

1. The `errorAnalysis.enabled` flag set to `true` in `config/ai-assist.yaml`
2. A configured LLM provider (OpenAI, Anthropic, etc.)

See [Configuring LLM Providers](https://docs.flxbl.io/flxbl/sfp/getting-started/configuring-llm-providers) for setup instructions.
{% endhint %}

## Quick Setup

1. Create `config/ai-assist.yaml` in your project root:

   ```bash
   mkdir -p config
   touch config/ai-assist.yaml
   ```
2. Add the minimal configuration:

   ```yaml
   # config/ai-assist.yaml
   errorAnalysis:
     enabled: true
   ```
3. Set your LLM provider credentials (e.g., in CI/CD secrets)

That's it! AI error analysis will automatically activate during validation failures.

## How It Works

### 1. Change Significance Analysis

Before triggering AI analysis, sfp evaluates if changes are significant enough to warrant review:

* **Metadata Type Detection**: Uses Salesforce ComponentSet for accurate identification
* **Smart Thresholds**: Different thresholds per file type (Apex: 3 lines, Flows: 1 line, LWC: 10 lines)
* **Automatic Exclusions**: Skips non-critical metadata (CustomLabels, StaticResources, Translations)

### 2. Error Analysis

When validation fails and changes are significant, AI provides:

* **Root Cause Analysis**: Understanding why the error occurred
* **Quick Fix Suggestions**: Immediate actions to resolve issues
* **Related Components**: Other files that might be involved
* **Documentation Links**: References to relevant Salesforce docs

## Configuration

Configure AI assistance through `config/ai-assist.yaml`:

```yaml
# config/ai-assist.yaml

# Error Analysis Configuration
errorAnalysis:
  enabled: true                    # Enable/disable AI error analysis
  provider: openai                 # AI provider (openai, anthropic, etc.)
  model: gpt-4                     # Model to use
  timeout: 180000                  # Timeout in ms (default: 3 minutes)
  maxSuggestedFixes: 5            # Max number of fix suggestions

# Change Significance Configuration
architecture:
  changeSignificance:
    # Metadata types to exclude from analysis
    excludedMetadataTypes:
      - CustomLabels
      - StaticResource
      - CustomTab

    # Thresholds for triggering analysis
    fileTypeThresholds:
      apex:
        lines: 3    # Very strict for Apex
        files: 1
      flows:
        lines: 1    # Any flow change
        files: 1
      lwc:
        lines: 10   # More lenient for UI
        files: 2
```

## Usage

AI error analysis is **automatically enabled** when:

1. A `config/ai-assist.yaml` file exists in your project
2. The `errorAnalysis.enabled` flag is set to `true`
3. Valid LLM provider credentials are available

No additional CLI flags are required - sfp automatically detects and uses the configuration.

<figure><img src="https://1646267036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYLI5Ts7pWhWQV9UaBn3H%2Fuploads%2Fgit-blob-6175979840c2dd1292b8ba5f23bc1cfedf69bf4f%2FCleanShot%202025-09-29%20at%2022.24.32.png?alt=media" alt=""><figcaption></figcaption></figure>