---
schema_version: "1"
id: fddc8b636a11f900650a9bcfeb783808e8126cf8789d84491f03297d367791a2
title: Upload Test Cases
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/agent_studio_testing_center_upload.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.agent_studio_testing_center_upload.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: b414667afb0de0479446779b9447809046fd0b271e00af7f15f0a011cfcb55c7
description: To use your own scenarios, upload a CSV file.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Upload Test Cases

To use your own scenarios, upload a CSV file.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col>
          <col>
        </colgroup>
        <tbody>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;"><a name="agent_studio_testing_center_upload__image_ewv_dvs_c3c"><!-- --></a>
              <div><img id="agent_studio_testing_center_upload__image_ewv_dvs_c3c" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/resources/images/checkmark.png" alt="green checkmark"></div>
              <p style="margin-bottom:0;"><strong>This article applies to:</strong></p>
            </td>

            <td class="slds-cell-wrap" style="vertical-align:top;">New Testing Center in Agentforce Studio (Beta)</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;"><a name="agent_studio_testing_center_upload__image_qxv_cvs_c3c"><!-- --></a>
              <div><img id="agent_studio_testing_center_upload__image_qxv_cvs_c3c" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/resources/images/crossmark.png" alt="red crossmark"></div>
              <p style="margin-bottom:0;"><strong>This article doesn’t apply to:</strong></p>
            </td>

            <td class="slds-cell-wrap" style="vertical-align:top;">Legacy Agentforce Testing Center in Setup</td>

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

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions. <a href="https://help.salesforce.com/s/articleView?id=ai.agent_setup_explore_types.htm&amp;release=264.0.0&amp;type=5" title="Learn about agent types and default templates for specific clouds and common use cases.">Required add-on licenses vary by agent type.</a></td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d132075e123">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d132075e123 ">To create and run tests in Testing Center:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d132075e123 ">
              <p>Manage Agentforce Grids</p>
              <p>AND</p>
              <p style="margin-bottom:0;">Manage Agentforce Testing</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d132075e123 ">To upload files to Testing Center:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d132075e123 ">File Upload permissions. See <a href="https://help.salesforce.com/s/articleView?id=experience.admin_files_type_security.htm&amp;type=5&amp;language=en_US" target="_blank">Configure File Upload and Download Security
                Settings</a></td>

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

Before uploading, download the CSV template and review the required columns. The template columns vary based on your test scope and the options you selected in Define Test Conditions.

**Turn-level testing**

 
| Column | Description |
| --- | --- |
| Utterance | Required. The user input to send to the agent for each test case. |
| Expected Subagent | Optional. The subagent you expect the agent to route to. Used to evaluate routing accuracy. |
| Expected Actions | Optional. The agent actions you expect to be called, formatted as a Python-style list. For example: `['GetRecordDetails', 'SummarizeRecord']` |
| Expected Response | Optional. A reference response used to score the agent's actual output. |
| Conversation History | Optional. Appears when you select **Include conversation history** in Define Test Conditions. Provide prior turns as a JSON array of role-message pairs. For example: `[{"role":"user","message":"Show me all accounts"},{"role":"agent","message":"You have account A and account B."}]` |
| Context Variable \[Field Name\] | Optional. Appears for each field you select when you enable **Include context variables** in Define Test Conditions. One column is added per variable. Leave cells blank if a value doesn't apply to a test case. |

**Conversation-level testing**

 
| Column | Description |
| --- | --- |
| Conversation | Required. A plain-language description of the scenario the simulated user follows during the conversation. |
| Conversation History | Optional. Appears when you select **Include conversation history** in Define Test Conditions. Provide prior turns as a JSON array of role-message pairs. For example: `[{"role":"user","message":"Show me all accounts"},{"role":"agent","message":"You have account A and account B."}]` |
| Expected Actions | Optional. The agent actions you expect to be called across the conversation, formatted as a Python-style list. For example: `['GetRecordDetails', 'Get_Meeting_Link']` |
| Expected Subagents | Optional. The subagent you expect the agent to route to during the conversation. |
| Context Variable \[Field Name\] | Optional. Appears for each field you select when you enable **Include context variables** in Define Test Conditions. One column is added per variable. Leave cells blank if a value doesn't apply to a test case. |

1. For conversation-level testing, under **Select Conversation Output**, choose how conversations are delivered to your agent.
    
    - Text only. Conversations are delivered as text.
    - Text and voice. Conversations are delivered as text and as audio. Results include an audio recording of the simulated conversation.
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/images/icon_note.png)
    
    Note Agentforce Employee Agents support only text outputs in the Testing Center.
    
    ![The data tab with upload test cases selected and a CSV uploaded.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/agentforce_testing_center_upload.png)
2. Under **Select Customer Personas**, choose the persona that best matches your expected user base.
    
    Customer personas simulate real-world conditions such as background noise, natural conversation flow, accents and phonetic spelling, incomplete information, and verification issues.
3. To use your own test scenarios from a CSV, select **Upload test cases**.
4. To get the CSV template for your configuration, click **Template**. Fill in your test cases and save the file.
    
    The template columns reflect the test scope and conditions you selected earlier. See the column reference above for details on what each column requires.
5. Under **Attachment**, click **Upload Files**. Select your completed CSV file and, when the upload is complete, click **Done**. You can run up to 1,000 tests per file.
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/images/icon_note.png)
    
    Note For conversation-level testing, each uploaded conversation can include up to 20 turns.
    
    ![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/images/icon_tip.png)
    
    Tip The column order in the template may differ from the column order in files you download from the test results grid. Verify your column order matches the template before uploading.
6. Click **Next**.
    
    ![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/images/icon_tip.png)
    
    Tip You can fine-tune AI-generated test cases by downloading the AI-generated test case CSV file, making your changes, and then reuploading the CSV file to the testing center.