---
schema_version: "1"
id: ac515db5a9270dc216c4c4e34fea67ef400757dae2dcec3dc462a2d145a8a9e4
title: Troubleshoot AI Agent Tasks in Agentforce Operations
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/automate_afsc_ai_agent_troubleshooting.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.automate_afsc_ai_agent_troubleshooting.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 272b6e37f97ed3900777ed3779c70447c99d1818f94bb722844296a19c179fac
description: Use this guide to diagnose and fix common AI agent issues in Agentforce Operations.
products:
  - Cross Cloud
release: "264"
---
# Troubleshoot AI Agent Tasks in Agentforce Operations

Use this guide to diagnose and fix common AI agent issues in Agentforce Operations.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
      <colgroup>
        <col>
      </colgroup>
      <thead class="slds-text-title_caps ">
        <tr class="">
          <th scope="colgroup" class="slds-cell-wrap" colspan="1" style="text-align:left;vertical-align:top;" id="d9669e37">License Required</th>
        </tr>
      </thead>
      <tbody>
        <tr class="">
          <td data-label="License Required" class="slds-cell-wrap" style="vertical-align:top;" headers="d9669e37 ">
            <p>This feature is a workspace that’s external to your Salesforce org and requires
              an Agentforce Operations license. </p>
            <p style="margin-bottom:0;">To purchase an Agentforce Operations license, contact your Salesforce account
              executive.</p>
          </td>

        </tr>
      </tbody>
    </table>

## Common Issues and Resolutions

 
| Issue | Possible resolutions |
| --- | --- |
| The task takes too long to complete | Try again later if large language model service demand is high. Reduce parallel AI tasks and use smaller files when possible. |
| Outputs are empty or not relevant | Confirm that all required documents and shared fields were explicitly provided to the task. |
| Outputs are random or hallucinated | Provide complete source data and realistic test values. Avoid placeholder-only test values. |
| Data source field fails to populate | Turn on AI access for the data source, keep requested rows limited, and align search wording to actual table values. |
| Agent generates poor plans | Restart with feedback for the agent. Make instructions more explicit. Split overly complex tasks into smaller tasks. See [Write Effective Instructions for AI Agents in Agentforce Operations](https://help.salesforce.com/s/articleView?id=platform.automate_afsc_write_effective_ai_agent_prompts.htm&release=264.0.0&type=5 "When configuring a task assigned to an AI agent, use these guidelines to write effective instructions in the Description field in Agentforce Operations. Clear instructions lead to more reliable results.") and the Test Your AI Agent Tasks section in [Get AI Agent Tasks Ready for Run Time in Agentforce Operations](https://help.salesforce.com/s/articleView?id=platform.automate_afsc_ai_agent_get_ready.htm&release=264.0.0&type=5 "Before you publish a blueprint, make sure that your AI agent tasks are tested and producing reliable results. This section walks you through how plans work, how to test them, and how to lock them for consistent run-time behavior in Agentforce Operations."). |
| .docx template filling fails | Verify that variables use exact syntax such as `{{ supplier_name }}`. |

#### See Also

- [Write Effective Instructions for AI Agent in Agentforce Operations](https://help.salesforce.com/s/articleView?id=platform.automate_afsc_write_effective_ai_agent_prompts.htm&release=264.0.0&type=5 "When configuring a task assigned to an AI agent, use these guidelines to write effective instructions in the Description field in Agentforce Operations. Clear instructions lead to more reliable results.")
- [AI Agent Limits and Considerations in Agentforce Operations](https://help.salesforce.com/s/articleView?id=platform.automate_afsc_ai_agent_limits.htm&release=264.0.0&type=5 "Review AI agent limitations and considerations before assigning a task to an agent.")