Generate test cases

Tosca Agentic Test Automation helps you create test cases with natural language through a secure, responsible AI. This speeds up test creation and helps you improve existing portfolios.

Tosca Agentic Test Automation can create new test cases but can't update existing ones.

You can create test cases for generic web, SAP Fiori, SAP GUI and Salesforce applications. Tosca Agentic Test Automation agents use Tricentis engines and supported technologies so generated tests fit the application under test.

This topic shows you how to prepare your prompts with examples and how to generate your first test case.

Prepare your prompt

Everything starts with a prompt. Tell Tosca Agentic Test Automation what to do, for example what to click or what the result should look like. The better you describe it, the better your test case turns out.

Write the prompt

Write the way you'd explain the task to a colleague. Use the same field names, buttons, and screen titles your application uses so the agent knows exactly where to go.

Already have a manual test case? Paste it into the chat. The structure of steps and headings gives the agent much more to work with than a single sentence.

Keep these tips in mind:

  • Cover all the steps you need, including expected outcomes. The more complete your prompt, the better the result.

  • Identify controls precisely. If multiple controls share the same title, text, or image on a screen, specify which one you mean. For example, reference the third button called XYZ or label ABC within tab DEF.

  • Check out our best practices for more ways to get better results.

Provide test data

You can add test data to your prompt. It's the actual values your test should type in or verify. For example, IDs, amounts, or table rows. You can put those values right into the prompt in the chat, or attach a file when you send your message. The file can be up to 4 MB and must be a text-based format, for example TXT, JSON, CSV, XML, HTML, or MD.

This isn't the same as test data you store in Tosca Cloud for reuse across tests. Here, you just hand the values over in the chat. Check out our prompt examples and test data examples to see both approaches in action.

Structure your test data

Whether you include test data in your prompt or attach it as a file, keep it clean:

  • Include only the fields and expected outcomes your test needs.

  • Use realistic values and add edge cases where they matter.

  • Fill in all required fields. Tosca Agentic Test Automation may stop and ask you during the run if something is missing.

  • Group related values together.

  • Keep your date and number formats consistent.

Generate your first test case

After you prepare your prompt, follow this section to generate your first test case.

When you generate test cases, you can choose how Tosca Agentic Test Automation interacts with your application:

  • TBox steers controls based on their technical properties. It reads the application's control structure directly. Select TBox for generic web, SAP GUI, SAP Fiori or Salesforce applications that have accessible control hierarchies.

  • Vision AI uses visual elements to recognize controls. It works regardless of the underlying technology. Use Vision AI for applications without accessible control properties or with complex UIs. It works especially well for SAP Fiori applications.

When you generate test cases, you can choose between two different modes:

  • Co-create, the default mode, guides you through test case generation step by step in a conversational flow. Before each step, Tosca Agentic Test Automation shows you what it plans to do. You can give feedback, adjust instructions, or refine your prompt as you go.

  • In Autonomous mode, Tosca Agentic Test Automation runs all steps in sequence until the test is complete, without your input.

Follow these steps to create a test case in Co-create mode:

  1. Select Generate a test case in the Tosca Agentic Test Automation window.

  2. Select TBox or Vision AI.

  3. Select the application where you want to generate a test case.

  4. Choose Co-create at the bottom of the chat window.

  5. Give Tosca Agentic Test Automation a prompt that describes what you want to achieve with this test. Enter the test data as part of the prompt or upload a test data file as an attachment. The file can be up to 4 MB and must be a text-based format such as TXT or JSON.

    If you selected Vision AI to generate an SAP Fiori test case, Tosca Agentic Test Automation generates a set of work steps. You can edit the work steps or leave them as they are.

  6. Tosca Agentic Test Automation then describes the first test step it will perform and asks if it should proceed. If you'd like to change something, provide feedback so that Tosca Agentic Test Automation can update the test step.

  7. Confirm the step to let Tosca Agentic Test Automation proceed. Keep your mouse still while the agent works. A browser notification tells you when it's done.

  8. Continue until you're done, then select Save test case. Choose whether to reuse existing modules or create new ones. If you reuse modules, they replace the matching ones in your test case.

    Tosca Agentic Test Automation shows a link that takes you directly to the new test case.

