---
schema_version: "1"
id: 4dd63b6603d26a477605c76c45707e0772a433ac0f7411ecbd58ea19ac5c359a
title: Troubleshooting
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/salesforcedx/agentforcevibes/guides/files/afv-troubleshooting.md
canonical_url: https://developer.salesforce.com/docs/platform/agentforcevibes/guide/afv-troubleshooting.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 3b1a97b79760cf0b36e2e73976512de781f5413fa2407b0397fb516a37826600
products:
  - Agentforce Vibes Developer Guide
  - salesforcedx
---
# Troubleshooting

Agentforce Vibes uses large language models (LLMs) to generate output. Because LLMs don't always produce perfect results, you may need to re-prompt or adjust your request when the output doesn't meet your expectations.

**note:** If your company requires the use of a proxy, configure it through the Salesforce CLI rather than VS Code to ensure the Agentforce Vibes extension works correctly.

## Troubleshooting Checklist

### Development Environment

1. Confirm that you have a Salesforce DX project open. Check that your workspace contains an `sfdx-project.json` file. See [Salesforce DX Project Configuration](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_ws_config.htm).
2. Confirm that the Agentforce Vibes extension is active. Run **Developer: Show Running Extensions** and look for Agentforce Vibes in the list.
3. Confirm that you're connected to a Salesforce Org with Agentforce Vibes enabled. The status of your default Org connection appears in the status bar.

**tip:** Run **SFDX: Open Default Org** to quickly verify that your Salesforce extensions are running and that you're connected to an Org.

### Agentforce Vibes Fails to Activate on Windows

If Agentforce Vibes fails to activate on Windows with no clear error, the Microsoft Visual C++ Redistributable may not be installed on your machine. Install the latest version from [Microsoft's download page](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170), then restart VS Code.

### MCP Server Connection Failed

Run these Salesforce CLI commands to diagnose the issue:

**Check Salesforce CLI installation**

```bash
sf version
```

**Verify Org authentication**

```bash
sf org list
```

**Check Node.js version**

```bash
node --version
```

If the MCP server still doesn't connect after verifying these, check the activity log in Settings > Logging for connection errors. See [Debug Logging](https://developer.salesforce.com/docs/platform/agentforcevibes/guide/afv-debug-logging.md).

### No Response to Prompts

If your prompts get no response and the model selector shows no models, your user likely doesn't have the required permission set license assigned. See [Frequently Asked Questions](https://developer.salesforce.com/docs/platform/agentforcevibes/guide/afv-faqs.md#setup-and-access).

### Unexpected or Inconsistent Suggestions

If code suggestions are unexpected or inconsistent, another AI-enabled extension may be interfering. Disable all other AI-enabled extensions while using Agentforce Vibes. See [Frequently Asked Questions](https://developer.salesforce.com/docs/platform/agentforcevibes/guide/afv-faqs.md#troubleshooting).

## Collect Logs for a Bug Report

To capture logs before filing a bug report:

1. Open the Agentforce Vibes panel and click the **Settings** icon (⚙).
2. Click **Logging** to expand the section.
3. Toggle **debug logging** on.
4. Reproduce the issue.
5. Click **Open activity log** to open the log file. For model-level detail, click **Open full trace**.
6. Enable **Redact sensitive data** before sharing the log file.

See [Debug Logging](https://developer.salesforce.com/docs/platform/agentforcevibes/guide/afv-debug-logging.md) for a full description of logging options.

## See Also

- [Debug Logging](https://developer.salesforce.com/docs/platform/agentforcevibes/guide/afv-debug-logging.md)
- [Frequently Asked Questions](https://developer.salesforce.com/docs/platform/agentforcevibes/guide/afv-faqs.md)
- [Set Up Agentforce Vibes](https://developer.salesforce.com/docs/platform/agentforcevibes/guide/afv-user-setup.md)