Follow these steps to create a test case in Autonomous mode:

  1. In the Tosca Agentic Test Automation window, select Generate a test case.

  2. Select TBox or Vision AI.

  3. Select the application where you want to generate a test case.

  4. Choose Autonomous at the bottom of the chat window.

  5. Give Tosca Agentic Test Automation a prompt that describes what you want to achieve with this test. Enter the test data as part of the prompt or upload a test data file as an attachment. The file can be up to 4 MB and must be a text-based format such as TXT or JSON.

    If you selected Vision AI to generate an SAP Fiori test case, Tosca Agentic Test Automation generates a set of work steps. You can edit the work steps or leave them as they are.

  6. Select Send to submit your instructions. Step away from your mouse and keyboard, so that Tosca Agentic Test Automation can operate without interruption.

  7. When Tosca Agentic Test Automation is done, select Save test case.

  8. Choose whether to reuse existing modules or create new ones. If you reuse modules, they replace the matching ones in your test case. This avoids duplicates and simplifies maintenance.

    After you save, Tosca Agentic Test Automation shows a link that takes you directly to the new test case.

In this example, you create a simple test case that navigates to a website:

  1. Open a new window in your Edge browser.

  2. In the Tosca Agentic Test Automation window, select Generate a test case, then select the browser window for which you want to generate a test case.

  3. Enter the prompt Go to tricentis.com and send it.

  4. Follow the test case generation flow, then select Save test case.

Edit work steps

When you use Vision AI to generate an SAP Fiori test case, Tosca Agentic Test Automation generates work steps from your prompt and test data. You can proceed with the work steps as they are or edit them.

To edit the work steps, follow these steps:

  1. Select Let me edit it first when prompted.
  2. Edit values or delete steps as needed.
  3. When you're satisfied with the work steps, select send.

Examples of prompts

The following examples show how to write prompts with test data included directly in the chat. This approach works well when your instructions and data are closely tied together.

This prompt includes step-by-step instructions with embedded test data. Copy and paste it directly into the chat text field:

Copy 
Create purchase order

1. Search for 'Create Purchase Order'
2. Click on Dropdown, and Click on the Standard PO
3. Fill in the data for the following fields:
- Vendor: 0010300002
- Purch. Org.: 1010
- Purch. Group: 001
- Company Code: 1010
4. In the first table, fill in the first row the following: Material: SF-FL-FORK-L, PO Quantity: 20, Plnt: 1010

This prompt walks you through a multi-step web form with all test data inline. Copy and paste it directly into the chat text field:

Copy 
Step 1: select the Automobile table
Step 2: Enter Vehicle Data
Action: On the Enter Vehicle Data screen, input the following details:
    Make: BMW
    kW: 120
    Date of Manufacture: 06/19/2023
    Number of Seats: 5
    Fuel Type: Diesel
    List Price: 17500
    License Plate Number: WU-1234AT
    Annual Mileage: 15000
    Expected Result: Vehicle data is entered correctly.
    Proceed to Insurant Data

Action: Click on the Next » button.
Expected Result: The Enter Insurant Data screen is displayed.

Step 3: Enter Insurant Data
Action: On the Enter Insurant Data screen, input the following details:

    First Name: Rywuzdz
    Last Name: Cdxtlpg
    Date of Birth: 12/12/1989    
    Gender: Male
    Street Address: Teststraße 123
    Country: Austria
    Zip Code: 1120
    City: Wien
    Occupation: Employee
    Hobbies: Select 'Speeding'
Action: Click on the Next » button.
Expected Result: The Enter Product Data screen is displayed and direct to the next page.

Step 4: Enter Product Data
Action: On the Enter Product Data screen, input the following details:

    Start Date: 07/19/2025
    Insurance Sum: 15,000,000.00
    Damage Insurance: No Coverage
    Merit Rating: Bonus 7
    Optional Products: Select 'Euro Protection' and 'Legal Defense Insurance'
    Courtesy Car: Yes
Expected Result: Product data is entered correctly.

Step 5: Proceed to Price Option Selection
Action: Click on the Next » button.
Expected Result: The Select Price Option screen is displayed.

Step 6: Select Price Option
Action: On the Select Price Option screen, select the 'Platinum' radio button.
Expected Result: 'Platinum' price option is selected.

Step 7: Proceed to Quote Submission
Action: Click on the Next » button.
Expected Result: The Send Quote screen is displayed.

Step 8: Enter Contact and Account Information
Action: On the Send Quote screen, input the following details:
    E-Mail: j.snow@tricentis.com
    Phone: 004369911223344
    Username: jsnow
    Password: Password+12
    Confirm Password: Password+12
    Comments: OSV rocks!

Expected Result: Contact and account information is entered correctly.

Step 9: Submit the Quote
Action: Click on the « Send XML» button.
Expected Result: The quote is submitted successfully.

Step 10: Confirm Submission
Action: In the Confirmation Dialog, click on the OK button.
Expected Result: Submission confirmation is acknowledged.

Step 11: Return to Home
Action: Click on the Tricentis link in the Confirmation Dialog.
Expected Result: Navigated back to the home page.

Examples of test data

The following examples show how to structure test data that you upload as a file. Use these formats when your test data is separate from your instructions.

Natural language formatting

The following examples use natural language format for SAP applications.

Use a short prompt like this:

Copy 
Create Sales orders VA01

Then upload the test data as a separate text file:

Copy 
Screen: Create Sales Documents
Data: 
- Order Type: OR
- Sales Organization: 1000
- Distribution Channel: 10
- Division: 00


Screen: Create Standard Order: Overview
Data: 
- Sold-to Party:  1175
- Ship-to Party: 1175
- Cust Reference: Test
- All Items table:
- Item: 2
- Material: M-09
- Order quantity: 5

Use a short prompt like this:

Copy 
Create a sales order with outbound delivery in SAP GUI

Then upload the test data as a separate text file:

Copy 
Screen: Create sales orders - va01
Data: - Order Type: OR
      - Sales Organization: 1000
      - Distribution Channel: 10
      - Division: 00

Screen: Create Sales Document
Data: 
    - Sold-to Party: 1175
    - Ship-to Party: 1175
    - Cust Reference: Test
    - All Items table:
    - Item: 2
    - Material: M-09
    - Order quantity: 5
Wait for status bar with Order number
Buffer Standard Order number 

Screen: Create Outbound Delivery with Order Reference
Data:
    - Order: Use buffered standard order number
    - Shipping Point: 1201
    - Selection Date: 03/18/2026
Wait for status bar with Delivery number
Buffer Delivery number 
Stop test

JSON formatting

The following examples show test data sets in JSON format and cover various field types. Copy and paste this data into a JSON file and then upload it to Tosca Agentic Test Automation.

Copy 
{
  "Username": "test_user",
  "Password": "password123"
}
Copy 
{
  "Customer Details": {
    "Name": "John Doe",
    "Contact Number": "123-456-7890",
    "Email": "john.doe@example.com"
  },
  "Order Details": {
    "Order Type": "Online",
    "Payment Method": "Credit Card"
  }
}
Copy 
{
  "Order Items Table": [
    {
      "Item": 1,
      "Product Name": "Widget A",
      "Quantity": 2,
      "Price": 10.00
    },
    {
      "Item": 2,
      "Product Name": "Widget B",
      "Quantity": 5,
      "Price": 20.00
    }
  ]
}
Copy 
{
  "Order Items": [
    {
      "Item": 1,
      "Product Name": "Widget A",
      "Quantity": 1,
      "Price": 10.00
    }
  ]
}
Copy 
{
  "Order Items": [
    {
      "Item": 1,
      "Product Name": "Widget A",
      "Quantity": 2,
      "Price": 10.00
    },
    {
      "Item": 2,
      "Product Name": "Widget B",
      "Quantity": 5,
      "Price": 20.00
    }
  ]
}
Copy 
{
  "Credentials": {
    "User": "xxx",
    "Password": "xxx"
  },
  "Test Organizational Data": {
    "Order Type": "OR",
    "Sales Organization": "1000",
    "Distribution Channel": "10",
    "Division": "00"
  },
  "Test Sales Order Data": {
    "Sold-To Party": "1175",
    "Ship-To Party": "1175",
    "Cust. Reference": "Customer Test",
    "All Items Table": [
      {
        "Item": 1,
        "Material": "M-09",
        "Order Quantity": 5
      },
      {
        "Item": 2,
        "Material": "M-09",
        "Order Quantity": 10
      }
    ]
  },
  "Outbound Delivery Data": {
    "Shipping Point": 1201,
    "Selection Date": "11/21/2026"
  }
}