> This is part 1 of 2 of the full documentation (pages 1–100 of 140).
> The content is paginated: fetch every part to see all of it.
> Next part: https://docs.walnutai.ai/llms-full.txt/1
> Page index: https://docs.walnutai.ai/llms.txt

# Welcome

Welcome to **WalnutAI**, an AI-powered application development platform that enables you to build complete applications simply by describing what you need. By turning prompts into working components, WalnutAI automatically handles requirements, logic, structure, and lifecycle management, eliminating the need for manual setup across multiple tools. It streamlines the entire development process from idea to deployment so you can create, iterate, and manage applications with minimal effort and full traceability.

By centralizing every stage of the lifecycle, WalnutAI helps teams stay connected and maintain clear traceability from the original business idea through to technical execution and delivery.

#### What does WalnutAI do?

WalnutAI unifies your development ecosystem by centralizing information from multiple sources into a structured intelligence layer. It automates the "heavy lifting" of the SDLC through a sophisticated, automated pipeline:

{% stepper %}
{% step %}

#### **Upload BRD**

Simply upload your Business Requirement Document (PDF or Docx) directly to the WalnutAI platform to begin the transformation.
{% endstep %}

{% step %}

#### **AI Processing**

Our advanced AI parses the document structure, intelligently identifying and extracting core Epics, Features, and Modules.
{% endstep %}

{% step %}

#### **Interactive Review**

Use the built-in Question-Back mechanism to verify the extracted structure, ensuring the AI You can also accomplish this simply by prompting the system perfectly captures your original intent.
{% endstep %}

{% step %}

#### **Story Generation**

WalnutAI automatically generates detailed User Stories with clearly defined Acceptance Criteria.
{% endstep %}

{% step %}

#### **Test Cases**

Associated **Test Cases** are automatically created and linked to the generated User Stories for complete validation coverage.
{% endstep %}

{% step %}

#### **Code & Deploy**

Assign generated stories to AI agents to produce code, run automated tests, and create ready-to-merge Pull Requests.
{% endstep %}

{% step %}

#### Gap Analysis

Conduct gap analysis to identify missing requirements, inconsistencies, or validation gaps across Epics, User Stories, Test Cases, and Code.
{% endstep %}
{% endstepper %}

{% hint style="warning" icon="lightbulb" %}
Just have an idea and no formal requirements? You can still get started by simply prompting the system.
{% endhint %}

#### What makes WalnutAI different?

* **Unified Workspace:** WalnutAI is an AI-powered platform that enables teams to build applications within a structured ALM framework, seamlessly guiding them from idea to technical implementation in a single unified environment.
* **AI-Driven Intuition:** Makes building software more intuitive by allowing teams to describe requirements or logic in plain language.
* **Structured Outputs:** Automatically transforms natural language inputs into structured, technical outputs that follow strict governance standards.

#### Core Capabilities

* **End-to-End Management:** Manage requirements, development, testing, execution, analytics, and delivery within a single unified platform, ensuring continuity across all stages without the need to switch between multiple tools.
* **Gap Analysis:** Analyze differences between uploaded inputs (requirements, code, test cases) and actual outputs. WalnutAI identifies inconsistencies and missing elements, providing recommended changes to maintain alignment.
* **Intelligence Hub:** A central intelligence layer that connects all lifecycle artifacts. It automates the generation, enrichment, and alignment of data across your existing tools and teams.
* **Governance & Quality Assurance:** Apply validation at every stage of development. This ensures that every step remains strictly aligned with the original business intent and quality standards.


# Quickstart

To access WalnutAI, your organization's Admin must first add you as a user to the platform. This process ensures proper security and access control for your workspace.

**How Account Setup Works**

* The admin will add you as a user with the appropriate role and permissions.
* You will receive an email containing a secure link to set your password.
* Click the link, create a password that meets the security requirements, and confirm it.
* Once your password is set, you will be redirected to the login page.
* Sign in using your email address and the newly created password to access your workspace.

{% hint style="info" %}
Want to learn about creating a new project? Go to the [Projects](/getting-started/projects) section to learn more.
{% endhint %}


# Projects

Projects serve as the foundation of your WalnutAI workspace. This section guides administrators through creating projects, configuring AI models, and importing data to build a cohesive workflow environment.

* Each project functions independently with its own requirements, development artifacts, and team members.
* Projects allow you to monitor progress at every stage, from initial planning to final delivery.
* Access to projects is role-based to ensure proper governance and control.
  * **Admin Privileges:** Only Admins can create, edit, delete projects, or assign team members, ensuring secure workspace governance.
  * &#x20;**Standard User Access:** Users can work within their assigned projects and switch between different projects as needed, but they do not have permission to modify project-level configurations.


# Create a New Project

Creating a new project in WalnutAI is a streamlined and organized process that enables you to quickly set up your workspace, configure AI models, and optionally connect existing tools and data sources.

The setup is completed in three main steps:

* [**Project Setup & AI Model Selection:**](/getting-started/projects/create-a-new-project/project-setup-and-ai-model-selection) Define your project name and choose the AI model that will drive your project’s intelligence.
* [**External Data & Connections:**](/getting-started/projects/create-a-new-project/external-data-and-connections) Select and configure the third-party tools you want to connect to your project to import existing data.
* [**Review & Create Project:**](/getting-started/projects/create-a-new-project/finalizing-the-project-setup) Verify your project settings and finalize the creation process.

This guide walks you through each stage from project initialization and AI model to data integration and final launch ensuring your workspace is fully prepared for active use.


# Project Setup & AI Model Selection

Creating a project establishes the AI intelligence that powers WalnutAI's capabilities. You must define your workspace identity and integrate the language model that drives intelligent features.

* **Define Project Identity:** Enter a clear, descriptive Project Name that reflects the scope of your work.
* **Select LLM:** Bring your own Large Language Model to power your project’s AI capabilities.
  * Supported providers include **Claude (Anthropic)**, **Gemini (Google)**, **OpenAI**, **Azure OpenAI**, **AWS Bedrock**, **Moonshot (Kimi)**, **Qwen (Alibaba)**, **DeepSeek**, **GLM (Zhipu AI)**, **Ollama**, **OpenRouter**, **Together AI**, **Groq**, and **Fireworks AI**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FFldIlARFKFNEYcTzepMd%2FScreenshot%202026-11-04%20at%2012.31.25%E2%80%AFPM.png?alt=media&amp;token=5175f839-dd80-401e-9d4e-5902e8d85c67" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you do not have your own LLM, please contact the support team for assistance.
{% endhint %}

* **Configure Credentials:** Provide connection credentials such as:
  * **API Key:** Secure key generated from your AI provider account
  * **Deployment Name:** Model or deployment identifier
  * **API Version**: Applicable API version
  * **Endpoint:** Service endpoint URL
* **Usage & Billing Controls:** Configure limits to manage costs and performance.
  * **Spending Limit ($):** Set the maximum budget for AI usage within the project.
  * **Rate Limit (requests/minute):** Control the number of API requests allowed per minute.
  * **Usage Alerts:** Enable notifications when usage approaches the defined limits.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FShEwZtstRATMJNk67AQJ%2FScreenshot%202026-11-04%20at%2012.32.01%E2%80%AFPM.png?alt=media&amp;token=58815331-9759-467d-93af-3c06b1c2d063" alt=""><figcaption></figcaption></figure>

* Click '**Test Connection'** to validate the provided credentials. Once the connection is verified, click '**Save Configuration**' to activate the AI model for your project.


# External Data and Connections

**When to Use External Data & Connections:**

* Connect external tools after configuring your AI model if you want to import existing data into your project.&#x20;
* If you are starting from scratch, you can skip this step and proceed with the setup.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FeDJtbn6m77PGzyKV6qH0%2FScreenshot%202026-11-04%20at%2012.39.51%E2%80%AFPM.png?alt=media&amp;token=cea63123-8a4e-4aa8-bd10-fb4965f39ffd" alt=""><figcaption></figcaption></figure>

**Connect External Tools**

* **Project Management:** Connect to [Jira](/getting-started/projects/create-a-new-project/external-data-and-connections/how-to-integrate-jira-with-walnutai) or [Azure DevOps](/getting-started/projects/create-a-new-project/external-data-and-connections/how-to-integrate-azure-devops-with-walnutai) to synchronize epics, user stories, tasks, defects and any other custom issue types automatically.
* **Design Integration:** Connect to [Figma ](/getting-started/projects/create-a-new-project/external-data-and-connections/how-to-integrate-figma-to-walnutai)to generate user stories and test cases directly from design prototypes.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FGwqGacAyza88sGADqNtY%2FScreenshot%202026-11-04%20at%2012.40.45%E2%80%AFPM.png?alt=media&amp;token=1f224b35-f1e4-4ac0-847a-3f9443374d6c" alt=""><figcaption></figcaption></figure>

* **Code Repositories:** Connect to [GitHub](/getting-started/projects/create-a-new-project/external-data-and-connections/how-to-integrate-github-with-walnutai), [GitLab](/getting-started/projects/create-a-new-project/external-data-and-connections/how-to-integrate-gitlab-with-walnutai), [Bitbucket](/getting-started/projects/create-a-new-project/external-data-and-connections/how-to-integrate-bitbucket-with-walnutai), [Azure Repos ](/getting-started/projects/create-a-new-project/external-data-and-connections/how-to-integrate-azure-repos-with-walnutai)or [AWS CodeCommit](/getting-started/projects/create-a-new-project/external-data-and-connections/how-to-integrate-aws-codecommit-with-walnutai) to integrate your codebase.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FRzIPw6VuRg5TqcNWTXLR%2FScreenshot%202026-11-04%20at%2012.41.19%E2%80%AFPM.png?alt=media&amp;token=8a9f2b2b-c6cc-43d1-8baa-19c18387ad1c" alt=""><figcaption></figcaption></figure>

* **Rules & Guidelines:** Use [Rules & Guidelines](/getting-started/projects/create-a-new-project/external-data-and-connections/rules-and-guidelines) section to provide project-specific instructions, domain knowledge, and reference documents that guide how the AI interprets information and generates outputs.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FF9c7NC87XGFI4ERxG8Ow%2FScreenshot%202026-11-04%20at%2012.42.13%E2%80%AFPM.png?alt=media&amp;token=dcf91eaf-e324-430e-9548-f141811b89c0" alt=""><figcaption></figcaption></figure>


# How to Integrate Jira with WalnutAI?

#### **Steps to Generate a Jira API Token**

* Log in to your Jira account.
* On the right side of the Jira dashboard, click on your profile icon (top right corner).

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FIM1ANVcGtKJ0sPZyK6oZ%2Funknown.png?alt=media&amp;token=f548a54f-767c-46fc-b856-0276986a654b" alt=""><figcaption></figcaption></figure>

* From the dropdown, select Manage account.
* Once on your account management page, click on the Security tab.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FysMQPewrENsX3tnSKjQt%2Funknown.png?alt=media&amp;token=7e70db86-d605-47dd-960f-015eba0bb5d0" alt=""><figcaption></figcaption></figure>

* Scroll down to find the API tokens section and click on Create and manage API tokens.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FYv6RzBnKf8XIahMpLgQl%2Funknown.png?alt=media&amp;token=b2c770be-1498-4059-aa84-098d1a3eeb1f" alt=""><figcaption></figcaption></figure>

* On the API tokens page, click the Create API token button.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FebPoeyT58Di6XIAb9HBO%2Funknown.png?alt=media&amp;token=83fbdcd4-8b79-4d03-b162-65584b3ec2ae" alt=""><figcaption></figcaption></figure>

* A pop-up window will appear. Provide a name for your API token.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FickQcK9B47n3UO9EVKoG%2Funknown.png?alt=media&amp;token=b123aa2f-202c-4833-b52d-d6813434f080" alt=""><figcaption></figcaption></figure>

* Generate and Copy the Token:
* After naming the token, click on 'Create'.
* Your API token will be generated and displayed. Copy the token immediately, as it won’t be shown again.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FfnHzKM3EsYFMrrua6x1y%2Funknown.png?alt=media&amp;token=548ec691-5572-4bd1-a41c-978b821e37df" alt=""><figcaption></figcaption></figure>

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FLG7ctnmQWT9H1AdSnDm6%2Funknown.png?alt=media&amp;token=3c1826a3-5bd7-411c-b290-e52613701410" alt=""><figcaption></figcaption></figure>

#### **Connect Jira to WalnutAI**

* Go to Integrations and select Jira.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F29lSbfrbBqn7V7ZtD2Cx%2FScreenshot%202026-07-30%20at%201.12.10%E2%80%AFPM.png?alt=media&amp;token=6a1bcf14-02a0-40df-9049-09d67e63f840" alt=""><figcaption></figcaption></figure>

* Enter the Jira URL, the associated email ID, and the generated API token.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fv8clsfyTp4tRGqUQBcHb%2FScreenshot%202026-07-30%20at%201.04.34%E2%80%AFPM.png?alt=media&amp;token=fdaf9723-e258-4d09-83cc-28a979283112" alt=""><figcaption></figcaption></figure>

* Click Test Connection to verify the credentials.
* Select the Jira project you want to connect, then click Activate & Setup to configure the project integration.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FyOAV9pADmCItJQaH2QE8%2FScreenshot%202026-07-30%20at%201.08.53%E2%80%AFPM.png?alt=media&amp;token=651293b9-24d6-4650-961d-e6eeac9f9962" alt=""><figcaption></figcaption></figure>

* Map the required Jira fields to WalnutAI.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FNCIvZGxH0Wi8za6nQQEJ%2FScreenshot%202026-07-30%20at%201.10.16%E2%80%AFPM.png?alt=media&amp;token=b41ac8a9-372b-46ef-b1bb-8c9f3d445c33" alt=""><figcaption></figcaption></figure>

* Review the configuration and click Connect to complete the integration.

{% hint style="info" %}
Refer to the [Jira Sync](/overview-and-tracking/action-item/synchronizing-requirements-with-jira) guide for the next steps on pulling and pushing requirements between Jira and WalnutAI.
{% endhint %}


# How to Integrate Azure DevOps with WalnutAI?

#### **Steps to Generate a Azure DevOps Personal Access Token**

* Sign in to your **Azure account** and open **Azure DevOps**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F4CE0gKTiSoHOwgvPAwhM%2Fimage.png?alt=media&amp;token=94f0ac2e-4849-4613-bc12-d83fb99fa161" alt=""><figcaption></figcaption></figure>

* Choose your **Project**.
* Click on **'User Settings'.**

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F1bHnHDrO5PqRRvOHXL6g%2Fimage.png?alt=media&amp;token=04083e79-7f76-463d-8d4e-9370d4b925a5" alt=""><figcaption></figcaption></figure>

* Select **Personal Access Tokens**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FXB5g5lLADh4N1jikmGFT%2Fimage.png?alt=media&amp;token=b23e0c4b-715b-4f1f-bf98-06d73354eb93" alt=""><figcaption></figcaption></figure>

* Click **'Create New Token'**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FwQiUg4caj5CHDhcd8bf5%2Fimage.png?alt=media&amp;token=e598e49c-7f8f-482d-ac9a-e3010a432793" alt=""><figcaption></figcaption></figure>

* Choose the required permissions.
* Generate the token and copy it.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FERACDJq04AgR6RQFuDBN%2Fimage.png?alt=media&amp;token=eb11d052-1cd9-41a4-b311-363916fccec2" alt=""><figcaption></figcaption></figure>

#### **Connect Azure DevOps to WalnutAI**

* Log in to WalnutAI.
* Go to Integrations and select **Azure DevOps.**

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FgQNkKbFT2Kz8VWaRoxsr%2FScreenshot%202026-07-30%20at%201.13.48%E2%80%AFPM.png?alt=media&amp;token=3bce66ae-90f2-40b6-b3f0-296167a4a7bd" alt=""><figcaption></figcaption></figure>

* Enter the Azure DevOps URL, then paste the generated API token.
* Click Test Connection to verify the credentials.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKXLFJywiLMsKd249b47c%2FScreenshot%202026-07-30%20at%201.17.13%E2%80%AFPM.png?alt=media&amp;token=39693eff-a9c1-4b2d-a126-75e805d3e96d" alt=""><figcaption></figcaption></figure>

* Select the project you want to connect, then click Activate & Setup to configure the project integration.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FzqhHdP9G74YkdogXH7Ok%2FScreenshot%202026-07-30%20at%201.19.14%E2%80%AFPM.png?alt=media&amp;token=66c5176b-5229-4bb5-9730-b95f80ee1d6e" alt=""><figcaption></figcaption></figure>

* Map the required Azure DevOps fields to the corresponding WalnutAI fields.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FPuymjGsNcJERljU8LsPB%2FScreenshot%202026-07-30%20at%201.20.45%E2%80%AFPM.png?alt=media&amp;token=8ef44ce4-f70a-4d7b-83d9-bde9a031ba27" alt=""><figcaption></figcaption></figure>

* Review the configuration and click Connect to complete the integration.

{% hint style="info" %}
Refer to the [Azure DevOps ](/overview-and-tracking/action-item/synchronizing-requirements-with-azure-devops)Sync guide for the next steps on pulling and pushing requirements between Azure DevOps and WalnutAI.
{% endhint %}


# How to Integrate Figma to WalnutAI?

#### **Steps to Generate a Figma Personal Access Token**

* Sign in to your Figma account.
* Click on your profile icon and select **Settings**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FS9PsMVMEXmcC1HGF2Q0w%2FScreenshot%202026-07-28%20at%206.50.49%E2%80%AFPM.png?alt=media&amp;token=74ec56f8-8c4a-4efd-b8e0-fa242b9ca3d9" alt=""><figcaption></figcaption></figure>

* Navigate to the **Security** section.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F5HsY8NELQsUXclVFPGze%2FScreenshot%202026-07-28%20at%206.52.57%E2%80%AFPM.png?alt=media&amp;token=1cf2254e-ed55-402f-9244-c93dca07a411" alt=""><figcaption></figcaption></figure>

* Under **Personal Access Tokens (PAT)**, click **Generate New Token**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FdysYnM9Rpo7ysF944dQt%2FScreenshot%202026-07-28%20at%206.54.16%E2%80%AFPM.png?alt=media&amp;token=aea81af4-db75-4875-bc7f-fd1cdc8bdae5" alt=""><figcaption></figcaption></figure>

* Enter a name for the token.
* Select the required permissions.
* Click **Generate Token** and copy the generated token.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F6C0JABJ5h4Xtl1NdQwoD%2FScreenshot%202026-07-28%20at%206.55.58%E2%80%AFPM.png?alt=media&amp;token=2d818112-0c14-4a0f-9a0a-fc4301b57f70" alt=""><figcaption></figcaption></figure>

* Copy the Team ID from your Figma URL.

#### Connect Figma to WalnutAI

* Log in to WalnutAI.
* Go to Integrations, select **Figma**, then click **Configure & Connect.**

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FahrcN1mmgrFWkkahQPg4%2FScreenshot%202026-07-28%20at%206.58.29%E2%80%AFPM.png?alt=media&amp;token=fb498254-d5cc-4b0a-afd1-6e8d80d93443" alt=""><figcaption></figcaption></figure>

* Paste the generated Personal Access Token.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FENg1j5ArGKTJJXFKGsy7%2FScreenshot%202026-07-28%20at%206.57.14%E2%80%AFPM.png?alt=media&amp;token=a47d7f52-2060-4649-b684-82d7ac616b09" alt=""><figcaption></figcaption></figure>

* Click Connect with Token.
* Once the connection is successful, navigate to the **Intelligence Hub** and select **Figma**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FcNQzKsSpZlYYYuTEXVnT%2FScreenshot%202026-07-28%20at%207.00.54%E2%80%AFPM.png?alt=media&amp;token=cb1d6fa7-1851-4ac8-bee2-2f126ce7edaf" alt=""><figcaption></figcaption></figure>

* Enter the **Team ID**, then select the required **Project, File, and Page** from which you want to generate the Requirements or Test Cases.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FT023p8UF0YC0dO86NH6z%2FScreenshot%202026-07-28%20at%207.01.46%E2%80%AFPM.png?alt=media&amp;token=e05002ad-e096-4bce-9e87-00773850bf56" alt=""><figcaption></figcaption></figure>


# How to Integrate GitHub with WalnutAI?

#### **Steps to Generate a** GitHub Personal Access Token

* Log in to your GitHub account.
* Click on your profile picture and open the User Navigation Menu.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FvlNL5gwhNf1agAXsSIeg%2Funknown.png?alt=media&amp;token=f2685766-49fd-463d-8977-deb528bdaa93" alt=""><figcaption></figcaption></figure>

* Select Settings.
* Navigate to Developer settings.
* Click Personal access tokens.
* Select Tokens and click Generate new token.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F6p3xHFqXOUJqtpORwmnJ%2Funknown.png?alt=media&amp;token=8cefd208-038a-4840-b653-e094a84860b2" alt=""><figcaption></figcaption></figure>

* Choose the required permissions.
* Generate the token and copy it.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FBUj6fWYArfJZcgeOGHDB%2Funknown.png?alt=media&amp;token=7cc05f75-4981-40aa-a825-301d54c41ace" alt=""><figcaption></figcaption></figure>

#### **Connect GitHub to WalnutAI**

* Log in to WalnutAI.
* Go to Integrations and select GitHub.
* Paste the copied Personal Access Token.
* Click Validate and Fetch to verify the token and retrieve repository details.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FSIBrEVeNVNtznP3NNWdb%2Funknown.png?alt=media&amp;token=4dc2405c-9758-4386-b46c-a7544989123a" alt=""><figcaption></figcaption></figure>

* Select the required repositories.
* Choose the relevant branches.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FDyCkYOADaezm7rwatLHB%2Funknown.png?alt=media&amp;token=177fab15-be06-48ae-82a5-b160bc3afaa8" alt=""><figcaption></figcaption></figure>

* Click Save to complete the integration.
* Go to the WalnutAI code editor and clone the project.

To know more about the **Code Editor**, refer to the relevant Code Editor section


# How to Integrate GitLab with WalnutAI

#### **Steps to Generate a GitLab Personal Access Token**

* Log in to GitLab
* Click your Profile Avatar

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FcOvW0byFVEBljiYiabTH%2Funknown.png?alt=media&amp;token=ff7b349e-9fc0-437e-9af3-849729fafed6" alt=""><figcaption></figcaption></figure>

* Go to Preferences

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FPAHb5T5jATZOpAVjwK8m%2Funknown.png?alt=media&amp;token=874a5ada-cb10-4817-a738-ddf5a1982aa5" alt=""><figcaption></figcaption></figure>

* Click Access Tokens
* Fill in the details and choose the required permissions.
* Generate the token and copy it.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FhMjJCU6OCeUhVK7rvKKf%2Funknown.png?alt=media&amp;token=40e7b2df-c27e-4641-9cf8-917470a32597" alt=""><figcaption></figcaption></figure>

#### **Connect GitLab to WalnutAI**

* Log in to WalnutAI.
* Go to Integrations and select GitLab.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FnHFwXVjSXpVavm2XNr4f%2Funknown.png?alt=media&amp;token=18791564-d3be-4b6b-ad65-32b2b5f04f48" alt=""><figcaption></figcaption></figure>

* Paste the copied Personal Access Token.
* Click Validate and Fetch to verify the token and retrieve repository details.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FSRPRcXue598Diw8GCTju%2Funknown.png?alt=media&amp;token=893d82b2-11cd-4e6e-820c-cdbf4efa2b72" alt=""><figcaption></figcaption></figure>

* Select the required repositories.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FS5t3O3iZFcEMZrWs8eZc%2Funknown.png?alt=media&amp;token=daf8e463-2f49-46f0-9a6d-e5aa400e5358" alt=""><figcaption></figcaption></figure>

* Choose the relevant branches.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F1qC8OGkoFIY75VT1zWHo%2Funknown.png?alt=media&amp;token=c096eb4a-9cb1-4fb3-b589-9e207699a0ec" alt=""><figcaption></figcaption></figure>

* Click Connect to complete the integration.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FVxSNRB11wzhVf1AqU8RT%2Funknown.png?alt=media&amp;token=512ce78e-3291-4018-8ec0-3800ba012fff" alt=""><figcaption></figcaption></figure>

* Go to the WalnutAI code editor and clone the project.


# How to Integrate Bitbucket with WalnutAI?

**Steps to Generate a Bitbucket API Token**

* Log in to your Bitbucket account.
* Click your profile avatar (top right).
* Select Account settings.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FuldmORcaWpAYO99oEpI4%2Funknown.png?alt=media&amp;token=1375bf9b-6740-48fb-9b37-cd5992682b3f" alt=""><figcaption></figcaption></figure>

* Navigate to Security → Create and manage API tokens.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FNgnJEbXGC3XTdenpA92X%2Funknown.png?alt=media&amp;token=0a76e2d4-13b7-4e51-8441-3ca2d1e3795a" alt=""><figcaption></figcaption></figure>

* Click Create API token.
* Configure the required permissions.
* Click Create and copy the API token

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FJ25uX9eqxfDFX645H4Y1%2Funknown.png?alt=media&amp;token=477f9607-026c-4bb7-9fe8-f90c164c7a64" alt=""><figcaption></figcaption></figure>

#### Connect Bitbucket to WalnutAI

* Log in to WalnutAI.
* Go to Integrations and select Bitbucket.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FXHdE7PlU5WlXuMInWhuk%2Funknown.png?alt=media&amp;token=c776baf5-8fe4-44e4-88da-08431701ace1" alt=""><figcaption></figcaption></figure>

* Paste the copied Token, then enter the email ID and username associated with your account.
* Click Validate and Fetch to verify the token and retrieve repository details.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FR82qocoIr6qNuL547r0W%2Funknown.png?alt=media&amp;token=56d07579-dc2e-4b8c-bac2-34c80f142ad7" alt=""><figcaption></figcaption></figure>

* Select the required repositories and relevant branches.
* Click Connect to complete the integration.


# How to Integrate Azure Repos with WalnutAI?

**Steps to Generate an Azure Repos Personal Access Token (PAT)**

* Log in to your Azure DevOps account.
* Click the User Settings icon (top right).
* Select Personal access tokens.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FuDNnVllVAxDQBfrs3tY2%2FScreenshot%202026-07-30%20at%2012.05.45%E2%80%AFPM.png?alt=media&amp;token=4d0aa74b-f659-4c62-82dc-c279c3252c80" alt=""><figcaption></figcaption></figure>

* Click **'Create New Token'**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FhHaMzZb0M1058QB72BDO%2FScreenshot%202026-07-30%20at%2012.13.19%E2%80%AFPM.png?alt=media&amp;token=ac179210-ba95-47f1-bba1-5ac9d1ba500b" alt=""><figcaption></figcaption></figure>

* Choose the required permissions.
* Generate the token and copy it.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FERACDJq04AgR6RQFuDBN%2Fimage.png?alt=media&amp;token=eb11d052-1cd9-41a4-b311-363916fccec2" alt=""><figcaption></figcaption></figure>

**Connect Azure Repos to WalnutAI**

* Log in to WalnutAI.
* Go to Integrations and select Azure Repos.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FjvMpUag8ASc9vr2tCu5c%2FScreenshot%202026-07-30%20at%2011.59.57%E2%80%AFAM.png?alt=media&amp;token=5f3b3472-e8bb-46bb-b593-3750bf5ae74b" alt=""><figcaption></figcaption></figure>

* Enter your Azure DevOps Organization URL and the copied Personal Access Token (PAT).

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FVXfza9am3MRVnbt2Rld1%2FScreenshot%202026-07-30%20at%2012.21.02%E2%80%AFPM.png?alt=media&amp;token=ebb67fca-d8d2-4026-8590-8434b91db102" alt=""><figcaption></figcaption></figure>

* Click Validate and Fetch to verify the token and retrieve the available repositories.
* Select the required Repository and Branch.
* Click Connect to complete the integration.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FrIWDTuDXWd0PZUVfm1OI%2FScreenshot%202026-07-30%20at%2012.32.52%E2%80%AFPM.png?alt=media&amp;token=c12f45dc-7402-4222-a826-090b0b353f23" alt=""><figcaption></figcaption></figure>


# How to Integrate AWS CodeCommit with WalnutAI?

**Steps to Generate AWS CodeCommit Git Credentials**

* Log in to the AWS Management Console.
* Open the IAM (Identity and Access Management) service.
* In the left navigation pane, select Users.
* Choose the IAM user that requires access to AWS CodeCommit.
* Open the Security credentials tab.
* Scroll to the HTTPS Git credentials for AWS CodeCommit section.
* Click Generate credentials (or Generate API Key, then select AWS CodeCommit, depending on your AWS console version).
* Copy the generated Git Username and Git Password, or download the credentials file. These credentials are displayed only once, so store them securely

**Connect AWS CodeCommit to WalnutAI**

* Log in to WalnutAI.
* Go to Integrations and select AWS CodeCommit.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fdu4PWEvtc8Cz741tZHBn%2FScreenshot%202026-07-30%20at%2012.51.37%E2%80%AFPM.png?alt=media&amp;token=7d149489-a6f1-4843-b552-3659c6713f37" alt=""><figcaption></figcaption></figure>

* Choose the AWS Region where your CodeCommit repositories are hosted (for example, us-east-1).
* Enter your AWS Access Key ID and AWS Secret Access Key.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FrC5EuRSmr5CvsjA4W9k0%2Fimage%20(5).png?alt=media&amp;token=e2ff1aae-94b7-4400-bd35-62124d2676dc" alt=""><figcaption></figcaption></figure>

* Click Fetch Repositories.
* Select the Repository you want to connect.
* Select the Branch you want to use.
* Click Connect to complete the integration.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FTADcdq7mxvcI6zrYHZBj%2Fimage%20(6).png?alt=media&amp;token=faefe3e5-4a9f-44a0-8de4-4a84b66e1189" alt=""><figcaption></figcaption></figure>


# Rules & Guidelines

Rules & Guidelines allow you to provide project-specific instructions, define AI response formats, and upload reference documents that WalnutAI uses when performing AI-powered actions within the project.

This section consists of three components: **System Instruction, Guidelines, and Documents**.

* **System Instruction:** Use System Instruction to define the overall context of your project, including its purpose, intended users, business context, and preferred terminology and tone.
  * The system instruction is applied to every AI action performed within the project, ensuring consistent and contextually relevant responses.
  * **Example:** If you are working on a healthcare project, you can provide an instruction such as: *"This project is designed for healthcare application testing. Use appropriate healthcare terminology and maintain a professional tone when generating requirements, user stories, and test cases."*

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fc2fpRoU9Jll83rtxWYHp%2FScreenshot%202026-11-04%20at%2012.54.46%E2%80%AFPM.png?alt=media&amp;token=d58d5d74-9831-428b-afda-4c6414da4871" alt=""><figcaption></figcaption></figure>

* **Guidelines:** Use Guidelines to define specific rules and formatting requirements that the AI should follow when generating content.
  * Each guideline can be independently enabled or disabled based on your project requirements.
  * For example, you can define guidelines for:
    * **User Story Format:** Generate user stories using the format: As a \[role], I want \[feature], so that \[benefit].
    * **Test Case Format:** Include preconditions, test steps, and expected results in every test case.
    * **Naming Conventions:** Follow predefined naming conventions when generating requirements and test cases.
    * **Documentation Standards:** Maintain a consistent structure and terminology across generated outputs.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FtRFHua2RucJ68z1whbbx%2FScreenshot%202026-11-04%20at%2012.55.36%E2%80%AFPM.png?alt=media&amp;token=9169fac5-2e03-4729-9422-8c235be45a90" alt=""><figcaption></figcaption></figure>

* **Documents:** Use Documents to upload project-related reference files that provide additional context to WalnutAI.
  * WalnutAI reads each uploaded document once and extracts relevant information, including terminology, business rules, screens, and features. This information helps guide AI-generated outputs throughout the project.
  * **Supported File Formats:** PDF, TXT, MD, JSON, DOC, and DOCX (Maximum file size: 10 MB per file).
  * **Examples of documents you can upload:** Business Requirement Documents (BRDs) or Technical Specifications.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FOFAbKmY17vP3cX3DXPfs%2FScreenshot%202026-11-04%20at%2012.56.58%E2%80%AFPM.png?alt=media&amp;token=951739a4-ca14-4254-97c1-ca0da17e787f" alt=""><figcaption></figcaption></figure>

Uploading relevant documents helps WalnutAI understand the project requirements and generate more accurate and context-aware outputs.


# Finalizing the Project Setup

After configuring your data sources and importing the initial assets, review your project configuration to ensure all steps have been completed correctly.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FbpnVX9iuOGGKVwhCfwKR%2Fimage.png?alt=media&amp;token=6ff6a110-0c55-4b8a-bdff-5b2ecc7af518" alt=""><figcaption></figcaption></figure>

* Click **Create Project** to complete the setup. Your workspace will be created and ready for active use.
* **Add Team Members:** Grant project access to collaborators by adding team members. Each user will be able to view, create, and manage assets based on their assigned role.&#x20;

To know how to add team members, refer to the [Creating and Managing Users](/getting-started/user-management/creating-and-managing-users) section.


# Managing Existing Projects

You can manage your workstreams directly from the Projects directory, where each project provides multiple actions to help you organize and maintain your workspace effectively.

* **View & Edit Project:** Access the project to review its essential details, AI configurations, and linked data sources. Make updates or adjust the project settings as needed.
* **Delete Project:** Permanently remove the project and all associated data from the platform. This action cannot be undone.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FZ5SnVwgTjaprjzRvbSTw%2Fimage.png?alt=media&amp;token=e7e24752-edc0-47d0-9167-c3fd49384213" alt=""><figcaption></figcaption></figure>


# Managing your Profile and Assets

The **My Profile** section in WalnutAI is where you manage account settings, testing assets, and administrative tools. Whether you are updating your credentials, organizing reusable test objects, or configuring dynamic variables, everything is centralized in one place for easy access and control.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F6GELjDr3zf2VqeOhlMdn%2FScreenshot%202026-11-04%20at%202.20.49%E2%80%AFPM.png?alt=media&amp;token=439d524c-d15f-4a24-91cc-0ab6a6ba346f" alt=""><figcaption></figcaption></figure>

**Quick Navigation**

Jump to the section you need:

1. [Profile & Security](/getting-started/managing-your-profile-and-assets/profile-and-security)
2. [Object Repository](/getting-started/managing-your-profile-and-assets/object-repository)
3. [Variable Management](/getting-started/managing-your-profile-and-assets/variable-management)
4. [Artifacts](/getting-started/managing-your-profile-and-assets/artifacts)
5. [Recycle Bin](/getting-started/managing-your-profile-and-assets/recycle-bin)
6. [Admin Settings](/getting-started/managing-your-profile-and-assets/admin-settings)
7. [Language](/getting-started/managing-your-profile-and-assets/language)
8. [Logging Out](/getting-started/managing-your-profile-and-assets/logging-out)


# Profile & Security

Your Profile & Security area is designed to keep your account information accurate and your credentials protected. This section is divided into two key areas: Profile Information and Security.

**Understanding Your Profile Data**

Your profile contains essential information that WalnutAI uses to identify you and communicate with your team. Here's what each field represents:

* **Name & Email:** Your primary contact details used for system notifications, team collaboration, and login verification.
* **Account Status**: Shows whether your account is Active (currently in use) or Inactive (not accessed for an extended period).
* **Role:** Your assigned privilege level that determines what you can view and modify in WalnutAI (e.g., Admin, Editor, Viewer).

**Managing Your Password**

To update your password and maintain account security:

* Navigate to the Security tab within My Profile.
* Follow the prompts to create a new password.
* Confirm the change and log in with your updated credentials.

{% hint style="warning" %}
We recommend changing your password every 90 days to maintain optimal security. If you suspect any unauthorized access to your account, reset your password immediately and contact your Admin for assistance.
{% endhint %}


# Object Repository

The Object Repository serves as your centralized library for all UI elements used in your test cases. By storing objects here, you create reusable components that can be referenced across multiple tests, saving time and ensuring consistency when UI changes occur.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fvcs5eDHTtMmiMnN8rz6A%2Fimage.png?alt=media&amp;token=c8eb605c-5115-442d-a7da-0f7fceb8e9ec" alt=""><figcaption></figcaption></figure>

**Creating a New Object**

To add a new UI object to your repository:

* Click Add Object to open the configuration form.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FB8FscWkHXGC52ndAGkIg%2Fimage.png?alt=media&amp;token=71cf3481-c996-4875-86df-ea803a79c53f" alt=""><figcaption></figcaption></figure>

* Fill in the following properties:

  * Object Type: Specifies the element's behavior and how WalnutAI should interact with it (e.g., Web, Text Input, Dropdown, Checkbox).
  * Page Name: Groups related objects by their location in the application, making them easier to find (e.g., Login Screen, Checkout Header, Dashboard Sidebar).
  * Description: Provides helpful context for your team about the object's purpose (e.g., "Submit button on the payment confirmation modal").
  * Attributes: The technical locators WalnutAI uses to identify the element during test execution (e.g., XPath, CSS Selector, ID, Name).

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fjp6T4Vhr3tDsLkBfmB9A%2Fimage.png?alt=media&amp;token=44684909-de1e-4279-b3ce-b4121e54148f" alt=""><figcaption></figcaption></figure>
* Click Create to add the object to your repository.

**Maintaining Your Objects**

Updating Attributes: When a UI element changes in your application (such as a button ID or form field), simply update the Attribute value in the Object Repository. All test cases referencing this object will automatically use the updated locator, eliminating the need to modify each test individually.

**Attribute Preference:** Enable the toggle for an attribute to set it as the default. When the test case is executed, WalnutAI will attempt to locate the element using the default attribute first before trying other available attributes.


# Object Parameterization in WalnutAI

Object Parameterization in WalnutAI allows you to replace hardcoded object values within a test step with dynamic parameters. This makes the same object reusable across different test steps, datasets, and execution scenarios without modifying the underlying test logic.

Instead of defining fixed values such as usernames, email addresses, account numbers, or search terms directly in an object, you can associate the object with a parameter. The parameter can then be assigned the required value, allowing the same object to be used with different values whenever needed.

**Key Benefits of Object Parameterization**

* Scalability: Reuse the same locator across different test cases.
* Flexibility: Handle dynamic elements without modifying test scripts.
* Efficiency: Reduce maintenance efforts when UI changes.
* Data-Driven Testing: Easily integrate with different datasets.

#### **1. Creating a Parameter from the Parameter Section**

You can create a parameter from the Parameter section of a test case and then associate it with the required object.

* Open the required test case.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FT1g0Fje5ZgEwxslli4z6%2FScreenshot%202026-08-19%20at%204.42.08%E2%80%AFPM.png?alt=media&amp;token=504ea1d0-67c7-4d6e-bc33-a0cac3fba221" alt=""><figcaption></figcaption></figure>

* Navigate to the Parameter section.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FV6vsf5NXakoIkRRbD94n%2FScreenshot%202026-08-19%20at%204.42.47%E2%80%AFPM.png?alt=media&amp;token=f43e5b78-ac89-4c59-a94d-5b2bd22a8c1e" alt=""><figcaption></figcaption></figure>

* **Create a new parameter and e**nter the following details:

  * **Parameter Name:** A descriptive name for the parameter, such as `Email`.
  * **Parameter Key:** A unique key used to reference the parameter in a test step, such as `email`.
  * **Description:** A brief description explaining the purpose of the parameter, such as `Email address used for login or user identification`.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fnm4H1dJ41mYCkUTFWvn4%2FScreenshot%202026-08-19%20at%204.51.58%E2%80%AFPM.png?alt=media&amp;token=5324b3d8-d55a-415c-8e02-1c8d04006c24" alt=""><figcaption></figcaption></figure>

* Click **Create Parameter** to create the parameter.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FO5lnxvbt9r9B4bc33YJf%2FScreenshot%202026-08-19%20at%204.52.56%E2%80%AFPM.png?alt=media&amp;token=f6d3029d-1b5f-4e13-9dfd-73ccc9a43850" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The newly created parameter will appear in the **Parameter** section. Based on the parameter type **Local, Global, or Runtime,** its availability and value handling will differ. The parameter will be reflected in the **Test Data** section only after it is used in a test step.
{% endhint %}

#### **2. Parameterizing an Object Directly from a Test Step**

You can also parameterize an object directly while editing a test step.

* Select the required test step.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fk4d7zw2aulj5vdkTDSAN%2FScreenshot%202026-08-19%20at%205.00.13%E2%80%AFPM.png?alt=media&amp;token=ffcd6c2a-5a75-46cc-a798-de95d768a7a7" alt=""><figcaption></figcaption></figure>

* Click the Object icon.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FggOgm7bXCRXMyVNUOFj5%2FScreenshot%202026-08-19%20at%204.56.30%E2%80%AFPM.png?alt=media&amp;token=0f052820-0326-4c3a-b2dc-1b724fbadb92" alt=""><figcaption></figcaption></figure>

* Identify the hardcoded value in the object.

For example, if the object locator contains:

`//input[@placeholder='admin@example.com']`

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FGvpWUxhLbxDKx0FDvEPj%2FScreenshot%202026-08-19%20at%205.01.23%E2%80%AFPM.png?alt=media&amp;token=addb837f-100f-4f7d-9ff7-b46626c8b3e2" alt=""><figcaption></figcaption></figure>

* Replace the hardcoded value with the parameter name you want to create.

Replace the hardcoded value with the parameter:

`//input[@placeholder='${Email}']`

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fo02881xWIurCJsV4aJCV%2FScreenshot%202026-08-19%20at%205.02.13%E2%80%AFPM.png?alt=media&amp;token=cd661a73-82f7-4b09-b003-56a2e1f97512" alt=""><figcaption></figcaption></figure>

* Save the step.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FJwH8Zb5rl3q7z4k05ytU%2FScreenshot%202026-08-19%20at%205.02.44%E2%80%AFPM.png?alt=media&amp;token=e4b04093-74b0-4e4c-849c-1f4577ca8612" alt=""><figcaption></figcaption></figure>

#### **Understanding Local, Global, and Runtime Parameters**

The value requirement depends on the parameter type:

* **Local Parameter:** The parameter is specific to the current test case. A value must be provided for the local parameter within the test case.
* **Global Parameter:** The parameter can be reused across multiple test cases. When creating a global parameter, make sure to provide its value
* **Runtime Parameter:** The parameter can be reused across multiple test cases without providing a value when it is created.&#x20;


# Variable Management

The Variable Management section is your centralized hub to create, view, edit, and manage all variables across your workspace. Variables allow you to store reusable values that can be referenced throughout your workflows, tests, and configurations, ensuring consistency and ease of updates.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FVJ7Qtf9k6bdjLiPOaira%2Fimage.png?alt=media&amp;token=62f537b1-0e51-4dc1-bdc2-ff58b8aafd0a" alt=""><figcaption></figcaption></figure>

**Creating a New Variable**

Follow these steps to define a new reusable value:

* Initiate Creation: Click Create Variable (or Add New Variable).
* Fill in Details:

  * Variable Name: Enter a unique, meaningful name (e.g., userResponse, apiToken).
  * Value: Input the specific data you want to store.
  * Variable type:
    * **Global Variables**
      * Definition: Global variables are static values that are accessible across all test cases within a specific project.
      * Scope: These variables remain constant throughout the project environment unless they are manually updated by a user.
      * Use Case: They are used to ensure consistency and avoid repeated data entry for common data such as environment URLs, person names, phone numbers, or email IDs.
    * **Runtime Variables**
      * Definition: Runtime variables are dynamic values generated or stored automatically during the execution of a test.
      * Scope: These variables are accessible across different test cases within the same execution flow, but their values typically get overwritten every time a test runs.
      * Use Case: They are essential for maintaining continuity in a workflow where one step generates data required for subsequent steps, such as an Order ID, Transaction ID, Session Token, or Reference Number.
    * **Local Parameter**
      * Definition: Local variables are test case-specific data points confined to a single individual test case.
      * Scope: Access is restricted exclusively to the test case in which they are defined; they are not shared with other test cases in the project.
      * Use Case: They are used for temporary or unique data to keep test logic isolated and maintain modularity, ensuring that case-specific values do not interfere with the broader project data.
  * Description: Add a brief explanation of the variable's purpose to help your team.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F6EKE86zMWiZGzHIN4Qxu%2Fimage.png?alt=media&amp;token=bb29aeae-c3ec-405f-bef0-91f842a7f470" alt=""><figcaption></figcaption></figure>
* Add Variable: Click 'Add Variable'. The variable is now ready for use across the platform wherever variables are supported.

**Managing Existing Variables**

To edit a variable, locate it in the list and click **Edit**, update the required details, then click **Save** to apply the changes across all references. To delete a variable, click **Delete** and confirm the action to permanently remove it, as this cannot be undone.

{% hint style="warning" %}
Note: Deleting a variable may impact workflows or tests where it is currently referenced. Always ensure the variable is no longer required before proceeding with deletion.
{% endhint %}


# Artifacts

The **Artifacts** feature enables teams to centrally store and manage files required during test execution. Instead of using local file paths, which are accessible only on the creator's machine, files can be uploaded as artifacts and referenced within test cases using an **Artifact ID**. This ensures that all team members can successfully execute the same test case without modifying file paths.

**Why Use Artifacts?**

* Eliminates dependency on local file paths.
* Makes files accessible to all project members.
* Ensures consistent test execution across different systems.
* Simplifies collaboration by maintaining a centralized repository of files.

**Uploading an Artifact**

* Log in to WalnutAI.
* Click your **Profile (Name)** icon in the top-right corner of the application.
* Select **Artifacts** from the dropdown menu.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FaEBkWtcm6ZHQZ2LsU1NJ%2FScreenshot%202026-07-28%20at%204.05.15%E2%80%AFPM.png?alt=media&amp;token=bb27a6e9-51e3-4b47-9fe8-93e20f9977c5" alt=""><figcaption></figcaption></figure>

* Click **Upload**, then browse and select the required file from your local system.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FAOhIF0UD8X7tAFP6xZxu%2FScreenshot%202026-07-28%20at%204.07.43%E2%80%AFPM.png?alt=media&amp;token=337f61dc-0e8c-4b70-8c8d-6cad6a5aeebc" alt=""><figcaption></figcaption></figure>

* Once uploaded, the file appears in the Artifacts list.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FWE1SF85SBbPFjO7DN2A1%2FScreenshot%202026-07-28%20at%204.10.25%E2%80%AFPM.png?alt=media&amp;token=6aeec776-8241-43f0-bc34-5c0c564e423d" alt=""><figcaption></figcaption></figure>

* Each uploaded file is assigned a unique **Artifact ID**, which is used to reference the file within test cases.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F9Y9jyVcha6pNMi8hOrVd%2FScreenshot%202026-07-28%20at%204.10.48%E2%80%AFPM.png?alt=media&amp;token=7305c371-c71b-4ce0-8980-229d99994c55" alt=""><figcaption></figcaption></figure>

**Using an Artifact in a Test Case**

* Open the required test case.
* Type **/** and select the **Upload** action. The **Upload** action is added to the test step.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FMzKNirmLcD86n5xbPJXO%2FScreenshot%202026-07-28%20at%204.15.12%E2%80%AFPM.png?alt=media&amp;token=ffe708b5-a497-4f47-b5cb-772e0818769d" alt=""><figcaption></figcaption></figure>

* Once the **Upload** action is added, a **file\_path** field is created in the **Test Data** section. Enter the required **Artifact ID** in the **file\_path** field.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FP4NVoIztGhwuRIgHcKMB%2FScreenshot%202026-07-28%20at%204.18.10%E2%80%AFPM.png?alt=media&amp;token=705bf5ab-b08c-4291-b255-76845c5495f9" alt=""><figcaption></figcaption></figure>

* During execution, WalnutAI retrieves the corresponding file from the Artifacts repository and uploads it automatically.

**Uploading an Artifact from Within a Test Case**

* If the required file has not yet been uploaded, you can upload it directly from the test case.
* After adding the **Upload** action, a **file\_path** field is created in the **Test Data** section.&#x20;
* Click the **file\_path** field and select **Upload File Artifact**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F4kFim33dDxorf4zXKLw6%2FScreenshot%202026-07-28%20at%204.22.53%E2%80%AFPM.png?alt=media&amp;token=f583297f-0052-43a2-83c6-402c1d2f21c3" alt=""><figcaption></figcaption></figure>

* Browse and select the required file from your local system.
* Once the upload is complete, the **Artifact ID** is automatically generated and populated in the **file\_path** field.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fl3XEIK4hIFjJB6HHjeDR%2FScreenshot%202026-07-28%20at%204.24.54%E2%80%AFPM.png?alt=media&amp;token=f7cdabf0-4b1a-42ee-8148-d8871f36b96c" alt=""><figcaption></figcaption></figure>

* The uploaded file is added to the **Artifacts** repository and can be reused by all project members in any test case.


# Recycle Bin

The **Recycle Bin** provides a safety net for deleted items by temporarily storing them for **30 days** before they are permanently removed. Instead of being deleted immediately, **test cases** and **action items** are moved to the Recycle Bin, allowing administrators to restore them whenever required within the retention period.

This feature helps prevent accidental data loss and ensures important work can be recovered if deleted unintentionally.

**Key Benefits**

* Prevents accidental loss of test cases and action items.
* Enables quick recovery of deleted work.
* Gives administrators centralized control over data restoration.
* Reduces the risk of permanent data loss through accidental deletion.

#### Accessing and Restoring Deleted Items

* Click your **Profile (Name)** icon in the top-right corner of the application.
* Select **Recycle Bin** from the dropdown menu.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FL49R6cpucJfZn56mc4vR%2FScreenshot%202026-07-28%20at%204.28.18%E2%80%AFPM.png?alt=media&amp;token=092d938d-f73a-4697-99d7-49c5b042addb" alt=""><figcaption></figcaption></figure>

* The Recycle Bin displays all deleted **Test Cases** and **Action Items** that are available for recovery.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Feo228clxafSG95A7J14n%2FScreenshot%202026-07-28%20at%204.30.50%E2%80%AFPM.png?alt=media&amp;token=30a7e45d-8475-4663-a145-22fba11cd55b" alt=""><figcaption></figcaption></figure>

* Locate the deleted item you want to restore.
* Click **Restore**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FJcTS9K0S79rBfMkifkCW%2FScreenshot%202026-07-28%20at%204.33.49%E2%80%AFPM.png?alt=media&amp;token=498b4347-c8fa-4e22-95de-35c18b5d3f88" alt=""><figcaption></figcaption></figure>

* The selected item is restored to its original location and becomes available for use again.

{% hint style="info" %}
**Important:** Although users with the appropriate permissions can delete test cases and action items, **only Project Administrators** can access the Recycle Bin and restore deleted items.
{% endhint %}


# Admin Settings

Admin Settings provides high-level organizational controls and is accessible only to users with Admin privileges. This area allows you to manage the foundational structure of your WalnutAI environment.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fmsh1CdyZeW7zTK2zOl3L%2Fimage.png?alt=media&amp;token=a99786a8-e6c2-4b23-af4d-bc3c9407ffd2" alt=""><figcaption></figcaption></figure>

**What You Can Do in Admin Settings**

With Admin access, you have the authority to perform the following actions:

* Manage Organization Controls: Configure organization-wide settings that affect all users and projects, ensuring consistent policies and governance.
* Define Roles & Permissions: Create custom roles and assign granular permissions that determine what each user can view, create, edit, or delete within the platform.
* Create Projects: Set up new projects and define their associated workflows, ensuring teams have the proper structure to organize their testing activities.
* Configure Action Items: Establish the framework for tracking work, including custom fields, statuses, and priorities for Epics, Features, User Stories, Defects, and Tasks.

{% hint style="info" %}
Admin Settings is your gateway to maintaining a well-organized, secure, and efficient testing environment for your entire organization.
{% endhint %}


# Custom Fields

Custom Fields in WalnutAI allow you to define additional fields for test cases and action items within a project. They help teams capture project-specific information, such as components, regulatory areas, release trains, and other relevant details, beyond the default fields.

Each project maintains its own set of custom fields, which can be configured with different data types, descriptions, and validation settings. You can also choose to display custom fields as columns in the respective list views and make them mandatory when required.

Custom fields are displayed based on the selected tab:

* **Test Cases:** Custom fields created under the Test Cases tab are displayed on the Test Case page under the **Test Case Information** section.
* **Action Items:** Custom fields created under the Action Items tab are displayed on the Action Item page under the **Action Item Information** section.

**The Custom Fields feature allows you to:**

* **Create custom fields:** Define fields based on your project's requirements for test cases or action items.
* **Choose data types:** Configure fields as Text, Long Text, Number, Single Select, Multi Select, Checkbox, Date, or URL.
* **Configure field settings:** Add descriptions, display fields as columns, and mark them as mandatory.
* **Manage existing fields:** Reorder, archive, view archived fields, restore, duplicate, and delete archived fields.

Custom Fields help standardize information across test cases and action items, improve organization, and make it easier to filter and manage records according to project-specific needs.


# Custom Field Configuration

Custom Fields allow you to add project-specific fields to Test Cases or Action Items in WalnutAI. Follow the steps below to create a custom field and configure its properties according to your requirements.

#### Steps to Create a Custom Field

* Go to **Admin Settings** and select **Custom Fields**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FgGyZrzElQKpdBjaCJhbO%2FScreenshot%202026-10-21%20at%205.53.15%E2%80%AFPM.png?alt=media&amp;token=98083d89-281d-47ea-8ec2-e40181833453" alt=""><figcaption></figcaption></figure>

* From the **Project** dropdown, select the project for which you want to create a custom field.&#x20;

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fz2WLICuptKMewf3lV4it%2FScreenshot%202026-11-02%20at%2011.35.29%E2%80%AFAM.png?alt=media&amp;token=6e9d03c1-64b2-4f87-80ca-3cd82713b675" alt=""><figcaption></figcaption></figure>

* Select the appropriate tab based on where you want to add custom fields:
  * **Test Cases:** Select this tab to create custom fields for the Test Case page.
  * **Action Items:** Select this tab to create custom fields for the Action Item page.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FYZnBcEYhRz4CY1bgLMoh%2FScreenshot%202026-10-28%20at%205.44.31%E2%80%AFPM.png?alt=media&amp;token=15f06e8f-4692-4517-99f2-4e7311344097" alt=""><figcaption></figcaption></figure>

* Click **Add field** in the top-right corner. If no custom fields exist, click **Add your first field**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FJxpVL3ZKVx4VU1MLhJXL%2FScreenshot%202026-11-02%20at%2011.36.51%E2%80%AFAM.png?alt=media&amp;token=3330137e-fe73-4f78-b94f-1d11e0caf50c" alt=""><figcaption></figcaption></figure>

* **Enter the Field Name:** Enter a name for the custom field, such as *Component*, *Priority*, or *Release Train*. This is a required field.&#x20;
* **Add a Description:** Enter an optional description explaining the purpose of the field. This description appears as a tooltip next to the field on the corresponding Test Case or Action Item page.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FJdRJMKTEov1wJ4tVYyok%2FScreenshot%202026-10-21%20at%206.33.39%E2%80%AFPM.png?alt=media&amp;token=52ff1f34-f8a9-498b-baa8-b25424ed7fad" alt=""><figcaption></figcaption></figure>

* **Select a Data Type:** Choose the appropriate data type based on the information you want to capture.

| Data Type         | Description                                                       | Example                                       |
| ----------------- | ----------------------------------------------------------------- | --------------------------------------------- |
| **Text**          | Accepts single-line text with a maximum of 500 characters.        | Login Module                                  |
| **Long text**     | Accepts multi-line text for detailed notes or descriptions.       | Additional test execution notes               |
| **Number**        | Accepts integer or decimal values.                                | 2 or 3.5                                      |
| **Single select** | Allows testers to select one option from a predefined list.       | High, Medium, or Low                          |
| **Multi select**  | Allows testers to select multiple options from a predefined list. | Web and API                                   |
| **Checkbox**      | Represents a Yes/No or checked/unchecked value.                   | Regression Required                           |
| **Date**          | Allows testers to select a calendar date.                         | 21 October 2026                               |
| **URL**           | Stores a clickable link.                                          | A link to a requirement or reference document |

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F8EDimNay7ht5r6vshT6V%2FScreenshot%202026-10-21%20at%206.36.22%E2%80%AFPM.png?alt=media&amp;token=f922a1d7-24ea-4484-b250-be74f8126722" alt=""><figcaption></figcaption></figure>

* **Configure Field Settings:** Configure the following options according to your requirements:
  * **Show as a column in the list:** Enable this option to display the custom field as a column in the respective list (Test Cases or Action Items), based on the selected tab.
  * **Mandatory:** Enable this option if every record in the selected module (Test Cases or Action Items) must have a value for the field.
* **Create the Field:** Click Create field to save the configuration. The custom field will then be available for the selected module (Test Cases or Action Items) within the project.

{% hint style="info" %}
Custom fields created for a project will be displayed on the respective page under the Test Case Information or Action Item Information section, based on the selected module.
{% endhint %}

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FnlfjqV6xSDJU7QZImGCb%2FScreenshot%202026-10-21%20at%206.36.51%E2%80%AFPM.png?alt=media&amp;token=730fde7e-58ad-4da8-86d5-650394b0b7d7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** The data type cannot be changed after the field is saved. To use a different data type, create a new field and archive the existing one.
{% endhint %}


# Managing Custom Fields

WalnutAI allows you to manage custom fields to keep information organised according to your project requirements. You can edit existing fields, duplicate them to create similar fields, archive fields that are no longer needed, and restore or delete archived fields.

#### Managing Active Custom Fields

Navigate to **Admin Settings** → **Custom Fields** and select the required project from the **Project** dropdown. The active custom fields for the selected project are displayed on the page.

You can manage custom fields using the following options:

* **Edit fields:** Update the field name, description, and available settings.
* **Duplicate fields:** Create a new custom field using an existing field's configuration.
* **Archive fields:** Hide fields that are no longer required while retaining their existing values.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FJ8aWo7AHDgv5o1rcBdaD%2FScreenshot%202026-11-02%20at%2011.29.14%E2%80%AFAM.png?alt=media&amp;token=90987d89-407e-4448-89e9-c5cbec84527e" alt=""><figcaption></figcaption></figure>

* **Show archived fields:** Enable the **Show archived** toggle to view and manage archived fields.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FH1drfnS45znSDDD0t8do%2FScreenshot%202026-11-02%20at%2011.30.46%E2%80%AFAM.png?alt=media&amp;token=c8b9bc48-3188-4471-8d43-c4c656668eca" alt=""><figcaption></figcaption></figure>

* **Restore fields:** Restore an archived field to make it active again.
* **Delete fields:** Permanently delete archived fields that are no longer needed.
* **Reorder fields:** Drag and drop rows to change the order in which fields appear on the respective Test Case or Action Item page.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FC1YRzDXgGLt19rlBdg29%2FScreenshot%202026-11-02%20at%2011.32.38%E2%80%AFAM.png?alt=media&amp;token=e2517e83-862b-4542-94d7-57b07d6c5c87" alt=""><figcaption></figcaption></figure>

* The Custom Fields page also displays the number of active and archived fields, along with the maximum field limit for the project.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fpt9N3uX5TRu8Kou3OKmu%2FScreenshot%202026-11-02%20at%2011.33.21%E2%80%AFAM.png?alt=media&amp;token=fde3cca6-38f4-400a-9a7d-6855195c741e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** The field key and data type cannot be changed after a field is created. Only archived fields can be deleted.
{% endhint %}


# Language

WalnutAI allows users to change the application interface language based on their preferences. This helps users navigate and interact with the platform more comfortably. The language setting is available under the User Profile menu and can be changed at any time.

Follow the steps below to change the application language:

* Log in to your WalnutAI account.
* Click the User Profile menu in the top-right corner of the application.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fq0PzyQcb51bqClA8tkVi%2FScreenshot%202026-11-04%20at%202.11.42%E2%80%AFPM.png?alt=media&amp;token=822b4c05-962d-4fd6-b0bc-fdd807dbe725" alt=""><figcaption></figcaption></figure>

* Select Language from the menu. A list of supported languages will be displayed.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fz2o3Z8o9fD4dexxq0Xe9%2FScreenshot%202026-11-04%20at%202.10.48%E2%80%AFPM.png?alt=media&amp;token=28718195-afa2-4681-839e-a6c612a1c46f" alt=""><figcaption></figcaption></figure>

* Choose your preferred language from the available options. The selected language will be marked with a dot, indicating the currently active language.
* Available Languages: WalnutAI currently supports English, Bahasa Indonesia, Bahasa Melayu, and Español.
* The available languages are organised into two regional categories: Asia Pacific (Bahasa Indonesia and Bahasa Melayu) and Europe (Español).

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FADyzKtCQEFeNR9iITvXZ%2FScreenshot%202026-11-04%20at%202.12.49%E2%80%AFPM.png?alt=media&amp;token=991f462d-24d7-4d55-b574-7695f3414d5c" alt=""><figcaption></figcaption></figure>

* Once selected, the application interface will be displayed in the chosen language, allowing you to navigate and interact with WalnutAI in your preferred language.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fp1zMrpnvkpRveduG2Bfi%2FScreenshot%202026-11-04%20at%202.13.39%E2%80%AFPM.png?alt=media&amp;token=e1c38d79-1949-4280-9ee6-0aee0a9f8e0e" alt=""><figcaption></figcaption></figure>


# Logging Out

When you've finished your session, it's important to log out securely to protect your account and organizational data.

**To log out:**

* Click on your user menu (typically located in the top-right corner).
* Select Log Out from the dropdown options.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FyTBc7nzfGqNYaH9yiZet%2Fimage.png?alt=media&amp;token=0fe7f6ad-d7f4-4272-bd23-39bb3456e825" alt=""><figcaption></figcaption></figure>

You'll be safely signed out and returned to the login screen. Your work is automatically saved, so you can pick up exactly where you left off when you return.


# User Management

The User Management section provides control over user accounts, roles, and permissions, allowing you to manage team members and define their access levels within the organization. This centralized directory ensures that the right people have the right access to the right projects.

To access the User Management module, navigate to Admin Settings from the main menu and locate the User Management option. Click Configure to open the directory where all active users and defined roles are listed for easy management and review.

Quick Navigation

Jump to the section you need:

1. [Creating and Managing Users](/getting-started/user-management/creating-and-managing-users)
2. [Managing Roles and Permissions](/getting-started/user-management/roles-and-permissions)


# Creating and Managing Users

The User Creation process is designed to get your team started quickly while ensuring they only have access to the projects relevant to their work. This controlled approach maintains security while enabling efficient collaboration.

**Adding a New User**

Follow these steps to create a new user account:

* Click **Add User**, then enter the required user details.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FJlFmRzM7eBDWvFb4t6Lv%2Fimage.png?alt=media&amp;token=ed5b7cad-f14a-4d36-9bbe-bdcab234246b" alt=""><figcaption></figcaption></figure>

* Fill in the following fields:
  * Full Name: The user's legal name for identification and display throughout the platform.
    * Email & Username: Primary credentials used for system notifications, login authentication, and team communication.
    * Role: The assigned privilege level (e.g., Admin, Editor, Viewer) that determines their capabilities and access rights within WalnutAI.
    * Project Access: Specific project environments the user is authorized to view, edit, or manage.
* **Assign a Role:** Choose the appropriate permission template from the dropdown menu. Select a role that matches the user's responsibilities within your organization.
* **Grant Project Access:** Select the specific projects the user should be able to view or edit. Users will only see projects they've been granted access to, keeping their workspace focused and organized.
* **Finalize Account Creation:** Click Create User to complete the process. An automated email will be sent to the user's email address, providing instructions to securely set up their account credentials.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fm1JbQPrOZHar2R2rJZih%2Fimage.png?alt=media&amp;token=412aac97-bf6e-466d-a67c-c8112739b501" alt=""><figcaption></figcaption></figure>

**Managing Existing Users**

**User Directory:** All existing users are listed in the User Directory section, providing a complete view of your organization's accounts. You can search, filter, and review user details from this centralized location.

**Updating User Profiles:** To modify user details, select an existing user from the directory list. You can edit their role assignment, contact information, or project access levels. Click Save to apply changes instantly. Updated permissions take effect immediately, ensuring users always have appropriate access.


# Roles and Permissions

Roles act as standardized templates, allowing you to manage access for groups of users simultaneously rather than configuring permissions individually. This approach ensures consistency and simplifies administration as your team grows.

**Why Use Roles?**

Defining roles (such as "Admin", "Manager", or "Viewer") ensures consistency across your organization and makes it simple to revoke or grant high-level access as your team scales. When you update a role's permissions, all users assigned to that role automatically inherit the changes, eliminating the need to update each user individually.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FUTtLt5maoZB3t5Fdoc3x%2Fimage.png?alt=media&amp;token=eb165d14-8936-4231-8725-ca521e320895" alt=""><figcaption></figcaption></figure>

**Creating a New Role**

To define a new role, click Add Role under the Role Management tab and configure the following properties:

* Role Name: A unique, descriptive label identifying the job function or responsibility level (e.g., "Lead Automation Engineer," "Test Manager," "Read-Only Analyst").
* Description: A clear summary providing context for other administrators regarding the role's purpose, typical users, and intended use cases.
* Permissions: Granular checkboxes used to toggle specific access levels (View, Create, Edit, or Delete) for system assets such as test cases, requirements, defects, and projects.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FkX9kh15wdwSsAa2hTUoa%2Fimage.png?alt=media&amp;token=7ba66aba-56ab-4a15-84b4-efb30a622552" alt=""><figcaption></figcaption></figure>

**Managing Role Permissions**

Role Listing: All created roles and their associated permissions are displayed in the Roles section for easy review. You can quickly see which roles exist in your organization and what capabilities each role provides.

Modifying Permissions: To update a role's capabilities, navigate to Permissions, select the role you want to modify, and adjust the permissions by checking or unchecking the relevant access level boxes. Click Save to apply your changes. All users assigned to the updated role will immediately receive the new permission set.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FfuHPU9OsyCbCvgXdpZgb%2Fimage.png?alt=media&amp;token=d8421a24-e80b-45ed-95c9-d916de01545f" alt=""><figcaption></figcaption></figure>


# Action Item

Action Items are trackable units of work created to ensure that project tasks, requirements, and issues are properly addressed and completed. They represent actionable work that requires clear ownership, focused attention, and consistent follow-through.

In WalnutAI, Action Items act as a central hub for tracking and managing all project deliverables, including Epics, Features, User Stories, Defects, and Tasks. This unified system ensures every requirement is documented, assigned, and monitored through to completion.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FQKUVipzp4ukIkdyRvZJU%2Fimage.png?alt=media&amp;token=26d6c91a-de29-4318-ae7d-abc83d44718d" alt=""><figcaption></figcaption></figure>

**Types of Action Items**

WalnutAI provides a unified system for managing several distinct work types:

* **Epic:** A large body of work representing major business objectives or high-level initiatives that can be broken down into smaller deliverables like Features or User Stories.
* **Feature:** A functional component or capability that delivers specific business value, usually derived from an Epic and divided into multiple User Stories.
* **User Story:** A requirement written from the end user's perspective defining specific functionality (e.g., “As a \[user], I want \[functionality], so that \[benefit]”).
* **Task:** Technical or operational activities required to complete a User Story, Feature, or Defect, usually assigned to team members for completion within a single sprint.
* **Defect:** A bug or issue where the system deviates from defined requirements; these are logged, prioritized, and tracked until resolved.


# Creating Action Items

The Action Items hub allows you to define the hierarchy of your project. Whether you are setting a high-level Epic or a specific technical Task, the process is streamlined to ensure all mandatory data is captured.

**Creating Different Item Types**

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F4bnfLHsd2EB035U5bXSr%2Fimage.png?alt=media&amp;token=b3bad726-37ab-41ca-8bc6-feb189f1bf01" alt=""><figcaption></figcaption></figure>

* Click **'Add Item'** and select the specific item type from the dropdown menu (Epic, Feature, User Story, Defect, or Task).

{% hint style="info" %}
You can also import or create Epics, Features, or User Stories directly from the [Intelligence Hub.](/core-features/intelligence-hub/generate-user-stories)
{% endhint %}

* Fill in all required fields in the pop-up form:

  * **Title & Type:** Enter a clear, descriptive name and confirm the correct classification to ensure proper organization within the project hierarchy.
  * **Status & Priority:** Select the current progress stage (To Do, In Progress, Done) and define the urgency level (High, Medium, Low) to support workflow tracking and sprint prioritization.
  * **Assignee:** Choose the specific team member responsible for completing the item, ensuring clear ownership and accountability.
  * **Story Points:** Provide the effort estimation to support sprint planning and capacity management.
  * **Description:** Add detailed information explaining the objective, scope, or issue for complete clarity.
  * **Acceptance Criteria:** For User Stories define the specific conditions that must be met for the story to be considered complete.
  * **Test Case:** For defects link the associated test case from which the defect was identified to maintain validation traceability.
  * **Attachments:** Upload supporting documents, screenshots, or design files for full context.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F5vjFRfpaCpjGTQaEfOE4%2Fimage.png?alt=media&amp;token=169a7462-2b0d-46a3-9c93-e57e5995a2f8" alt=""><figcaption></figcaption></figure>
* Click **'Save'** to create the action item.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FjYnpUG9nTGrlKjQseBWg%2Fimage.png?alt=media&amp;token=5374d3f1-0a81-4983-b24b-3647dd8b5d9f" alt=""><figcaption></figcaption></figure>

Once saved, the Action Item will appear in the directory. If a **Task or Defect** is assigned to a team member, it will automatically reflect on their [Workboard](/overview-and-tracking/workboard), providing real-time visibility into workload and progress tracking.


# Managing Your Action Items

You can manage your Action Items directly from the directory view to streamline your workflow. This centralized hub allows for quick updates and structural organization without navigating away from the main list.

**Direct Directory Management**

Use the dropdown options within the directory view to update key fields instantly:

* **Attributes:** Update the Status, Priority, Assignee, and other attributes without opening the individual item.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FXXhusYiT7GTrefac9d3u%2Fimage.png?alt=media&amp;token=2ae558e7-965b-4c80-a613-9c7672477c59" alt=""><figcaption></figcaption></figure>

* **Edit:** Click Edit to make detailed changes to the Action Item’s content or metadata.
* **Delete:** Click Delete to permanently remove the Action Item from the project.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fl9n2qJFmL9Py5daN5pWU%2Fimage.png?alt=media&amp;token=3d514532-ac1e-45a1-ad19-23c25193b1d2" alt=""><figcaption></figcaption></figure>

**Organizing with Folders**

To improve structure and clarity, you can group related Action Items into folders. This is particularly useful for organizing work based on specific releases, modules, sprints, or any custom workflow structure.

**Steps to Create a New Folder:**

* Click Add Folder within the Action Items module.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F5VjpwewSHSK5ry7UTejY%2Fimage.png?alt=media&amp;token=06f77f1e-b7d0-4c70-a762-d5d26a61f8c5" alt=""><figcaption></figcaption></figure>

* Enter a Title and Description that clearly identifies the folder's purpose.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FJIwGVmUTQgNMLq1MxdZR%2Fimage.png?alt=media&amp;token=98e8f5bf-7c42-403c-b921-71966113db78" alt=""><figcaption></figcaption></figure>

* Drag and drop the associated Action Items (such as specific User Stories or Features) to the folder.

**Quality Insights & Traceability Overview**

* **Quality & Tracking:** Provides teams with a real-time health check of the User Story. By viewing the quality score, test case pass/fail status, and linked defects in one place, stakeholders can instantly understand implementation readiness, risk areas, and validation progress. This eliminates guesswork and ensures no failed validations are overlooked before release.
* **Metadata:** Automatically capturing details like Created By, Last Updated By, and Last Updated Date ensures full traceability. It promotes accountability and provides clear visibility into who made changes and when, which is especially valuable during audits, reviews, or when investigating requirement shifts.
* **Attachments:** Keeping requirement documents, designs, screenshots, and supporting files directly within the User Story ensures complete context in a single place. This reduces dependency on external tools, prevents information loss, and enables teams to quickly reference everything they need without searching across multiple platforms.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FQQ9k4ME6dgGtP6jUp4X6%2Fimage.png?alt=media&amp;token=f5a45c40-4467-43db-82f2-d221334ed0ae" alt=""><figcaption></figcaption></figure>


# AI-Driven Requirement Enhancement & Test Generation

**Using AI to Enhance the Story**

The Chat with AI option is useful for identifying and filling gaps within your User Story. Whether you missed a specific step, overlooked an edge case, or feel the acceptance criteria are incomplete, you can use the chat to refine and strengthen the requirement before it moves to development.

**You can use it to:**

* **Improve Clarity:** It rewrites unclear or ambiguous descriptions into precise, implementation-ready statements that are easy for developers to follow.
* **Enhance Criteria:** It defines acceptance criteria to make them specific, measurable, and testable.
* **Add Edge Cases:** It identifies missing scenarios, validations, and boundary conditions that may have been overlooked during initial planning.
* **Suggest Points:** It evaluates the scope and complexity of the requirements to recommend appropriate story points for better sprint estimation.

When the AI suggests enhancements, click **Apply Changes** to automatically update the story with the refined version. It replaces existing content with the AI-enhanced updates, ensuring changes are saved and immediately reflected in the User Story.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F5zeKX9NTpyU4JT5TLYcp%2Fimage.png?alt=media&amp;token=45b0548e-1f0a-49ab-bc94-589ab1789c79" alt=""><figcaption></figcaption></figure>

**Generating Test Cases**

You can bridge the gap between requirements and validation by leveraging automated test generation.

* **Initiate Generation:** Click **AI Generate** within the User Story interface.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FeDm1Mq1fHjgWmGtiGP57%2Fimage.png?alt=media&amp;token=6fb62bd1-1291-4f2a-8285-d4af74ec67d2" alt=""><figcaption></figcaption></figure>

* **Automated Creation:** The system automatically creates both positive and negative test cases based on the provided story details and criteria.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F5w4FBG4PqZHPTFNNLAEC%2Fimage.png?alt=media&amp;token=57a1656e-ab5e-42f7-a5bf-9ed4a872c1cc" alt=""><figcaption></figcaption></figure>

* **Review and Refinement:** Review the generated test cases for accuracy, then click **Confirm** & **Save** to finalize them.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F72H9qOcuKEAsZiGO7a6Z%2Fimage.png?alt=media&amp;token=617d1ac6-3e17-4869-95f8-dcaad59f01be" alt=""><figcaption></figcaption></figure>

* On saving, the test cases are linked to the User Story.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FRXA3lbQNnObQYEaxobOz%2Fimage.png?alt=media&amp;token=b5416b77-a3f5-4603-a8c9-53d118c63a12" alt=""><figcaption></figcaption></figure>


# Synchronizing Requirements with Jira

Jira Sync enables seamless synchronization of requirements between WalnutAI and Jira, ensuring both platforms remain up to date without manual effort. You can configure one-way or two-way synchronization based on your workflow, allowing requirements to be pulled from Jira, pushed from WalnutAI, or synchronized bidirectionally in real time. This helps maintain consistency, improves collaboration between business, development, and QA teams, and eliminates duplicate work.

**Steps for Jira Synchronization**

* Navigate to **Admin Settings**&#x20;

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FVWReeyd2GWmOhJHIKlKd%2FScreenshot%202026-07-30%20at%201.43.39%E2%80%AFPM.png?alt=media&amp;token=b9882917-b2bd-454d-96b8-24b4c825540a" alt=""><figcaption></figcaption></figure>

* Select the '**Jira Sync Configuration'** option.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FkoTKzBSuMUqaYYYMjPt8%2FScreenshot%202026-07-30%20at%201.46.05%E2%80%AFPM.png?alt=media&amp;token=eafa471c-0d50-4f1c-b1b6-c187638c3459" alt=""><figcaption></figcaption></figure>

* Select the **WalnutAI project** that is connected to Jira.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FMjGDxIZab6XxoObVlZ4I%2FScreenshot%202026-07-30%20at%201.47.38%E2%80%AFPM.png?alt=media&amp;token=b7552e50-0fc7-4258-967f-43589970574b" alt=""><figcaption></figcaption></figure>

* Choose the required sync direction:
  * **WalnutAI → Jira**: Enable **Push changes to Jira** to sync requirements from WalnutAI to Jira.
  * **Jira → WalnutAI**: Enable **Pull changes from Jira** to import requirements from Jira into WalnutAI.
  * **Bidirectional Sync**: Enable both toggles to keep requirements synchronized between Jira and WalnutAI.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FVbKlHoj6SO7nTiT44XZR%2FScreenshot%202026-07-30%20at%201.50.47%E2%80%AFPM.png?alt=media&amp;token=7af65271-d9e2-42f5-a791-39e625cef1a3" alt=""><figcaption></figcaption></figure>

* Click **Sync**, then select **Start Sync** to begin the synchronization.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FBKvL1PU5skC4TSpl7Q3B%2FScreenshot%202026-07-30%20at%201.52.11%E2%80%AFPM.png?alt=media&amp;token=ada410a3-8556-4f5e-a7d4-9b8d7c58df11" alt=""><figcaption></figcaption></figure>

* Monitor the real-time sync progress using the **Pulled from Jira** and **Pushed to Jira** progress indicators.
* Once the sync is complete, review the synchronization summary showing the total number of items pulled and pushed.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FUG9O5lqJqH0rAHph2AYb%2FScreenshot%202026-07-30%20at%201.57.12%E2%80%AFPM.png?alt=media&amp;token=c3b2b253-af08-4f13-b8e2-6d8458f5d69c" alt=""><figcaption></figcaption></figure>

* Navigate to **Action Items** in WalnutAI to view the synchronized requirements. The same requirements will also be available in Jira.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FGwHX7GZxUJ7O9qaBZdOB%2FScreenshot%202026-07-30%20at%201.58.10%E2%80%AFPM.png?alt=media&amp;token=3d4df408-57e5-479a-817b-df03dbc8ca6a" alt=""><figcaption></figcaption></figure>

* With **Live Sync** enabled, any new or updated requirements created in either WalnutAI or Jira will automatically synchronize with the other platform.
* To disable Live Sync, return to **Admin Settings** and turn off the required sync toggle.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FsjtglWIFj07GbIgwo21V%2FScreenshot%202026-07-30%20at%201.59.06%E2%80%AFPM.png?alt=media&amp;token=d8f37c8e-fed3-440b-9164-928bf8ce905e" alt=""><figcaption></figcaption></figure>

**Delete Behaviour**

WalnutAI provides three options for handling deleted requirements during synchronization:

* **Unlink** – Removes the association between WalnutAI and Jira without deleting the Jira issue.
* **Transition to Done/Closed** – Marks the linked Jira issue as **Done** or **Closed** instead of deleting it.
* **Delete Jira Issue** – Permanently deletes the linked Jira issue when the requirement is deleted from WalnutAI.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FoPjV9R2u1s4BXZSo8MQo%2FScreenshot%202026-07-30%20at%202.00.14%E2%80%AFPM.png?alt=media&amp;token=bab268b2-656b-4126-9a4e-56baf198421b" alt=""><figcaption></figcaption></figure>

Choose the delete behavior that best matches your team's workflow before enabling synchronization.


# Synchronizing Requirements with Azure DevOps

Azure DevOps Synchronization enables seamless synchronization of requirements between WalnutAI and Azure DevOps, ensuring both platforms remain up to date without manual effort. You can configure one-way or two-way synchronization based on your workflow, allowing work items to be pulled from Azure DevOps, pushed from WalnutAI, or synchronized bidirectionally in real time. This helps maintain consistency, improves collaboration between business, development, and QA teams, and eliminates duplicate work.

**Steps for Azure DevOps Synchronization**

* Navigate to **Admin Settings.**

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FmisJj97JiSeClzRBZw7V%2FScreenshot%202026-07-30%20at%203.27.57%E2%80%AFPM.png?alt=media&amp;token=afd75f05-7509-4b43-82c6-00c0eef016d5" alt=""><figcaption></figcaption></figure>

* Select the '**Azure** **Sync Configuration'** option.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FnxkMRFjmk8qYzgJtCFct%2FScreenshot%202026-07-30%20at%203.29.06%E2%80%AFPM.png?alt=media&amp;token=4211d70e-8abd-4d67-83da-5cd39e8a52ab" alt=""><figcaption></figcaption></figure>

* Select the **WalnutAI project** that is connected to Azure DevOps.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FkVPIKmIEZmD6Ig2SdAt2%2FScreenshot%202026-07-30%20at%203.30.11%E2%80%AFPM.png?alt=media&amp;token=805e8a8b-b8be-4d46-8c47-284026ccf7d7" alt=""><figcaption></figcaption></figure>

* Configure the required sync direction:
  * **WalnutAI → Azure DevOps** – Push requirements from WalnutAI to Azure DevOps.
  * **Azure DevOps → WalnutAI** – Pull work items from Azure DevOps into WalnutAI.
  * **Bidirectional Sync** – Enable both options to synchronize changes in both directions.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FEHOIcWVITiMnN1kNRy0H%2FScreenshot%202026-07-30%20at%203.37.14%E2%80%AFPM.png?alt=media&amp;token=054b705e-0f32-472e-ba7b-dfed33ad1845" alt=""><figcaption></figcaption></figure>

* Click **Sync**, then select **Start Sync** to begin the initial synchronization.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FB4s9lSySENauX7uq6zyS%2FScreenshot%202026-07-30%20at%203.41.58%E2%80%AFPM.png?alt=media&amp;token=ce22e19e-a0c0-421f-9d9c-a79c00d901d0" alt=""><figcaption></figcaption></figure>

* Monitor the real-time synchronization progress until the sync is complete.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FaDwigf3zzyJXDI9wkjTA%2FScreenshot%202026-07-30%20at%203.39.52%E2%80%AFPM.png?alt=media&amp;token=60c237fb-9055-42b7-82ef-c11c479d59e0" alt=""><figcaption></figcaption></figure>

* Navigate to **Action Items** in WalnutAI to view the synchronized requirements. The same requirements will also be available in Azure DevOps.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FOTWaJe4a2tDikN1QYxbV%2FScreenshot%202026-07-30%20at%204.17.02%E2%80%AFPM.png?alt=media&amp;token=74ad6b2c-1a9c-4d99-83a2-5c9f8c55554f" alt=""><figcaption></figcaption></figure>

* Keep **Live Sync** enabled to automatically synchronize new and updated requirements between WalnutAI and Azure DevOps.
* To stop automatic synchronization, navigate back to **Azure DevOps Sync Configuration** and disable the **Live Sync** toggle.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FML5jw0ncW71MNyXD31hW%2FScreenshot%202026-07-30%20at%204.19.45%E2%80%AFPM.png?alt=media&amp;token=fae2798d-294d-4fc0-9ae4-c7d822d990a5" alt=""><figcaption></figcaption></figure>

**Delete Behavior**

WalnutAI provides three options for handling deleted requirements during synchronization:

* **Unlink** – Removes the synchronization link without deleting the corresponding Azure DevOps work item.
* **Transition to Done/Closed** – Marks the linked Azure DevOps work item as **Done** or **Closed** instead of deleting it.
* **Delete Azure DevOps Work Item** – Permanently deletes the linked Azure DevOps work item when the requirement is deleted from WalnutAI.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F76Ed2XPus20tSuSI67Uk%2FScreenshot%202026-07-30%20at%204.21.53%E2%80%AFPM.png?alt=media&amp;token=22a07a76-2075-46c4-86b1-0225f98db24b" alt=""><figcaption></figcaption></figure>

Choose the delete behavior that best aligns with your team's workflow before enabling synchronization.


# Dashboard

The Dashboard is the primary screen you see immediately after logging into WalnutAI. It acts as a high-level snapshot of your work, projects, and recent activity, allowing you to grasp the current state of your entire workspace at a single glance.

#### What’s on the Dashboard?

The Dashboard is organized into four key areas designed to provide maximum context with minimum navigation:

* **Key Metrics Cards:** Instant summary cards that display critical data points:
  * **Total Projects:** The number of active workspaces you can access.
  * **User Stories:** A count of requirements within your selected project.
  * **Team Members:** The total number of collaborators assigned.
  * **My Action Items:** A dedicated count of tasks specifically assigned to you.
* **Active Projects Section:** A list of your current workstreams. Each card shows the project name, its status (e.g., Active or Configuring Uploads), and the scale of the project in terms of stories and members.
* **Organization Panel:** Provides your professional profile context, including the Organization Name, your Access Level (e.g., Admin or Member), and your registered email identity.
* **Recent Activity Feed:** A live stream of modifications across your projects, including configuration changes, AI model updates, and edits made by your collaborators.

#### Why the Dashboard is Useful

The Dashboard is designed to streamline your workflow by focusing on four core benefits:

* **Centralized Visibility:** It consolidates information from multiple modules into one screen, so you don't have to hunt for data.
* **Operational Efficiency:** It saves significant time by reducing manual navigation through menus to find project statuses.
* **Smart Prioritization:** By highlighting "My Action Items" and the "Recent Activity" feed, it helps you immediately identify what requires your attention first.
* **Team Transparency:** It improves alignment by showing real-time updates and team modifications, ensuring everyone stays informed of the latest project shifts.


# Workboard

The Workboard in WalnutAI acts as your personal task management dashboard, like a to-do list. It provides a consolidated view of all items assigned to you across multiple modules, helping you stay organized and focused on your priorities.

Assigned items displayed on your Workboard may include Tasks, User Stories, Defects, and Execution Plans. The Workboard enables you to efficiently track and manage your responsibilities within the selected project, ensuring nothing falls through the cracks.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FQXu3spglDm9bthzEIZ4E%2Fimage.png?alt=media&amp;token=e74e981c-d3b0-4650-bb5e-513aff04b0cb" alt=""><figcaption></figcaption></figure>

**Key Features**

**View Assigned Items**

Your Workboard displays all work items assigned to you, organized by item type (Task, User Story, Defect, Execution Plan, etc.). Each item card shows key details at a glance, including:

* **Title:** The name of the work item
* **Status:** Current progress (such as To Do, In Progress, or Done)
* **Due Date:** Deadline for completion (if applicable)
* **Priority:** Urgency level of the item

This quick-reference view helps you understand your workload and identify urgent items without opening each task individually.

**Status Updates**

You can update the status of work items directly from the Workboard without navigating away to detailed views. Status changes can be made easily using drag-and-drop functionality, allowing quick updates and smooth progress tracking. Simply drag an item card to a different status column to update its current state, and the change is reflected immediately across the platform.

**AI-Powered Insights**&#x20;

Based on your workboard, WalnutAI provides a real-time overview of task progress and priority distribution across all items. It summarizes key metrics such as overall completion rate, the number of high-priority items requiring attention, and the current status of ongoing work. This section helps users quickly assess whether tasks are on track, identify any critical gaps or delays, and understand where focus is needed.

**How to Use Workboard**

Navigate to Workboard from the left-hand panel in the main navigation. By default, all items assigned to you are displayed, giving you a complete view of your current responsibilities.

Track progress or update item status directly by clicking on any item card to view details or by dragging cards between status columns to reflect progress. Use the Workboard daily as part of your workflow to stay informed about pending tasks, upcoming deadlines, and shifting priorities.

**Benefits of Using Workboard**

The Workboard provides a centralized view of all assigned work, eliminating the need to search across multiple modules or screens to find your tasks. This consolidation improves personal productivity by reducing context-switching and keeping your focus on execution.

You gain real-time visibility into work status, allowing you to quickly assess what's complete, what's in progress, and what's waiting to start. The Workboard also provides quick access to item details and updates, enabling you to respond rapidly to changing priorities or team requests without losing momentum.


# Intelligence Hub

The **Intelligence Hub** serves as the central workspace of the WalnutAI platform, enabling you to generate structured user stories and test cases from multiple input sources. Whether you're working with requirement documents, design files, code repositories, automation frameworks, multimedia content, or live application workflows, the Intelligence Hub leverages AI to transform them into actionable project artifacts while maintaining traceability across the software development lifecycle.

From this module, you can perform the following key activities:

* **Document-Driven Generation:** Upload requirement documents such as BRDs, FRDs, SRS, or spreadsheets to automatically generate structured user stories and comprehensive test cases.
* **Multimedia Requirement Extraction:** Import audio or video recordings of client meetings, product demos, or requirement discussions to extract functional requirements and generate corresponding user stories and test cases.
* **Design-Based Generation:** Connect Figma projects to analyze design frames and generate user stories and test cases directly from UI/UX designs.
* **Code Repository Analysis:** Integrate GitHub, GitLab, or Bitbucket repositories to derive functional requirements and generate user stories and test cases based on the application's source code.
* **Automation Framework Import:** Import existing Playwright automation projects from Git repositories, ZIP archives, or script files to generate documentation and test artifacts from automation assets.
* **Live Workflow Recording:** Capture real-time user interactions through Smart Recording and automatically convert recorded application workflows into structured and executable test cases.


# Generate User Stories

The **User Stories** tab within the Intelligence Hub enables you to generate structured **Epics, Features, and User Stories** from multiple input sources through a unified workflow. Whether your project information comes from **documents, audio or video recordings, Figma designs, Playwright projects or connected code repositories.** WalnutAI leverages AI to transform these inputs into well-defined and actionable requirements.

You can also interact with the **WalnutAI Chatbot** to create, modify, or refine your generated user stories and test cases. This allows you to improve descriptions, update acceptance criteria, restructure stories, add missing details, and make any necessary refinements before finalizing them.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FEh4467jYv6Zj2ClHgPw2%2FScreenshot%202026-08-06%20at%2011.56.06%E2%80%AFAM.png?alt=media&amp;token=29a0a732-4d33-40b4-ae85-62829f1ec419" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** It is mandatory to click **Save** to retain the generated content. If you do not save, the generated **Epics, Features, User Stories, and Test Cases** will be discarded and will no longer be available.
{% endhint %}

After saving:

* **Epics, Features, and User Stories** are available in the **Action Items** module.
* **Test Cases** are available in the **Test Cases** module.

The Intelligence Hub also includes a **History** section that provides a complete record of all interactions performed within the module. It maintains a chronological history of generated user stories, test cases, prompts, refinements, and AI responses across all supported input sources.

&#x20;This enables you to revisit previous generations, review modifications, track changes, and continue working from earlier interactions without losing context


# Files (Requirements to Story)

**When to Use Requirements-to-Story Conversion:**\
Use this feature when you have static requirements (such as BRDs, specifications, presentations, or spreadsheets) and want to automatically convert them into structured Epics, Features, User Stories, and Test Cases within WalnutAI.

* **Supported Formats:** `PDF`, `DOCX`, `XLSX`, `CSV`, `MD`, `PPTX`, `PPT`.
* **Maximum File Size:** 10 MB.

**Steps to Generate:**

* Click the **link** icon under the **Stories** tab.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FxjYEGXOGYGOR0W8w4i0z%2FScreenshot%202026-07-30%20at%206.18.05%E2%80%AFPM.png?alt=media&amp;token=fbf90321-b2aa-4306-9fe3-187f272774c0" alt=""><figcaption></figcaption></figure>

* Select the **Document** option.
* Upload a supported file from your local device.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKvS3H4JZ00eP6bxz774U%2FScreenshot%202026-07-30%20at%206.18.47%E2%80%AFPM.png?alt=media&amp;token=c94c70ae-2810-4026-8835-15fe62993794" alt=""><figcaption></figcaption></figure>

* The AI agent analyzes the uploaded document and generates **Epics, Features, and User Stories** based on the extracted requirements.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FkGaWDL0SA1Ja8sFlCvY8%2FScreenshot%202026-07-30%20at%206.21.31%E2%80%AFPM.png?alt=media&amp;token=9a88ff8d-c046-4b15-879d-47cd7c5dba19" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Select a generated User Story and click Use in Chat to generate the related test cases.
{% endhint %}

* Click **Save** to store the generated **Epics, Features, User Stories, and Test Cases**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FDCpzJAJxBtcDAovgTDhG%2FScreenshot%202026-07-30%20at%206.22.36%E2%80%AFPM.png?alt=media&amp;token=6fb09c79-858b-4b7b-aaf4-637f8dd09451" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Result: Saved Epics, features and User Stories reflect in Action Items, while Test Cases appear in the Test Cases module.
{% endhint %}


# Media (Audio/Video to Requirement)

**When to Use the Media Feature**

The Media feature is most effective when you have raw, unstructured information captured in audio or video format. Instead of manually transcribing recordings and drafting requirements, this feature helps bridge the gap between conversations and a structured project backlog.

* **Supported Video Formats:** MP4, MOV, MKV
* **Supported Audio Formats:** MP3, WAV, M4A
* **Maximum File Size:** 100 MB

**Steps to Generate:**

* Click the **link** icon under the **Stories** tab.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FG55v194Z0YiKQYXDvgsZ%2FScreenshot%202026-07-30%20at%206.32.48%E2%80%AFPM.png?alt=media&amp;token=f60d32f9-84ff-4c40-87b6-a1556f6d0b90" alt=""><figcaption></figcaption></figure>

* Select the **Audio / Video** option.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FPOZ9JlT1M2cDvdyNGzCG%2FScreenshot%202026-07-30%20at%206.35.39%E2%80%AFPM.png?alt=media&amp;token=167dc2dc-7d0f-40f3-8d17-6952a31c6eff" alt=""><figcaption></figcaption></figure>

* Upload a supported audio or video file from your local device.
* The AI agent transcribes and analyzes the uploaded content to generate **Epics, Features, and User Stories** based on the extracted requirements.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FhveLttwhEvTlJXcEvk1M%2FScreenshot%202026-07-30%20at%206.37.01%E2%80%AFPM.png?alt=media&amp;token=5a82592f-72ba-4717-b516-3ab6d966cc8a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Select a generated User Story and click Use in Chat to generate the related test cases.
{% endhint %}

* Click **Save** to store the generated **Epics, Features, User Stories, and Test Cases**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F3RIy2KhXj1CLk9jEFjAd%2FScreenshot%202026-07-30%20at%206.38.22%E2%80%AFPM.png?alt=media&amp;token=a4246eca-6e0b-478e-a8ee-fcc3886b983c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Result: Saved Epics, features and User Stories reflect in Action Items, while Test Cases appear in the Test Cases module.
{% endhint %}


# Code (Repository to Requirement)

The **Code** option within the Intelligence Hub allows you to generate structured **Epics, Features, and User Stories** directly from your application's source code. This feature analyzes your connected repository to derive functional requirements, eliminating the need to manually document existing application functionality.

#### When to Use Code-Based Requirement Extraction

Use this option when your application's functionality is already available in a connected source code repository. WalnutAI analyzes the repository and automatically generates structured **Epics, Features, and User Stories**, making it easy to document existing applications, legacy systems, or projects with limited functional documentation.

* **Existing Connection:** If a repository was configured during project setup ([GitHub](/getting-started/projects/create-a-new-project/external-data-and-connections/how-to-integrate-github-with-walnutai), [GitLab](/getting-started/projects/create-a-new-project/external-data-and-connections/how-to-integrate-gitlab-with-walnutai), [Bitbucket](/getting-started/projects/create-a-new-project/external-data-and-connections/how-to-integrate-bitbucket-with-walnutai), [Azure Repos](/getting-started/projects/create-a-new-project/external-data-and-connections/how-to-integrate-azure-repos-with-walnutai), or [AWS CodeCommit](/getting-started/projects/create-a-new-project/external-data-and-connections/how-to-integrate-aws-codecommit-with-walnutai)), it will automatically appear under the **Code** option in the Intelligence Hub.
* **Open the Code Repository:** Click the **Code** icon in the Intelligence Hub to view the list of available repositories.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FWMr2xgJac0oK4l4hN2eh%2FScreenshot%202026-08-06%20at%2012.06.39%E2%80%AFPM.png?alt=media&amp;token=44057011-c0a9-4361-a37a-b03ff5d90c29" alt=""><figcaption></figcaption></figure>

* **Select a Repository:** Choose the repository you want to use. The selected repository is automatically attached to the WalnutAI Chat for analysis.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FI4WC4o8PJd1T81n7IaXy%2FScreenshot%202026-08-06%20at%2012.08.08%E2%80%AFPM.png?alt=media&amp;token=b047f6e7-1286-4ac1-8067-76477e6a9545" alt=""><figcaption></figcaption></figure>

* **Generate Requirements:** Enter your prompt in the chat and click **Generate**. WalnutAI analyzes the repository and generates structured **Epics, Features, and User Stories** based on the application's source code.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FH4CqTm1hGWHbp9vISjao%2FScreenshot%202026-08-06%20at%2012.17.09%E2%80%AFPM.png?alt=media&amp;token=788e583f-ad46-44fd-8040-e3e6e61bd16c" alt=""><figcaption></figcaption></figure>

* Review the generated requirements and refine them as needed using the Chat panel. You can modify descriptions, acceptance criteria, or story details before saving the generated Epics, Features, and User Stories.

{% hint style="info" %}
Select a generated User Story and click Use in Chat to generate the related test cases.
{% endhint %}

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FUoEa4J2HN3sxHBenW9ih%2FScreenshot%202026-08-06%20at%2012.18.24%E2%80%AFPM.png?alt=media&amp;token=19827c70-1bc0-499a-8060-6f5bcf236ee4" alt=""><figcaption></figcaption></figure>

* Click **Save** to store the generated Epics, Features, User Stories, and Test Cases.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F4rYdYvL5Az2UKSBzlcKC%2FScreenshot%202026-08-06%20at%2012.19.54%E2%80%AFPM.png?alt=media&amp;token=a15a4330-a562-4ef2-b272-22d60c8f65ae" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Result: Upon saving, items are stored in Action Items, and Test Cases populate the Test Cases page.
{% endhint %}


# Figma (UI Designs to Requirement)

The Figma integration in WalnutAI allows you to transform UI designs into structured software requirements. By selecting the relevant frames from your connected Figma project, WalnutAI analyzes the screens and automatically generates requirements based on the design elements and user flows.&#x20;

Follow the steps below to select Figma frames and generate requirements.

* If you have already connected **Figma** during the project setup, select **Figma**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FRLWRFBuwI7fa4IkQgHIE%2FScreenshot%202026-08-06%20at%201.36.38%E2%80%AFPM.png?alt=media&amp;token=5f78afc2-2a67-4826-ab8b-8af9da82eae3" alt=""><figcaption></figcaption></figure>

* Enter the **Team ID**, then select the **Project**, **File**, and **Page** containing the designs you want to use.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FyvZer8U1AWmcwb7Jj0nc%2FScreenshot%202026-08-06%20at%201.46.15%E2%80%AFPM.png?alt=media&amp;token=9b41951f-865e-40b8-ac1a-b19e0d468057" alt=""><figcaption></figcaption></figure>

* Click **Select Frames**, then choose **Browse Frames** to display all the frames associated with the selected page.
* To preview a frame before selecting it, click the **View** icon on the left-hand side.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fq9B5MGa0XIGEO84lQmgu%2FScreenshot%202026-08-06%20at%203.11.00%E2%80%AFPM.png?alt=media&amp;token=b9c21cf2-4028-45ae-b23f-bc23df7d495f" alt=""><figcaption></figcaption></figure>

* Select one or more frames that you want to use for requirement generation.
* Click **Confirm Selection** to import the selected frames.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FGpij2jmNZydJ8pPRzEZS%2FScreenshot%202026-08-06%20at%203.12.42%E2%80%AFPM.png?alt=media&amp;token=5f80758b-ea2e-458f-a5b8-16f116e792a0" alt=""><figcaption></figcaption></figure>

* WalnutAI analyzes the selected Figma screens and automatically generates detailed software requirements based on the UI design.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FRnbZmMYP3Jn9CV2xqChB%2FScreenshot%202026-08-06%20at%203.15.12%E2%80%AFPM.png?alt=media&amp;token=1937ab4e-d9ab-4dca-bbdd-c0f11749d152" alt=""><figcaption></figcaption></figure>

* The generated requirements provide a structured foundation for creating user stories, test scenarios, and test cases, reducing manual documentation effort and accelerating the testing process.

{% hint style="info" %}
Select a generated User Story and click Use in Chat to generate the related test cases.
{% endhint %}

* Click **Save** to store the generated Epics, Features, User Stories, and Test Cases.

{% hint style="info" %}
Result: Upon saving, items are stored in Action Items, and Test Cases populate the Test Cases page.
{% endhint %}


# Generate Test Cases

The **Test Cases** tab within the Intelligence Hub enables you to generate comprehensive manual and automated test cases through a unified workflow.

Whether your project information comes from **documents, generated requirements, Figma designs, audio or video recordings, Playwright projects, connected code repositories.** WalnutAI leverages AI to generate **detailed, structured, and executable manual test cases**, ensuring comprehensive coverage and traceability across your application lifecycle.

For automation, WalnutAI provides **Smart Recording**, enabling you to create automated test cases using two recording modes:

* **AI Recording**, where AI understands your prompt and automatically performs the required actions to generate automated test cases.
* **Manual Recording**, where you manually perform the application steps while WalnutAI records the actions and generates the corresponding automation scripts.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FsJ3FjyH4oSSdm21OWy8e%2FScreenshot%202026-08-06%20at%203.29.47%E2%80%AFPM.png?alt=media&amp;token=d2b0e4ba-aa30-47ae-80f3-5f5dd6f6bcbe" alt=""><figcaption></figcaption></figure>

You can also interact with the **WalnutAI Chatbot** to create, modify, or refine your generated test cases.

{% hint style="info" %}
**Note:** It is mandatory to click **Save** to retain the generated content. If you do not save, the generated test cases will be discarded and will no longer be available.
{% endhint %}

**After saving:**

* Manual and automated **Test Cases** are available in the **Test Cases** module.

The Intelligence Hub also includes a **History** section that provides a complete record of all interactions performed within the module. It maintains a chronological history of generated user stories, test cases, prompts, refinements, and AI responses across all supported input sources.

This allows you to initiate a new session, revisit previous generations, review modifications, track changes, and continue working from earlier interactions without losing context.


# Files ( Requirements to Test Case)

**When to Use Requirements to Test Case Conversion:**\
Use this feature when you have static requirements, such as **BRDs, specifications, presentations, or spreadsheets**, and want to automatically generate structured **test cases** within WalnutAI.

**Supported Formats:** PDF, DOCX, XLSX, CSV, MD, PPTX, PPT.\
**Maximum File Size:** 10 MB.

**Steps to Generate Test Cases**

* Click the **link icon** under the **Test Cases** tab.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fv47PjzTDHyeZLTwqkSgM%2FScreenshot%202026-08-10%20at%207.22.01%E2%80%AFPM.png?alt=media&amp;token=b689646a-4d2b-412f-8593-06bc235052ad" alt=""><figcaption></figcaption></figure>

* Select the **Document** option.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FbTtE6rfBQVFMIYPsddYL%2FScreenshot%202026-08-10%20at%207.00.41%E2%80%AFPM.png?alt=media&amp;token=51301507-10c6-4929-907e-0fd0aa683635" alt=""><figcaption></figcaption></figure>

* Upload a supported requirements file from your local device.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FFbP6EM10tckPL4lLt10G%2FScreenshot%202026-08-10%20at%207.02.39%E2%80%AFPM.png?alt=media&amp;token=7ca694e9-eeaa-400c-a863-a2797dc4e7c9" alt=""><figcaption></figcaption></figure>

* The AI agent analyzes the uploaded document, identifies the requirements and associated workflows, and generates relevant **manual test cases** based on the extracted information.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FVHcWUzdJ9KSxDPZHM757%2FScreenshot%202026-08-10%20at%207.20.02%E2%80%AFPM.png?alt=media&amp;token=a1d74f4c-74d1-4da6-a104-d0dc45e61a95" alt=""><figcaption></figcaption></figure>

* Review the generated manual test cases and click **Save** to store the generated **test cases** in WalnutAI.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FOSJ3D0xIq1tY06aun59w%2FScreenshot%202026-08-10%20at%207.18.35%E2%80%AFPM.png?alt=media&amp;token=53f68497-fe70-4477-b0fc-f07e463f9b19" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Result: Saved Test Cases appear in the Test Cases module.
{% endhint %}


# Media (Audio/Video to Test Case)

**When to Use the Media Feature**

The **Media** feature is useful when you have raw, unstructured information captured in **audio or video format** and want to convert it into structured test cases. Instead of manually transcribing the recording and creating test scenarios, WalnutAI analyzes the uploaded media and generates relevant test cases from the extracted requirements and workflows.

* **Supported Video Formats:** MP4, MOV, MKV
* **Supported Audio Formats:** MP3, WAV, M4A
* **Maximum File Size:** 100 MB

**Steps to Generate Test Cases**

* Click the **link** icon under the **Test Cases** tab.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fv47PjzTDHyeZLTwqkSgM%2FScreenshot%202026-08-10%20at%207.22.01%E2%80%AFPM.png?alt=media&amp;token=b689646a-4d2b-412f-8593-06bc235052ad" alt=""><figcaption></figcaption></figure>

* Select the **Audio / Video** option.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FkDKhMbJXX0pVPCXxJZ93%2FScreenshot%202026-08-10%20at%207.22.48%E2%80%AFPM.png?alt=media&amp;token=2d0c91e2-f19b-4d0c-9094-584017c39ba1" alt=""><figcaption></figcaption></figure>

* Upload a supported audio or video file from your local device.
* The AI agent **transcribes and analyzes** the uploaded content to identify requirements, workflows, and scenarios, and generates relevant manual **test cases**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FiJhv9WUCfljHCzlcuoTr%2FScreenshot%202026-08-10%20at%207.27.19%E2%80%AFPM.png?alt=media&amp;token=7adebbcf-5e04-4361-b51c-e182c52db094" alt=""><figcaption></figcaption></figure>

* Review the generated manual test cases and click **Save** to store the generated **test cases**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FzH0vIZtNmIGWguRAWoxx%2FScreenshot%202026-08-10%20at%207.31.48%E2%80%AFPM.png?alt=media&amp;token=6fcbf0ef-567a-442c-8533-b13d5ec53460" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Result:** The generated test cases are saved and available in the **Test Cases** module.
{% endhint %}


# Code (Repository to Test Case)

The **Code** option within the Intelligence Hub allows you to generate structured **test cases** directly from your application's source code. This feature analyzes your connected repository to understand the application's functionality and generate relevant test scenarios, eliminating the need to manually create test cases from existing application behavior.

**When to Use Code-Based Test Case Generation**

Use this option when your application's functionality is already available in a connected source code repository. WalnutAI analyzes the repository and automatically generates structured **test cases**, making it useful for documenting and testing existing applications, legacy systems, or projects with limited test documentation.

* **Existing Connection:** If a repository was configured during project setup (**GitHub, GitLab, Bitbucket, Azure Repos, or AWS CodeCommit**), it will automatically appear under the **Code** option in the Intelligence Hub.
* **Open the Code Repository:** Click the **Code** icon in the Intelligence Hub to view the list of available repositories.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FH7LLFMRNd99anZAKSWvt%2FScreenshot%202026-08-17%20at%202.02.29%E2%80%AFPM.png?alt=media&amp;token=0604fd6b-7473-450f-b12c-3ca97298000d" alt=""><figcaption></figcaption></figure>

* **Select a Repository:** Choose the repository you want to use. The selected repository is automatically attached to the WalnutAI Chat for analysis.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FnPG5B6rSuHJhfvlTpnMN%2FScreenshot%202026-08-17%20at%201.57.40%E2%80%AFPM.png?alt=media&amp;token=84536abe-72e8-4265-a910-8f613e6632e2" alt=""><figcaption></figcaption></figure>

* **Generate Test Cases:** WalnutAI analyzes the repository and generates relevant **manual test cases** based on the application's source code.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FgJkbxP0RJHfsUJEHP1i2%2FScreenshot%202026-08-17%20at%202.05.35%E2%80%AFPM.png?alt=media&amp;token=21252e85-cdec-430f-bbf2-c55d988edfed" alt=""><figcaption></figcaption></figure>

* Review the generated manual test cases and click **Save** to store the generated **test cases**.

{% hint style="info" %}
**Result:** Upon saving, the generated test cases are available in the **Test Cases** module.
{% endhint %}


# Figma (UI Designs to Test Case)

The **Figma** integration in WalnutAI allows you to generate structured **test cases directly from UI designs**. By selecting relevant frames from your connected Figma project, WalnutAI analyzes the screens, UI elements, and user flows to identify relevant test scenarios and generate detailed test cases.

Follow the steps below to select Figma frames and generate test cases.

* If you have already connected **Figma** during the project setup, select **Figma**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKtPJ7lhtTwgI3LoExU9W%2FScreenshot%202026-08-17%20at%205.06.35%E2%80%AFPM.png?alt=media&amp;token=7f17c901-d7d0-4974-947f-c59571fc3de6" alt=""><figcaption></figcaption></figure>

* Enter the **Team ID**, then select the **Project**, **File**, and **Page** containing the designs you want to use.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FOatx62J5jDI1M2w35Nt8%2FScreenshot%202026-08-17%20at%205.08.39%E2%80%AFPM.png?alt=media&amp;token=9bc23251-aeff-4277-8ce6-23c6cf8a5d16" alt=""><figcaption></figcaption></figure>

* Click **Select Frames**, then choose **Browse Frames** to display all the frames associated with the selected page.

* To preview a frame before selecting it, click the **View** icon on the left-hand side.

* Select one or more frames that you want to use for test case generation.

* Click **Confirm Selection** to import the selected frames.

* WalnutAI analyzes the selected Figma screens and automatically generates detailed **manual test cases** based on the UI design, available elements, and identified user flows.

* Review the generated test cases and click **Save** to store the generated **test cases**.

{% hint style="info" %}
**Result:** Upon saving, the generated test cases are available in the **Test Cases** module.
{% endhint %}


# Smart Recording

**Smart Recording** in WalnutAI enables you to quickly create automated test cases by capturing application workflows through **AI Recording** or **Manual Recording**. It simplifies test automation by allowing you to define or perform a business flow, while WalnutAI converts it into a structured and executable automated test case.\
\
The Smart Recording interface provides a flexible recording experience where you can **manage test cases, switch test types, select recording modes, and configure recording settings** directly from the **bottom recording bar**.

**Recording Modes:** Smart Recording offers multiple modes to support different testing requirements. Click **AI Recording** in the bottom bar to view and switch between the available modes.

* **AI Recording:** Generate test steps by describing the required application flow using natural-language instructions. WalnutAI understands the instructions, performs the required actions, and generates the corresponding automated test steps. It asks questions or requests additional input whenever necessary to complete the flow.
* **AI Recording – Auto:** Generate test steps using an autonomous AI-driven approach. WalnutAI explores the application on its own based on the provided instructions, performs the required actions without pausing to ask questions, and generates the corresponding automated test steps.
* **Plan:** Interact with the AI bot to describe the required testing objective or application flow. WalnutAI analyzes the provided instructions and generates a **test plan** outlining the recommended approach and steps for testing the flow.
* **Healer:** Fix or troubleshoot a **failing test case** by identifying issues in the existing test flow and applying the required corrections.
* **Manual Recording:** Interact with the application manually while WalnutAI captures the actions performed, including the relevant test steps and parameters, and converts the recorded flow into an automated test case.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FTJr7X2TmajYFIXn5OIJq%2FScreenshot%202026-09-25%20at%2012.31.47%E2%80%AFPM.png?alt=media&amp;token=f93796a2-0793-476e-a173-2450bed53e65" alt=""><figcaption></figcaption></figure>

Click the **Web** icon in the bottom bar to select the application type you want to automate. Smart Recording supports multiple application types, including **Web, API, Mobile, Mainframe, and SAP**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F5UdGE5IlKJ7699dLlwvG%2FScreenshot%202026-09-25%20at%2012.32.58%E2%80%AFPM.png?alt=media&amp;token=25745f4c-f56e-46d9-bae6-6aba9ad1c3be" alt=""><figcaption></figcaption></figure>

Before starting a recording, ensure that the **Agent is turned on**. The Agent enables WalnutAI to interact with the application, process the recording or prompt, and generate the corresponding automated test steps.

WalnutAI also allows you to convert existing [**manual test cases into automated test cases** ](/test-and-quality-management/test-management/convert-a-manual-test-case-to-an-automated-test-case)using Smart Recording. You can assign a manual test case to **Smart Recording**, after which it appears under the **Tasks** tab. Select the assigned test case to process it through Smart Recording. The existing manual test steps are then used to generate the corresponding **automated test steps**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F033L5l9iYEnRMzeo1W59%2FScreenshot%202026-09-25%20at%2012.10.34%E2%80%AFPM.png?alt=media&amp;token=bb262550-2896-408a-991b-76a805cc6132" alt=""><figcaption></figcaption></figure>

Use the **History** button available at the top of the Smart Recording screen to access previous recording sessions. To start a fresh recording session, use the **History** option to initiate a **New Session**, ensuring that the new recording starts independently from previous sessions.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FINtMbX7pjyxLHrzPJ6El%2FScreenshot%202026-09-25%20at%2012.11.27%E2%80%AFPM.png?alt=media&amp;token=084e9e57-2fe4-454f-8715-86f51c7fb047" alt=""><figcaption></figcaption></figure>

Use the **+** icon in the bottom bar to add existing **test cases or custom methods** to the current recording session. You can select the required test case or custom method, choose the environment and insertion point, and reuse the existing automation within the current test flow.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F3qsuVNgojejCHH5jkPjJ%2FScreenshot%202026-09-25%20at%206.09.58%E2%80%AFPM.png?alt=media&amp;token=61845c3c-0423-446a-b1ea-c640f332697b" alt=""><figcaption></figcaption></figure>

Use the **Attach** button in the chat panel to attach a **document or file** as additional input for the recording. The attached document can be used by WalnutAI to understand the required flow and generate the corresponding test steps.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FgEdp6WO8PFNVIPZUR0Ei%2FScreenshot%202026-09-25%20at%206.11.14%E2%80%AFPM.png?alt=media&amp;token=3bea7c01-f34b-47b7-aa8c-0c200874f042" alt=""><figcaption></figcaption></figure>

Whether you prefer to describe a workflow or interact directly with the application, Smart Recording helps reduce the effort required to build automated test cases while maintaining a structured and reusable test flow.


# AI Recording

**AI Recording** in WalnutAI allows you to create automated test cases by describing the required application flow in a natural-language prompt. The AI agent understands the instructions, interacts with the application, and generates structured test steps based on the flow.

WalnutAI provides two AI Recording modes. To switch between the available modes, click the **AI Recording** button in the **bottom bar** and select the required mode.

* **AI Recording:** Generates test steps from the instructions provided through prompts. The AI agent can pause during the process to ask for additional input or clarification when required.
* **AI Recording · Auto:** Follows the same AI-driven recording approach but runs continuously **without pausing to ask questions along the way**, enabling a more uninterrupted recording experience.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FTJr7X2TmajYFIXn5OIJq%2FScreenshot%202026-09-25%20at%2012.31.47%E2%80%AFPM.png?alt=media&amp;token=f93796a2-0793-476e-a173-2450bed53e65" alt=""><figcaption></figcaption></figure>

* Click the **Web** icon in the bottom bar to select the test type you want to automate. Smart Recording supports multiple application types, including **Web, API, Mobile, Mainframe, and SAP**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F5UdGE5IlKJ7699dLlwvG%2FScreenshot%202026-09-25%20at%2012.32.58%E2%80%AFPM.png?alt=media&amp;token=25745f4c-f56e-46d9-bae6-6aba9ad1c3be" alt=""><figcaption></figcaption></figure>

* **Click the Settings icon** in the bottom bar to open the **Recording Settings** for the selected application type.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FwvyH1xCBzwVGTkGV0voP%2FScreenshot%202026-09-25%20at%2012.52.23%E2%80%AFPM.png?alt=media&amp;token=dc765baf-dd85-4702-93c7-a439aeb861b6" alt=""><figcaption></figcaption></figure>

* **Live Screen:** Enable **Live Screen** to view the application's interactions in real time while the AI agent performs the actions described in the prompt. If **Live Screen is disabled**, the application opens in a **separate browser window**, where you can view the AI agent's interactions.
* **Reuse Session:** Enable **Reuse Session** to reuse an existing application session, including previously captured cookies. This is particularly useful for applications that require authentication, as it can help avoid repeating the authentication process during subsequent recordings.
* **URL:** Enter the URL of the application you want to automate.
* **Browser:** Select the browser in which the AI Recording should be performed. WalnutAI supports **Chrome, Microsoft Edge, Firefox, and WebKit**.
* Click **Connect**. Once the URL is connected, the prompt-based chat panel is enabled, allowing you to provide instructions to the AI agent and describe the flow you want to automate.
* On the Parameters tab, click Chat with AI to generate test data for the generated test case.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FPeUv8mFjAMdWqtGyHTRj%2FScreenshot%202026-10-16%20at%203.19.06%E2%80%AFPM.png?alt=media&amp;token=13ac8d78-71d4-47b1-897d-01d09b0f8fad" alt=""><figcaption></figcaption></figure>

* You can execute test cases and heal failed test steps directly through the chat panel.

<figure><img src="broken://files/npxC6kwxQnywm64K3jl5" alt=""><figcaption></figcaption></figure>


# Web Test Case Creation

Creating a Web test case in WalnutAI allows you to automate web application workflows using **AI Recording**. Simply describe the required flow in a natural-language prompt, and WalnutAI generates the corresponding automated test steps.

**Steps to Generate a Web Test Case:**

* Navigate to the **Intelligence Hub**, select **Smart Recording**, and ensure the **Agent** is turned on.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKv6HboeYjnA9aETgPMoR%2FScreenshot%202026-09-29%20at%206.17.43%E2%80%AFPM.png?alt=media&amp;token=4b6d30b7-b320-4a1c-8b3c-6745023a7148" alt=""><figcaption></figcaption></figure>

* Click the **AI Recording** button in the **bottom bar** and select the suitable **AI Recording** mode.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FcL4wZ6u26jMGNAkGovvY%2FScreenshot%202026-09-25%20at%201.09.09%E2%80%AFPM.png?alt=media&amp;token=dee7f980-ca4e-4a5a-b682-6b5a54c20fa2" alt=""><figcaption></figcaption></figure>

* Click the **Web** button in the bottom bar and select **Web** as the test type.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FBld04OcvNkOcwb0r39Mv%2FScreenshot%202026-09-25%20at%201.10.03%E2%80%AFPM.png?alt=media&amp;token=9b69d8d7-7813-49d4-b386-90980dfac92a" alt=""><figcaption></figcaption></figure>

* Click the **Settings** icon in the bottom bar and configure the required [recording settings. ](#user-content-fn-1)[^1]

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FiUQTYNWyFU1yON9nQuwZ%2FScreenshot%202026-09-25%20at%201.11.56%E2%80%AFPM.png?alt=media&amp;token=e87e1d6b-8f67-4f21-804e-34c69e794b3e" alt=""><figcaption></figcaption></figure>

* Enter the application URL and click **Connect**. Once connected, the application opens in the **Live Screen.**

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FOo834Yo49NZbHvcluLAZ%2FScreenshot%202026-09-25%20at%201.15.46%E2%80%AFPM.png?alt=media&amp;token=8a2ce4ed-b31c-418d-92c5-8783aa00ab28" alt=""><figcaption></figcaption></figure>

* Describe the required workflow in the chat panel. For example: *Log in to the application with valid credentials and log out.*&#x20;

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FeEHYzcbmSwOdNvRutrnr%2FScreenshot%202026-09-25%20at%201.18.09%E2%80%AFPM.png?alt=media&amp;token=6d399a8d-3e0b-4340-adda-b3daf986571c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Use the **+** icon to add existing **test cases or custom methods** to the recording session. For more information, refer to [**Insert Test Cases and Custom Methods**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/ai-recording/insert-test-cases-and-custom-methods)
{% endhint %}

* Click **Send**. The AI agent processes the instructions, performs the required actions, and generates the corresponding test steps.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FaCCFW4KuAUk0Q7Ej6DUJ%2FScreenshot%202026-09-25%20at%201.18.54%E2%80%AFPM.png?alt=media&amp;token=407a6349-be32-4b82-b8ef-e04913c3c1b0" alt=""><figcaption></figcaption></figure>

* Once the test case is generated, review and customize the steps as required. You can **edit objects, skip a step, enable Continue on Failure, add a new step, add a nested test case, cancel a step, or** [**debug the test case**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/debug-a-test-case-in-smart-recording)

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FbLpz3V9jwlat9a1N1f8v%2FScreenshot%202026-09-25%20at%201.19.58%E2%80%AFPM.png?alt=media&amp;token=87907dbc-7a57-421c-a591-1ee910bf77f8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For detailed information on modifying individual test steps, refer to  [**Manage a Test Step**.](/test-and-quality-management/test-management/test-cases/manage-test-step)
{% endhint %}

* On the Parameters tab, click **Chat with AI** to generate test data for the generated test case.
* You can execute test cases and heal failed test steps directly through the chat panel.
* Once you have completed the required modifications, click **Disconnect** to end the session and then click **Save** to save the generated test case.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FpHmjBxjl7euGXdfa4EHO%2FScreenshot%202026-09-25%20at%201.20.29%E2%80%AFPM.png?alt=media&amp;token=04c7961c-7fc2-49aa-88b6-4001f980cd8c" alt=""><figcaption></figcaption></figure>

* Click the **chevron** next to the test case to expand it and view an overview of all the test steps.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FaedeDXxUoHSPGaqOuXcL%2FScreenshot%202026-08-10%20at%205.44.44%E2%80%AFPM.png?alt=media&amp;token=6bbe3d55-45bd-4fd2-8b4a-6c1a29a553cb" alt=""><figcaption></figcaption></figure>

[^1]: * **Live Screen:** Enable this to view the application interactions in real time while the AI agent performs the requested actions.
    * **Reuse Session:** Enable this to reuse an existing application session, including previously captured cookies, to avoid repeating authentication.


# API Test Case Creation

Creating an API test case in WalnutAI allows you to automate API workflows using **AI Recording**. Instead of capturing UI objects, XPaths, or other web elements, WalnutAI captures the **API requests and responses** generated during the workflow and converts them into automated test steps.

**Steps to Generate an API Test Case:**

* Navigate to the **Intelligence Hub**, select **Smart Recording**, and ensure the **Agent** is turned on.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKv6HboeYjnA9aETgPMoR%2FScreenshot%202026-09-29%20at%206.17.43%E2%80%AFPM.png?alt=media&amp;token=4b6d30b7-b320-4a1c-8b3c-6745023a7148" alt=""><figcaption></figcaption></figure>

* Click the **AI Recording** button in the **bottom bar** and select the suitable **AI Recording** mode.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FcL4wZ6u26jMGNAkGovvY%2FScreenshot%202026-09-25%20at%201.09.09%E2%80%AFPM.png?alt=media&amp;token=dee7f980-ca4e-4a5a-b682-6b5a54c20fa2" alt=""><figcaption></figcaption></figure>

* Click the **Web** button in the bottom bar and select **API** as the test type.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fc1GypRclRlBb1vNwj8OS%2FScreenshot%202026-09-25%20at%201.42.58%E2%80%AFPM.png?alt=media&amp;token=9872f422-c095-43ca-b951-e67eee658069" alt=""><figcaption></figcaption></figure>

* Click the **Settings** icon in the bottom bar and configure the required [recording settings. ](#user-content-fn-1)[^1]

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FhR9s9hrgU1lrBrkCWI8v%2FScreenshot%202026-09-25%20at%201.51.45%E2%80%AFPM.png?alt=media&amp;token=93bc65e5-819c-4488-9916-2ad7ae06fe38" alt=""><figcaption></figcaption></figure>

* Enter the application URL and click **Connect**. Once connected, the application opens in the **Live Screen.**

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FMSKD9v9TkoIwaad007st%2FScreenshot%202026-09-25%20at%201.45.45%E2%80%AFPM.png?alt=media&amp;token=87c9f6ba-2c88-49b4-b1a1-e2273e39bee9" alt=""><figcaption></figcaption></figure>

* Describe the API workflow you want to automate in the chat panel. For example: *Log in to the application using valid credentials and retrieve the user details.*

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FTowug2TwjeQTqnCTatb9%2FScreenshot%202026-09-25%20at%201.47.48%E2%80%AFPM.png?alt=media&amp;token=53732a0b-f99a-4735-85f1-ae0ba035e6ae" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Use the **+** icon to add existing **test cases or custom methods** to the recording session. For more information, refer to [**Insert Test Cases and Custom Methods**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/ai-recording/insert-test-cases-and-custom-methods)
{% endhint %}

* Click **Send**. The AI agent processes the instructions, performs the required workflow, and captures the **API requests and responses** involved in the flow. WalnutAI then generates the corresponding API test case with the required requests, parameters, headers, payloads, and validations.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FlDz91cIDmLj5EWjczX0g%2FScreenshot%202026-09-25%20at%201.48.12%E2%80%AFPM.png?alt=media&amp;token=13ca14c3-f4dd-4604-9528-34387726bfae" alt=""><figcaption></figcaption></figure>

* Click the **API Editor** icon to view and configure the API request details, including **headers, parameters, request body, response details, and assertions**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FbwLUeUHVtpUre6KPqQNS%2FScreenshot%202026-09-25%20at%208.55.06%E2%80%AFPM.png?alt=media&amp;token=d9e972ca-3ce0-40d6-b4c1-5cbf518413a0" alt=""><figcaption></figcaption></figure>

* Once the test case is generated, review and customize the API steps as required. You can **edit request details, modify parameters, skip a step, enable Continue on Failure, add a new step, add a nested test case, cancel a step, or** [**debug the test case**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/debug-a-test-case-in-smart-recording)

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FFvqRGwshgvyeO9A3kclE%2FScreenshot%202026-08-12%20at%2012.30.07%E2%80%AFPM.png?alt=media&amp;token=e41ef560-7f81-4ded-95df-f4a83060576a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For detailed information on modifying individual test steps, refer to  [**Manage a Test Step**.](/test-and-quality-management/test-management/test-cases/manage-test-step)
{% endhint %}

* On the Parameters tab, click **Chat with AI** to generate test data for the generated test case.
* You can execute test cases and heal failed test steps directly through the chat panel.
* Once you have completed the required modifications, click **Disconnect** to end the recording session. Then, click **Done** and **Save** to save the generated API test case.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FpHmjBxjl7euGXdfa4EHO%2FScreenshot%202026-09-25%20at%201.20.29%E2%80%AFPM.png?alt=media&amp;token=04c7961c-7fc2-49aa-88b6-4001f980cd8c" alt=""><figcaption></figcaption></figure>

[^1]: * **Live Screen:** Enable this to view the application interactions in real time while the AI agent performs the requested actions.
    * **Reuse Session:** Enable this to reuse an existing application session, including previously captured cookies, to avoid repeating authentication.


# Mobile Test Case Creation

WalnutAI enables you to create and automate test cases for **Android** and **iOS** applications. Mobile test cases can be created using **AI Recording** or **Manual Recording** and can be recorded and executed on **real devices** or **emulators/simulators**.

Click the **Web** button in the bottom bar and select **Mobile** as the test type before starting the recording.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FjPNawk35VsrFm1utJrzQ%2FScreenshot%202026-09-25%20at%201.58.23%E2%80%AFPM.png?alt=media&amp;token=14d38f31-fd4d-4d77-9d48-6c590e422405" alt=""><figcaption></figcaption></figure>

**Recording Mode:** WalnutAI provides two AI Recording modes for mobile testing:

* **AI Recording:** Generates test steps based on the instructions provided through prompts. The AI agent interacts with you during the process and can ask questions or request additional input or clarification whenever required.
* **AI Recording · Auto:** Follows an AI-driven approach where the agent independently explores the application and performs the required actions based on the provided instructions, without interacting with you or pausing to ask questions during the process.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FfkL0nk7a6rxN11qhayGk%2FScreenshot%202026-09-25%20at%2012.15.35%E2%80%AFPM.png?alt=media&amp;token=a900bd90-34db-4279-806d-8f02c3c8a1e9" alt=""><figcaption></figcaption></figure>

Click the **Settings** icon in the bottom bar and configure the required recording settings:

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F21UYIbEOqyGoSVneYOff%2FScreenshot%202026-09-25%20at%202.07.52%E2%80%AFPM.png?alt=media&amp;token=f7904f58-3e54-4796-854d-4f7122e7ea51" alt=""><figcaption></figcaption></figure>

**Platform:** Select the mobile platform based on the application you want to test:

* **Android** – Used to create and execute test cases for Android applications.
* **iOS** – Used to create and execute test cases for iOS applications.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FOqwiDOvgubrjRbhWC63t%2FScreenshot%202026-09-25%20at%202.04.12%E2%80%AFPM.png?alt=media&amp;token=dbd745b3-8107-49d3-ada3-ca2b3c13b2e6" alt=""><figcaption></figcaption></figure>

**Device Source:** Select how you want to connect to the mobile device:

* **Local USB** – Connect a physical mobile device directly to the system using a USB connection.
* **LambdaTest** – Use supported cloud-based mobile devices for remote testing.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FGZuttlZlsyF9t4IprHir%2FScreenshot%202026-09-25%20at%202.05.00%E2%80%AFPM.png?alt=media&amp;token=5a977fe7-3fe4-4320-b7f5-73d3135d7667" alt=""><figcaption></figcaption></figure>

**Device Type:** Select the environment on which you want to record or execute the test:

* **Real** – Use a physical mobile device to validate the application on actual hardware.
* **Emulator** – Use a virtual device that simulates a mobile device environment. Connect and run the emulator for it to become available for testing.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F2BJoFA5wMOpHaHbC44EV%2FScreenshot%202026-09-25%20at%202.05.37%E2%80%AFPM.png?alt=media&amp;token=3572d70c-5462-4bb3-8f73-78f3fc0179f6" alt=""><figcaption></figcaption></figure>

**Device:** After selecting the device source and device type, select the required device from the available devices.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FRlkkoKpNhPc6H7s0sp11%2FScreenshot%202026-09-25%20at%203.49.15%E2%80%AFPM.png?alt=media&amp;token=d9c3add2-ec6a-4e9c-ad75-19d45fb2810c" alt=""><figcaption></figcaption></figure>

If no device is displayed, ensure that the device is connected correctly and the required settings are configured.


# Android Device Registration

Before you can use an Android device for testing in WalnutAI, the device must be registered on the platform. You can register the device manually or by connecting it to your system and registering it directly from the **Devices** page.

### Steps to Register an Android Device

To register an Android device manually:

* Go to **Admin Settings** and select **Devices**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FPQZjUegOynBFKjWW99SO%2FScreenshot%202026-09-09%20at%2011.41.24%E2%80%AFAM.png?alt=media&amp;token=5ed1d6c3-3f3b-43a4-a1a0-6f6480a7ceee" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Make sure that the **Agent** is turned on.
{% endhint %}

* On the **Devices** page, navigate to the **Android** tab.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fpyt0tjC6iQ3kr7qVQpWh%2FScreenshot%202026-09-09%20at%2011.43.08%E2%80%AFAM.png?alt=media&amp;token=3a4cc1f6-7a9a-4302-8340-7687a9f68d87" alt=""><figcaption></figcaption></figure>

* Click **Add Device**, then enter the **Device Name** and **Serial / UDID**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKXbJPGQRyD2FlxHjT5gt%2FScreenshot%202026-09-09%20at%2011.44.45%E2%80%AFAM.png?alt=media&amp;token=4c43ba23-c487-4782-b4ca-0ad75c6028d1" alt=""><figcaption></figcaption></figure>

* Click **Register** to complete the device registration.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F14EXvVLzcDHkOtsRvVMZ%2FScreenshot%202026-09-09%20at%2011.59.11%E2%80%AFAM.png?alt=media&amp;token=cf377254-916b-4d5b-9f03-db6f65bc8c60" alt=""><figcaption></figcaption></figure>

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FHbOZ88NNEKQRL6LLgB2E%2FScreenshot%202026-09-09%20at%2012.00.12%E2%80%AFPM.png?alt=media&amp;token=efcef24c-1c28-49aa-b1db-73b38f30e32b" alt=""><figcaption></figcaption></figure>

* Alternatively, connect the Android device to your system. Once connected, the device will appear on the **Devices** page under the **Android** tab. Select the detected device and click **Register** to complete the registration.


# Android

Once the device is registered, WalnutAI allows you to create automated test cases for Android applications using **AI Recording**. You can describe the required workflow in natural language, and the AI agent performs the actions on the application, captures the flow, and generates the corresponding test steps with parameters.

{% hint style="info" %}
For instructions on registering an Android device, refer to [**Android Device Registration**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/ai-recording/mobile-test-case-creation/android-device-registration)
{% endhint %}

**Steps to Create an Android Test Case Using AI Recording**

* Navigate to the **Intelligence Hub**, select **Smart Recording**, and ensure the **Agent** is turned on.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKv6HboeYjnA9aETgPMoR%2FScreenshot%202026-09-29%20at%206.17.43%E2%80%AFPM.png?alt=media&amp;token=4b6d30b7-b320-4a1c-8b3c-6745023a7148" alt=""><figcaption></figcaption></figure>

* Click the **Web** button in the bottom bar and select **Mobile** as the test type.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FjPNawk35VsrFm1utJrzQ%2FScreenshot%202026-09-25%20at%201.58.23%E2%80%AFPM.png?alt=media&amp;token=14d38f31-fd4d-4d77-9d48-6c590e422405" alt=""><figcaption></figcaption></figure>

* Click the **AI Recording** button in the bottom bar and select the required AI Recording mode.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FcL4wZ6u26jMGNAkGovvY%2FScreenshot%202026-09-25%20at%201.09.09%E2%80%AFPM.png?alt=media&amp;token=dee7f980-ca4e-4a5a-b682-6b5a54c20fa2" alt=""><figcaption></figcaption></figure>

* Click the **Settings** icon in the bottom bar and configure the required settings. Select **Android** as the platform, and configure the **Device Source** and **Device Type**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FQ2NUZ8ldGvhqNRNrrJac%2FScreenshot%202026-09-25%20at%203.14.17%E2%80%AFPM.png?alt=media&amp;token=ea9caced-da9d-42df-86bb-17895c4569a1" alt=""><figcaption></figcaption></figure>

* Once the required settings are configured, the connected device appears under the **Device** section. Select the required device to proceed.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FzcLOzUelg0OzvMX8F5wd%2FScreenshot%202026-09-25%20at%203.14.41%E2%80%AFPM.png?alt=media&amp;token=4ea0151e-a4e7-422b-bfed-c5d2332af67e" alt=""><figcaption></figcaption></figure>

* Under **Application**, select the application you want to test.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F922LGLgel2X55UygKD9L%2FScreenshot%202026-09-25%20at%203.17.40%E2%80%AFPM.png?alt=media&amp;token=c405e272-39f6-421c-bd89-b1f84d950a11" alt=""><figcaption></figcaption></figure>

* If the required application is not available in the application list, you can install it manually:
  * Click **Install APK**.
  * Select **APK** as the application type.
  * Select the required APK file.
  * Install the application.
  * Once the installation is complete, select the application.
* Click **Connect** to establish the connection with the selected application. Once connected, the application opens in the **Live Screen**, allowing the AI agent to interact with it.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FNxsLu74QIVSgyM86g9G4%2FScreenshot%202026-09-25%20at%203.18.52%E2%80%AFPM.png?alt=media&amp;token=63e032cc-6a12-424b-af9b-5e3df01871e7" alt=""><figcaption></figcaption></figure>

* Describe the required workflow in the chat panel using a natural-language prompt. For example: *Log in to the application using valid credentials, place an order using Cash on Delivery (COD), and verify that the order is successfully placed.*

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FUEFmOkpSO7gZp90cFpzi%2FScreenshot%202026-09-25%20at%203.21.15%E2%80%AFPM.png?alt=media&amp;token=04da11fa-aac0-48a7-9803-bbdab8f348cf" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Use the **+** icon to add existing **test cases or custom methods** to the recording session. For more information, refer to [**Insert Test Cases and Custom Methods**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/ai-recording/insert-test-cases-and-custom-methods)
{% endhint %}

* Click **Send**. The AI agent processes the instructions and performs the requested actions on the Android application. WalnutAI generates the corresponding test steps and parameters, while the actions are displayed on the **Live Screen**.
* Once the test case is generated, review and customize the test steps as required. You can **edit request details, modify parameters, skip a step, enable Continue on Failure, add a new step, add a nested test case, cancel a step, or** [**debug the test case**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/debug-a-test-case-in-smart-recording)

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FeGbCt55ug6DAWft4UlTK%2FScreenshot%202026-08-12%20at%204.19.51%E2%80%AFPM.png?alt=media&amp;token=477761a4-6c63-4b6a-823d-bec581670fba" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For detailed information on modifying individual test steps, refer to [**Manage a Test Step**.](/test-and-quality-management/test-management/test-cases/manage-test-step)
{% endhint %}

* On the Parameters tab, click **Chat with AI** to generate test data for the generated test case.
* You can execute test cases and heal failed test steps directly through the chat panel.
* Once you have completed the required modifications, click **Disconnect** to end the recording session. Then, click **Save** to save the generated Android test case and its corresponding steps.


# iOS Account Setup and Device Registration

To create and run tests on an iOS device, you must configure your iOS account and register the device in WalnutAI. This process involves setting up the required Apple Developer signing certificates and provisioning profile, registering the iOS device, and installing WebDriverAgent (WDA) on the device.

**iOS Account Setup**

* Go to **Admin Settings** and select **Devices**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F82pv7Dwh37I8WCze7327%2FScreenshot%202026-09-07%20at%205.52.10%E2%80%AFPM.png?alt=media&amp;token=a07d0b96-4af1-44c9-83ea-8fa20ec3f2a7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Make sure that the **Agent** is turned on.
{% endhint %}

* Navigate to **iOS Account Setup** and click **Open Setup Wizard**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FYP8zIbiLHrVknkLRLfXz%2FScreenshot%202026-09-07%20at%205.53.20%E2%80%AFPM.png?alt=media&amp;token=47c19c10-4171-41e4-9e24-1f6ec5944396" alt=""><figcaption></figcaption></figure>

**The setup wizard includes the following steps:**

* **Pre-Requisites:** Enter the **Apple ID email address** associated with your Apple Developer account. WalnutAI uses this email address to associate the signing certificate generated during the setup process.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FVvUtbfJTltDgP826Ngy6%2FScreenshot%202026-09-07%20at%205.54.03%E2%80%AFPM.png?alt=media&amp;token=7de078cb-9174-45aa-a65f-bb2b3e97a8fb" alt=""><figcaption></figcaption></figure>

* **Certificate Signing Request (CSR):** Click **Generate and Download** to generate and download the **Certificate Signing Request (CSR)**, then click **Next**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FDV8aHIiG08605RQhaLG8%2FScreenshot%202026-09-07%20at%205.54.48%E2%80%AFPM.png?alt=media&amp;token=fb85e903-093b-4dd2-9334-84abc0a33e90" alt=""><figcaption></figcaption></figure>

* **Upload Certificate:** Click **Choose File** and upload the generated `.cer` certificate. Then, click **Upload Certificate** and select **Next**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FJHfvsARZK04PmK58EYFx%2FScreenshot%202026-09-07%20at%205.58.18%E2%80%AFPM.png?alt=media&amp;token=7e07cd98-0b2f-4b3f-b02e-d04309a85e7c" alt=""><figcaption></figcaption></figure>

* **Provisioning Certificate:** Click **Choose File** and upload the required provisioning profile (`.mobileprovision`) file. Then, click **Upload File** and select **Finish**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FLzzr3X9Fyo78cuwhiYhH%2FScreenshot%202026-09-07%20at%205.59.46%E2%80%AFPM.png?alt=media&amp;token=66689048-fba2-41c6-a13f-ff434c8531d5" alt=""><figcaption></figcaption></figure>

* Once the setup is completed successfully, the **Provisioning Profile Certificate** is displayed along with the list of **Provisioned Devices**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FpscyB6EDpcedAI0h7xwc%2FScreenshot%202026-09-07%20at%206.01.01%E2%80%AFPM.png?alt=media&amp;token=fcbc4431-39de-42a7-9dc9-cfbf28bcd89e" alt=""><figcaption></figcaption></figure>

**Steps to Register the iOS Device**

After completing the iOS account setup, you can register your iOS device and install WebDriverAgent (WDA) to enable device connectivity and testing in WalnutAI.

* Connect your iOS device to your machine.
* Once connected, the device appears under the **iOS Devices** section.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FZMnSIZNg8xUQRKxJJy00%2FScreenshot%202026-09-07%20at%206.03.44%E2%80%AFPM.png?alt=media&amp;token=73951abf-defe-48e0-a197-328ad5c1929e" alt=""><figcaption></figcaption></figure>

* Click **Register** to register the device. Once the device is registered, click **Ready to Install WDA**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F1e5obl4II0iLggZtDxn7%2FScreenshot%202026-09-07%20at%206.05.18%E2%80%AFPM.png?alt=media&amp;token=f78e9f70-87e9-46a6-8042-142ef102fd97" alt=""><figcaption></figcaption></figure>

* This installs the **WebDriverAgent application** on the connected iOS device.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FgslViV8q3llQEmh8re8B%2FScreenshot%202026-09-07%20at%206.07.27%E2%80%AFPM.png?alt=media&amp;token=8e148ce4-f0fe-45bb-84c0-431513b54825" alt=""><figcaption></figcaption></figure>

* You can click **Remove** to remove a registered device when it is no longer required.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fy5U8UsutZqs7OoBbfMC4%2FScreenshot%202026-09-07%20at%206.08.16%E2%80%AFPM.png?alt=media&amp;token=c6197058-9a5f-489f-84e3-e43fdaccfb74" alt=""><figcaption></figcaption></figure>


# iOS

Once the device is registered, WalnutAI allows you to create automated test cases for iOS applications using **AI Recording**.&#x20;

You can describe the required test workflow in natural language, and the AI agent interacts with the connected iOS application to perform the requested actions. WalnutAI then automatically generates the corresponding test steps and parameters based on the recorded workflow.

{% hint style="info" %}
For instructions on registering an iOS device, refer to the[ **iOS Account Setup and Device Registration.**](/core-features/intelligence-hub/generate-test-cases/smart-recording/ai-recording/mobile-test-case-creation/ios-account-setup-and-device-registration)
{% endhint %}

**Steps to Create an iOS Test Case Using AI Recording**

* Navigate to the **Intelligence Hub**, select **Smart Recording**, and ensure the **Agent** is turned on.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKv6HboeYjnA9aETgPMoR%2FScreenshot%202026-09-29%20at%206.17.43%E2%80%AFPM.png?alt=media&amp;token=4b6d30b7-b320-4a1c-8b3c-6745023a7148" alt=""><figcaption></figcaption></figure>

* Click the **Web** button in the bottom bar and select **Mobile** as the test type.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FjPNawk35VsrFm1utJrzQ%2FScreenshot%202026-09-25%20at%201.58.23%E2%80%AFPM.png?alt=media&amp;token=14d38f31-fd4d-4d77-9d48-6c590e422405" alt=""><figcaption></figcaption></figure>

* Click the **AI Recording** button in the bottom bar and select the required AI Recording mode.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FcL4wZ6u26jMGNAkGovvY%2FScreenshot%202026-09-25%20at%201.09.09%E2%80%AFPM.png?alt=media&amp;token=dee7f980-ca4e-4a5a-b682-6b5a54c20fa2" alt=""><figcaption></figcaption></figure>

* Click the **Settings** icon in the bottom bar and configure the required settings. Select **iOS** as the platform, and configure the **Device Source** and **Device Type**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FPjXSx75uj7Bggj61ySUH%2FScreenshot%202026-09-25%20at%203.29.29%E2%80%AFPM.png?alt=media&amp;token=8373d713-dc22-441a-b2be-c9f1a7827c0f" alt=""><figcaption></figcaption></figure>

* Once the required settings are configured, the connected iOS device appears under the **Device** section. Select the required device to proceed.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FQToXbj3oTbcs6FHhx95M%2FScreenshot%202026-09-25%20at%203.30.48%E2%80%AFPM.png?alt=media&amp;token=dda9845d-d33c-47c6-8e61-ce08cdba1ec0" alt=""><figcaption></figcaption></figure>

* Under **Application**, select the application you want to test.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FFmWdN3emvFNFus8tAwJU%2FScreenshot%202026-09-25%20at%203.32.00%E2%80%AFPM.png?alt=media&amp;token=45804a8d-249e-4ded-a99e-40885042188b" alt=""><figcaption></figcaption></figure>

* If the required application is not available in the application list, you can install it manually:
  * Click **Install IPA**.
  * Select the required iOS application file.
  * Install the application.
  * Once the installation is complete, select the application from the **Application** list.
* Click **Connect** to establish the connection with the selected application. Once connected, the application opens in the **Live Screen**, allowing the AI agent to interact with it.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKmS4Zq2yF6ZTk6rkTG1e%2FScreenshot%202026-10-08%20at%204.55.18%E2%80%AFPM.png?alt=media&amp;token=51849a45-9400-4c36-8b87-e2a445bfe18c" alt=""><figcaption></figcaption></figure>

* Describe the required workflow in the chat panel using a natural-language prompt and click **Send**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fn2Kxik17Gq4Kx7e4yRq9%2FScreenshot%202026-10-08%20at%204.54.13%E2%80%AFPM.png?alt=media&amp;token=8f1fb366-e7df-4874-85ff-e0ff939387f4" alt=""><figcaption></figcaption></figure>

* The AI agent processes the instructions and performs the requested actions on the iOS application. WalnutAI generates the corresponding test steps and parameters, while the actions performed by the AI agent are displayed on the **Live Screen**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FcVpJk2dfLMEjiOgiI9O7%2FScreenshot%202026-10-08%20at%204.22.29%E2%80%AFPM.png?alt=media&amp;token=e29f14af-23be-4832-aa2d-ebe06dc2ed84" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Use the **+** icon to add existing **test cases or custom methods** to the recording session. For more information, refer to [**Insert Test Cases and Custom Methods**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/ai-recording/insert-test-cases-and-custom-methods)
{% endhint %}

* Once the test case is generated, review and customize the test steps as required. You can **edit request details, modify parameters, skip a step, enable Continue on Failure, add a new step, add a nested test case, cancel a step, or** [**debug the test case**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/debug-a-test-case-in-smart-recording)

{% hint style="info" %}
For detailed information on modifying individual test steps, refer to [**Manage a Test Step**.](/test-and-quality-management/test-management/test-cases/manage-test-step)
{% endhint %}

* On the Parameters tab, click **Chat with AI** to generate test data for the generated test case.
* You can execute test cases and heal failed test steps directly through the chat panel.
* Once you have completed the required modifications, click **Disconnect** to end the recording session.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FNoE2cImto43NSbgzoa84%2FScreenshot%202026-10-08%20at%204.23.39%E2%80%AFPM.png?alt=media&amp;token=bfa0faee-5fd8-4335-9e37-799fb358f669" alt=""><figcaption></figcaption></figure>

* Click **Save** to save the generated iOS test case along with its corresponding test steps.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F9qvey7RnsOUU6v2Bwado%2FScreenshot%202026-10-08%20at%204.24.59%E2%80%AFPM.png?alt=media&amp;token=9b392cb2-d11e-43c1-9f18-3588681638de" alt=""><figcaption></figcaption></figure>


# SAP Test Case Creation

SAP (Systems, Applications, and Products) is an enterprise software platform used by organizations to manage and integrate core business processes such as **finance, sales, procurement, inventory, human resources, and supply chain operations**.

Testing SAP applications is important to ensure that these business processes work correctly and consistently across different scenarios. **WalnutAI’s SAP AI Recording** simplifies SAP test automation by allowing users to describe a business flow in natural language. The AI agent interacts with the SAP application based on the provided instructions and automatically generates the corresponding automated test steps, reducing the effort required to create and maintain SAP test cases.

**Steps to Generate an SAP Test Case:**

* Navigate to the **Intelligence Hub**, select **Smart Recording**, and ensure the **Agent** is turned on.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKv6HboeYjnA9aETgPMoR%2FScreenshot%202026-09-29%20at%206.17.43%E2%80%AFPM.png?alt=media&amp;token=4b6d30b7-b320-4a1c-8b3c-6745023a7148" alt=""><figcaption></figcaption></figure>

* Click the **AI Recording** button in the **bottom bar** and select the suitable **AI Recording** mode.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FcL4wZ6u26jMGNAkGovvY%2FScreenshot%202026-09-25%20at%201.09.09%E2%80%AFPM.png?alt=media&amp;token=dee7f980-ca4e-4a5a-b682-6b5a54c20fa2" alt=""><figcaption></figcaption></figure>

* Click the **Web** button in the bottom bar and select **SAP** as the test type.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F80Fp82LDsdpZp08rcA92%2FScreenshot%202026-09-29%20at%206.53.19%E2%80%AFPM.png?alt=media&amp;token=98621e98-770a-44be-873e-c90e9a9522e2" alt=""><figcaption></figcaption></figure>

* On the above bar, enter the **SAP Connection Name** into the connection field in WalnutAI, then click **Connect**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FIyIBRyTS0q116PJKt2ZT%2FScreenshot%202026-09-29%20at%206.56.22%E2%80%AFPM.png?alt=media&amp;token=5b6f76a9-0aba-4275-95e3-8659c1e2f908" alt=""><figcaption></figcaption></figure>

* Once the SAP connection is established, describe the required business flow in the **AI Recording prompt** using natural language.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FoBvFaqPvksi10Gi2sJgZ%2FScreenshot%202026-09-29%20at%207.00.00%E2%80%AFPM.png?alt=media&amp;token=d1d1c9b5-ec00-4259-a64d-cce2afdfe1e1" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Use the **+** icon to add existing **test cases or custom methods** to the recording session. For more information, refer to [**Insert Test Cases and Custom Methods**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/ai-recording/insert-test-cases-and-custom-methods)
{% endhint %}

* Click **Send**. The AI agent processes the instructions, performs the required actions, and generates the corresponding test steps.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fw8Ant2PaoVfg7Xn9f2CI%2FScreenshot%202026-09-29%20at%207.01.14%E2%80%AFPM.png?alt=media&amp;token=afe09a06-b162-4411-85d6-c7ee3f0e434b" alt=""><figcaption></figcaption></figure>

* Once the test case is generated, review and customize the steps as required. You can **edit objects, skip a step, enable Continue on Failure, add a new step, add a nested test case, cancel a step, or**  [**debug the test case**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/debug-a-test-case-in-smart-recording)

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FHJqFxwl2f8KW8lUAVlKG%2FScreenshot%202026-09-29%20at%207.02.21%E2%80%AFPM.png?alt=media&amp;token=a99a4625-1a66-47c3-ab0d-8761f8859e83" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For detailed information on modifying individual test steps, refer to  [**Manage a Test Step**.](/test-and-quality-management/test-management/test-cases/manage-test-step)
{% endhint %}

* On the Parameters tab, click **Chat with AI** to generate test data for the generated test case.
* You can execute test cases and heal failed test steps directly through the chat panel.
* Once you have completed the required modifications, click **Disconnect** to end the session, and then click **Save** to save the generated test case.


# Desktop Test Case Creation

Creating a desktop test case in WalnutAI allows you to automate desktop application workflows using **AI Recording**. Instead of manually identifying and configuring UI objects, WalnutAI intelligently captures the actions performed on the desktop application and converts them into automated test steps.

#### Steps to Generate a Desktop Test Case

* Navigate to the **Intelligence Hub**, select **Smart Recording**, and ensure the **Agent** is turned on.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKv6HboeYjnA9aETgPMoR%2FScreenshot%202026-09-29%20at%206.17.43%E2%80%AFPM.png?alt=media&amp;token=4b6d30b7-b320-4a1c-8b3c-6745023a7148" alt=""><figcaption></figcaption></figure>

* Click the **AI Recording** button in the **bottom bar** and select the suitable **AI Recording** mode.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FcL4wZ6u26jMGNAkGovvY%2FScreenshot%202026-09-25%20at%201.09.09%E2%80%AFPM.png?alt=media&amp;token=dee7f980-ca4e-4a5a-b682-6b5a54c20fa2" alt=""><figcaption></figcaption></figure>

* Click the **Web** button in the bottom bar and select **Desktop** as the test type.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FIMvaJ4iMth3YPqGz302l%2FScreenshot%202026-10-09%20at%2011.48.00%E2%80%AFAM.png?alt=media&amp;token=9b43e7f7-f2b7-460e-bdc8-1aec141a89ad" alt=""><figcaption></figcaption></figure>

* In the **Application Path** field, select the desktop application you want to automate. You can either:
  * Select an application from the **Supported Apps** dropdown.
  * Manually enter the application's executable path.&#x20;

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FHdfWWkQJTNhpLPQDa0nI%2FScreenshot%202026-10-09%20at%2011.49.23%E2%80%AFAM.png?alt=media&amp;token=84cbcabf-4411-40fd-b197-fde8be48d262" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
To find the path, open **Task Manager**, locate the required application, right-click it, and select **Properties**. Under the **Security** tab, copy the application path and paste it into the **Application Path** field in WalnutAI.
{% endhint %}

* Click the **Settings** icon and then click **Connect** to launch the selected desktop application.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FxQOqnJIQ46JYRRJcT693%2FScreenshot%202026-10-09%20at%2011.53.58%E2%80%AFAM.png?alt=media&amp;token=43176819-459e-448c-8b86-ed892637d7ac" alt=""><figcaption></figcaption></figure>

* Describe the workflow you want to automate in the **chat panel**. For example: "*Click on the last opened database and create a current account named QA Current with an initial balance of 10,000. Verify that the account is created successfully, then delete the newly created account."*

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FIY3qRAoA512et6D1cDrt%2FScreenshot%202026-10-09%20at%2012.18.39%E2%80%AFPM.png?alt=media&amp;token=7351ee53-9077-4a08-91db-fe38d9faf06d" alt=""><figcaption></figcaption></figure>

* Click **Send**. The AI agent processes your instructions, performs the required actions on the desktop application, and generates the corresponding test steps.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F6U1X4PoKQwcRDdWpAnsP%2FScreenshot%202026-10-09%20at%2012.12.18%E2%80%AFPM.png?alt=media&amp;token=3da19226-2aa6-4665-a6e8-dcf08cba8f45" alt=""><figcaption></figcaption></figure>

* Once the test case is generated, review and customize the steps as required. You can **edit objects, skip a step, enable Continue on Failure, add a new step, add a nested test case, cancel a step, or**  [**debug the test case**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/debug-a-test-case-in-smart-recording)

{% hint style="info" %}
For detailed information on modifying individual test steps, refer to  [**Manage a Test Step**.](/test-and-quality-management/test-management/test-cases/manage-test-step)
{% endhint %}

* On the Parameters tab, click **Chat with AI** to generate test data for the generated test case.
* You can execute test cases and heal failed test steps directly through the chat panel.
* Once you have completed the required modifications, click **Disconnect** to end the session and then click **Save** to save the generated test case.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F8bDXgX9AZZflmguToaxb%2FScreenshot%202026-10-09%20at%2012.16.12%E2%80%AFPM.png?alt=media&amp;token=b7aef7a6-7465-4777-ab7b-0c1b7571b4f6" alt=""><figcaption></figcaption></figure>


# Insert Test Cases and Custom Methods

Smart Recording allows you to **reuse existing test cases and custom methods** within the current recording session. Instead of recreating workflows or actions that are already available, you can insert them directly into your recording at the required point.

This helps you **reuse existing automation, reduce duplicate steps, maintain consistency across test cases, and build complex test flows more efficiently**.

* Start a **Smart Recording** session.
* Click the **+** icon in the bottom bar. The **Insert test case** window opens with two tabs:
  * **Test cases:** Displays the test cases available in the current project.
  * **Custom methods:** Displays the custom methods available in the current project.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FVReP9HZapDEUIPOgOG5M%2FScreenshot%202026-09-25%20at%205.35.46%E2%80%AFPM.png?alt=media&amp;token=c5c9aa67-7b40-434d-8d6b-f9b65e44f80f" alt=""><figcaption></figcaption></figure>

* Select the required tab, choose the **test case or custom method** you want to reuse, and select the required **Environment** in which it should be executed.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F8SY1ZYMAbGW47YkNyOUe%2FScreenshot%202026-09-25%20at%205.38.07%E2%80%AFPM.png?alt=media&amp;token=42efe2b3-e5de-4bc1-baa6-ea3a5aaedd7a" alt=""><figcaption></figcaption></figure>

* Select where you want to insert the **test case or custom method** in the current recording session:

  * **End of recording:** Adds the test case or custom method at the end of the recording.
  * **Start (after the opening Navigate):** Adds it after the opening Navigate step.
  * **Before the opening Navigate (first step):** Adds it before the opening Navigate step.
  * If the recording already contains steps, the available insertion points are displayed based on the existing steps. Select the required location.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FcUVys37AVo85sfnmy1nu%2FScreenshot%202026-09-25%20at%205.47.07%E2%80%AFPM.png?alt=media&amp;token=1c43c904-c4f4-41de-a2d2-d0e721cd999a" alt=""><figcaption></figcaption></figure>

* Enable **Run it now using its own test data, so recording continues from where it leaves the app** if you want the selected test case to execute immediately after insertion.&#x20;

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F3Tzhq0qHTyORI7TieyEf%2FScreenshot%202026-09-25%20at%205.41.10%E2%80%AFPM.png?alt=media&amp;token=08417f78-979d-4f56-b08f-8a38f157b12f" alt=""><figcaption></figcaption></figure>

* If the option is not enabled, the selected **test case or custom method** is added to the recording without being executed immediately. You can then choose how to proceed from the chat panel:

  * **Run it now:** Executes the reused test case in the current browser session.
  * **Leave it as a block:** Adds the test case to the recording without executing it.
  * **Run everything from the start:** Clears the current session and replays the entire recording from the beginning, including recorded steps and inserted blocks.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F9a57VzGaqXFAOyNlQfQg%2FScreenshot%202026-09-25%20at%205.44.21%E2%80%AFPM.png?alt=media&amp;token=c94003e3-86cf-4eed-9152-04dad2a1d2c0" alt=""><figcaption></figcaption></figure>

* The selected **test case or custom method** is added to the recording at the specified location, allowing you to reuse existing automation as part of the current test flow.


# Manual Recording

**Manual Recording** in WalnutAI allows you to create automated test cases by manually interacting with the application. As you perform actions within the application, WalnutAI captures the interactions and converts them into structured test steps.

To use Manual Recording, configure the required options based on your application and testing requirements.

* Click the **AI Recording** button in the bottom bar and select **Manual Recording**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FXCXvGuoksu2dRWDDQ2Ro%2FScreenshot%202026-09-25%20at%203.37.21%E2%80%AFPM.png?alt=media&amp;token=3a30e280-10eb-4c66-b01a-5eb625b2994c" alt=""><figcaption></figcaption></figure>

* Click the **Web** button in the bottom bar and select the test type you want to automate. Manual Recording supports **Web, API, Mobile, Mainframe, and SAP** applications.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F5Kpa0SFykEZbdXQeL00P%2FScreenshot%202026-09-25%20at%2012.16.45%E2%80%AFPM.png?alt=media&amp;token=9ded7bcd-1e98-4795-9319-1689ca0acc57" alt=""><figcaption></figcaption></figure>

* Click the **Settings** icon in the bottom bar and configure the required settings.
  * **Reuse Session:** Enable **Reuse Session** to reuse an existing application session, including previously captured cookies. This is useful for applications that require authentication, such as **MFA**, and helps avoid repeating the authentication process during subsequent recordings.
  * For **Web** applications, select the browser in which you want to perform the recording. Available options include **Chrome, Microsoft Edge, Firefox, and WebKit**.
  * Enter the application URL and click **Connect**. Once connected, the application opens in a **separate browser window**, where you can perform the required actions.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FhIRgFvjWLgbEODNhIF7i%2FScreenshot%202026-09-25%20at%203.41.16%E2%80%AFPM.png?alt=media&amp;token=c7a94447-310e-4391-8306-4b05ff4097eb" alt=""><figcaption></figcaption></figure>

* Perform the required actions in the application. WalnutAI captures your interactions and converts them into the corresponding automated test steps.
* On the Parameters tab, click Chat with AI to generate test data for the generated test case.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FPeUv8mFjAMdWqtGyHTRj%2FScreenshot%202026-10-16%20at%203.19.06%E2%80%AFPM.png?alt=media&amp;token=13ac8d78-71d4-47b1-897d-01d09b0f8fad" alt=""><figcaption></figcaption></figure>

* You can execute test cases and heal failed test steps directly through the chat panel.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FYliCdiWXPQNBKrs3U6PC%2FScreenshot%202026-10-16%20at%203.24.07%E2%80%AFPM.png?alt=media&amp;token=737a0537-62e1-4fe1-bd38-5f726caf2a32" alt=""><figcaption></figcaption></figure>


# Web Test Case Creation

**Manual Recording** in WalnutAI allows you to create automated test cases by manually interacting with a web application. As you perform the required workflow, WalnutAI captures your actions and converts them into structured automated test steps.

**Steps to Generate a Web Test Case**

* Navigate to the **Intelligence Hub**, select **Smart Recording**, and ensure the **Agent** is turned on.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKv6HboeYjnA9aETgPMoR%2FScreenshot%202026-09-29%20at%206.17.43%E2%80%AFPM.png?alt=media&amp;token=4b6d30b7-b320-4a1c-8b3c-6745023a7148" alt=""><figcaption></figcaption></figure>

* Click the **AI Recording** button in the bottom bar and select **Manual Recording**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FXCXvGuoksu2dRWDDQ2Ro%2FScreenshot%202026-09-25%20at%203.37.21%E2%80%AFPM.png?alt=media&amp;token=3a30e280-10eb-4c66-b01a-5eb625b2994c" alt=""><figcaption></figcaption></figure>

* Click the **Web** button in the bottom bar and select **Web** as the test type.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FBld04OcvNkOcwb0r39Mv%2FScreenshot%202026-09-25%20at%201.10.03%E2%80%AFPM.png?alt=media&amp;token=9b69d8d7-7813-49d4-b386-90980dfac92a" alt=""><figcaption></figcaption></figure>

* Click the **Settings** icon in the bottom bar and configure the required recording settings. Select the preferred **browser** and enable **Reuse Session** if required.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F11UgZtjuByB5VJIh7FYt%2FScreenshot%202026-09-25%20at%203.54.44%E2%80%AFPM.png?alt=media&amp;token=49085082-936b-457a-bea0-c1c6da61daa3" alt=""><figcaption></figcaption></figure>

* Enter the application **URL** and click **Connect**. Once connected, the application opens in a **separate browser window**, where you can perform the required actions manually.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FMSKD9v9TkoIwaad007st%2FScreenshot%202026-09-25%20at%201.45.45%E2%80%AFPM.png?alt=media&amp;token=87c9f6ba-2c88-49b4-b1a1-e2273e39bee9" alt=""><figcaption></figcaption></figure>

* As you interact with the application, WalnutAI captures your actions and generates the corresponding **test steps and parameters**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fj3WHe4LQrsDamfFbp8SE%2FScreenshot%202026-09-25%20at%203.56.17%E2%80%AFPM.png?alt=media&amp;token=19f8b713-1778-4d26-b454-fb62c037f1c7" alt=""><figcaption></figcaption></figure>

* Once the recording is complete, review and customize the generated steps as required. You can **edit objects, skip a step, enable Continue on Failure, add a new step, add a nested test case, cancel a step, or** [**debug the test case**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/debug-a-test-case-in-smart-recording)

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F3FX6X5kc6lYicwkxdABn%2FScreenshot%202026-08-10%20at%2011.58.18%E2%80%AFPM.png?alt=media&amp;token=38a63d5c-9a54-49cb-9504-8d588df79a29" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For detailed information on modifying individual test steps, refer to  [**Manage a Test Step**.](/test-and-quality-management/test-management/test-cases/manage-test-step)
{% endhint %}

* On the Parameters tab, click **Chat with AI** to generate test data for the generated test case.
* You can execute test cases and heal failed test steps directly through the chat panel.
* Once you have completed the required modifications, click **Disconnect** to end the recording session. Then, click **Save** to save the generated test case.


# Mobile Test Case Creation

WalnutAI enables you to create and automate test cases for **Android** and **iOS** applications. Mobile test cases can be created using **AI Recording** or **Manual Recording** and can be recorded and executed on **real devices** or **emulators/simulators**.

Click the **Web** button in the bottom bar and select **Mobile** as the test type before starting the recording.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FjPNawk35VsrFm1utJrzQ%2FScreenshot%202026-09-25%20at%201.58.23%E2%80%AFPM.png?alt=media&amp;token=14d38f31-fd4d-4d77-9d48-6c590e422405" alt=""><figcaption></figcaption></figure>

**Recording Mode:** WalnutAI provides two AI Recording modes for mobile testing:

* **AI Recording:** Generates test steps based on the instructions provided through prompts. The AI agent interacts with you during the process and can ask questions or request additional input or clarification whenever required.
* **AI Recording · Auto:** Follows an AI-driven approach where the agent independently explores the application and performs the required actions based on the provided instructions, without interacting with you or pausing to ask questions during the process.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FfkL0nk7a6rxN11qhayGk%2FScreenshot%202026-09-25%20at%2012.15.35%E2%80%AFPM.png?alt=media&amp;token=a900bd90-34db-4279-806d-8f02c3c8a1e9" alt=""><figcaption></figcaption></figure>

Click the **Settings** icon in the bottom bar and configure the required recording settings:

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F21UYIbEOqyGoSVneYOff%2FScreenshot%202026-09-25%20at%202.07.52%E2%80%AFPM.png?alt=media&amp;token=f7904f58-3e54-4796-854d-4f7122e7ea51" alt=""><figcaption></figcaption></figure>

**Platform:** Select the mobile platform based on the application you want to test:

* **Android** – Used to create and execute test cases for Android applications.
* **iOS** – Used to create and execute test cases for iOS applications.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FOqwiDOvgubrjRbhWC63t%2FScreenshot%202026-09-25%20at%202.04.12%E2%80%AFPM.png?alt=media&amp;token=dbd745b3-8107-49d3-ada3-ca2b3c13b2e6" alt=""><figcaption></figcaption></figure>

**Device Source:** Select how you want to connect to the mobile device:

* **Local USB** – Connect a physical mobile device directly to the system using a USB connection.
* **LambdaTest** – Use supported cloud-based mobile devices for remote testing.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FGZuttlZlsyF9t4IprHir%2FScreenshot%202026-09-25%20at%202.05.00%E2%80%AFPM.png?alt=media&amp;token=5a977fe7-3fe4-4320-b7f5-73d3135d7667" alt=""><figcaption></figcaption></figure>

**Device Type:** Select the environment on which you want to record or execute the test:

* **Real** – Use a physical mobile device to validate the application on actual hardware.
* **Emulator** – Use a virtual device that simulates a mobile device environment. Connect and run the emulator for it to become available for testing.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F2BJoFA5wMOpHaHbC44EV%2FScreenshot%202026-09-25%20at%202.05.37%E2%80%AFPM.png?alt=media&amp;token=3572d70c-5462-4bb3-8f73-78f3fc0179f6" alt=""><figcaption></figcaption></figure>

**Device:** After selecting the device source and device type, select the required device from the available devices.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FRlkkoKpNhPc6H7s0sp11%2FScreenshot%202026-09-25%20at%203.49.15%E2%80%AFPM.png?alt=media&amp;token=d9c3add2-ec6a-4e9c-ad75-19d45fb2810c" alt=""><figcaption></figcaption></figure>

If no device is displayed, ensure that the device is connected correctly and the required settings are configured.


# Android

Once the device is registered, WalnutAI allows you to create automated test cases for Android applications using **Manual Recording**. You can manually interact with the application in the **Live Screen**, while WalnutAI captures the actions performed and generates the corresponding test steps and parameters.

{% hint style="info" %}
For instructions on registering an Android device, refer to [**Android Device Registration**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/ai-recording/mobile-test-case-creation/android-device-registration)
{% endhint %}

**Steps to Create an Android Test Case Using Manual Recording**

* Navigate to the **Intelligence Hub**, select **Smart Recording**, and ensure the **Agent** is turned on.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKv6HboeYjnA9aETgPMoR%2FScreenshot%202026-09-29%20at%206.17.43%E2%80%AFPM.png?alt=media&amp;token=4b6d30b7-b320-4a1c-8b3c-6745023a7148" alt=""><figcaption></figcaption></figure>

* Click the **AI Recording** button in the bottom bar and select **Manual Recording**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FXCXvGuoksu2dRWDDQ2Ro%2FScreenshot%202026-09-25%20at%203.37.21%E2%80%AFPM.png?alt=media&amp;token=3a30e280-10eb-4c66-b01a-5eb625b2994c" alt=""><figcaption></figcaption></figure>

* Click the **Web** button in the bottom bar and select **Mobile** as the test type.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKanl5PeJB5p04CFphfJG%2FScreenshot%202026-09-25%20at%204.01.08%E2%80%AFPM.png?alt=media&amp;token=8c42e5dd-ca8b-44d9-95d2-73c0d207ea39" alt=""><figcaption></figcaption></figure>

* Click the **Settings** icon in the bottom bar and configure the required recording settings. Select **Android** as the platform, and configure the **Device Source** and **Device Type**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FLEE8XeINfuvp8PexuUbF%2FScreenshot%202026-09-25%20at%204.02.45%E2%80%AFPM.png?alt=media&amp;token=c62dd121-2a9b-4f0b-aec0-93e525577e5f" alt=""><figcaption></figcaption></figure>

* Once the required settings are configured, the connected device appears under the **Device** section. Select the required device to proceed.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FRlkkoKpNhPc6H7s0sp11%2FScreenshot%202026-09-25%20at%203.49.15%E2%80%AFPM.png?alt=media&amp;token=d9c3add2-ec6a-4e9c-ad75-19d45fb2810c" alt=""><figcaption></figcaption></figure>

* Under **Application**, select the application you want to test.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FOJDEAGsqLoWmnYV6vjf7%2FScreenshot%202026-09-25%20at%204.03.55%E2%80%AFPM.png?alt=media&amp;token=46012d02-a93d-4d0b-9064-d702f16e9b5b" alt=""><figcaption></figcaption></figure>

* If the required application is not available in the application list, you can install it manually:
  * Click **Install APK**.
  * Select **APK** as the application type.
  * Select the required APK file.
  * Install the application.
  * Once the installation is complete, select the application.
* Click **Connect** to establish the connection with the selected application. Once connected, the application opens in the **Live Screen**, where you can manually perform the required actions.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FXt7HODgNsnUazbIn45wU%2FScreenshot%202026-09-25%20at%204.10.58%E2%80%AFPM.png?alt=media&amp;token=e1e27fb0-bbb6-4585-8d06-53f8d767af32" alt=""><figcaption></figcaption></figure>

* Perform the required workflow on the Android application using the **Live Screen**. For example, log in using valid credentials, place an order using Cash on Delivery (COD), and verify that the order is successfully placed.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FQyLavBSbrSW2r2dnbhut%2FScreenshot%202026-08-13%20at%2012.51.38%E2%80%AFPM.png?alt=media&amp;token=cf084a07-0be0-4218-a311-cc6ffd47b756" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Double-click** the required field to view the list of available actions.
{% endhint %}

* WalnutAI captures the actions performed during the recording and generates the corresponding **test steps and parameters**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FeGbCt55ug6DAWft4UlTK%2FScreenshot%202026-08-12%20at%204.19.51%E2%80%AFPM.png?alt=media&amp;token=477761a4-6c63-4b6a-823d-bec581670fba" alt=""><figcaption></figcaption></figure>

* Once the test case is generated, review and customize the test steps as required. You can **edit request details, modify parameters, skip a step, enable Continue on Failure, add a new step, add a nested test case, cancel a step, or** [**debug the test case**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/debug-a-test-case-in-smart-recording)

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FrLTCUVNxbDl6BH9cqHwi%2FScreenshot%202026-08-12%20at%204.24.00%E2%80%AFPM.png?alt=media&amp;token=977e9869-d823-4837-8458-60a23e56917f" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For detailed information on modifying individual test steps, refer to  [**Manage a Test Step**.](/test-and-quality-management/test-management/test-cases/manage-test-step)
{% endhint %}

* On the Parameters tab, click **Chat with AI** to generate test data for the generated test case.
* You can execute test cases and heal failed test steps directly through the chat panel.
* Once you have completed the required modifications, click **Disconnect** to end the recording session. Then, click **Save** to save the generated Android test case along with its corresponding steps and parameters.


# iOS

Once the device is registered, WalnutAI allows you to create automated test cases for iOS applications using **Manual Recording**.&#x20;

You can manually perform the required actions on the connected iOS application, and WalnutAI captures the interactions and automatically generates the corresponding test steps and parameters based on the recorded workflow.

{% hint style="info" %}
For instructions on registering an iOS device, refer to the[ **iOS Account Setup and Device Registration.**](/core-features/intelligence-hub/generate-test-cases/smart-recording/ai-recording/mobile-test-case-creation/ios-account-setup-and-device-registration)
{% endhint %}

**Steps to Create an iOS Test Case Using Manual Recording**

* Navigate to the **Intelligence Hub**, select **Smart Recording**, and ensure the **Agent** is turned on.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKv6HboeYjnA9aETgPMoR%2FScreenshot%202026-09-29%20at%206.17.43%E2%80%AFPM.png?alt=media&amp;token=4b6d30b7-b320-4a1c-8b3c-6745023a7148" alt=""><figcaption></figcaption></figure>

* Click the **AI Recording** button in the bottom bar and select **Manual Recording**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FXCXvGuoksu2dRWDDQ2Ro%2FScreenshot%202026-09-25%20at%203.37.21%E2%80%AFPM.png?alt=media&amp;token=3a30e280-10eb-4c66-b01a-5eb625b2994c" alt=""><figcaption></figcaption></figure>

* Click the **Web** button in the bottom bar and select **Mobile** as the application type.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKanl5PeJB5p04CFphfJG%2FScreenshot%202026-09-25%20at%204.01.08%E2%80%AFPM.png?alt=media&amp;token=8c42e5dd-ca8b-44d9-95d2-73c0d207ea39" alt=""><figcaption></figcaption></figure>

* Click the **Settings** icon in the bottom bar and configure the required settings. Select **iOS** as the platform, and configure the **Device Source** and **Device Type**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FLEE8XeINfuvp8PexuUbF%2FScreenshot%202026-09-25%20at%204.02.45%E2%80%AFPM.png?alt=media&amp;token=c62dd121-2a9b-4f0b-aec0-93e525577e5f" alt=""><figcaption></figcaption></figure>

* Once the required settings are configured, the connected iOS device appears under the **Device** section. Select the required device to proceed.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FQToXbj3oTbcs6FHhx95M%2FScreenshot%202026-09-25%20at%203.30.48%E2%80%AFPM.png?alt=media&amp;token=dda9845d-d33c-47c6-8e61-ce08cdba1ec0" alt=""><figcaption></figcaption></figure>

* Under **Application**, select the application you want to test.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FOJDEAGsqLoWmnYV6vjf7%2FScreenshot%202026-09-25%20at%204.03.55%E2%80%AFPM.png?alt=media&amp;token=46012d02-a93d-4d0b-9064-d702f16e9b5b" alt=""><figcaption></figcaption></figure>

* If the required application is not available in the application list, you can install it manually:
  * Click **Install App**.
  * Select the required iOS application file.
  * Install the application.
  * Once the installation is complete, select the application from the **Application** list.
* Click **Connect** to establish the connection with the selected application. Once connected, the application opens in the **Live Screen**, where you can manually perform the required actions.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F8h0larDYxI0qjJe275xM%2FScreenshot%202026-09-25%20at%204.14.14%E2%80%AFPM.png?alt=media&amp;token=a5d82a1d-3535-49e9-ae2b-439a3e03795f" alt=""><figcaption></figcaption></figure>

* Perform the required actions on the iOS application. WalnutAI captures each interaction and automatically generates the corresponding **test steps and parameters**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F0TDT3tTGZ3fQUNZReRyZ%2FScreenshot%202026-10-08%20at%204.48.21%E2%80%AFPM.png?alt=media&amp;token=693c8967-646f-450d-b34f-fc325ac69637" alt=""><figcaption></figcaption></figure>

* Once the required test flow is recorded, review the generated steps and parameters, make any necessary modifications, and [**debug the test case**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/debug-a-test-case-in-smart-recording) as required.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FiIRApaDPOWl15DGvgbRN%2FScreenshot%202026-10-08%20at%204.33.05%E2%80%AFPM.png?alt=media&amp;token=22445697-d509-4c6d-bc32-648310dea47d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For detailed information on modifying individual test steps, refer to [**Manage a Test Step**.](/test-and-quality-management/test-management/test-cases/manage-test-step)
{% endhint %}

* On the Parameters tab, click **Chat with AI** to generate test data for the generated test case.
* You can execute test cases and heal failed test steps directly through the chat panel.
* Once you have completed the required modifications, click **Disconnect** to end the recording session.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FTl3QRNK72NxX160X7itT%2FScreenshot%202026-10-08%20at%204.32.01%E2%80%AFPM.png?alt=media&amp;token=8d57aabb-ab06-4733-95ce-9cc0dade46f8" alt=""><figcaption></figcaption></figure>

* Click **Save** to save the generated iOS test case along with its corresponding test steps and parameters.


# SAP Test Case Creation

Creating an SAP test case in WalnutAI using **Manual Recording** allows you to create automated test cases by performing the required actions directly in the SAP application. As you perform the business flow, WalnutAI captures the actions and converts them into corresponding automated test steps.

**Steps to Generate an SAP Test Case Using Manual Recording:**

* Navigate to the **Intelligence Hub**, select **Smart Recording**, and ensure the **Agent** is turned on.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FKv6HboeYjnA9aETgPMoR%2FScreenshot%202026-09-29%20at%206.17.43%E2%80%AFPM.png?alt=media&amp;token=4b6d30b7-b320-4a1c-8b3c-6745023a7148" alt=""><figcaption></figcaption></figure>

* Click the **AI Recording** button in the **bottom bar** and select **Manual Recording** as the recording mode.
* Click the **Web** button in the bottom bar and select **SAP** as the test type.
* On the above bar, enter the **SAP Connection Name**.
* To generate the **Connection Name** in SAP, create or use the required SAP connection configuration and provide a unique name in the **Description** field. Save the configuration and copy the **Description Name**. This name is used as the **Connection Name** in WalnutAI.
* Paste the **Connection Name** from SAP into the connection field in WalnutAI and click **Connect**.
* Once the SAP connection is established, the SAP application is opened in the **Live Screen**.
* Perform the required business flow directly in the SAP application. WalnutAI captures the actions performed during the session and generates the corresponding **test steps**.
* Once the required flow is completed, review and customize the generated steps as required. You can **edit objects, skip a step, enable Continue on Failure, add a new step, add a nested test case, cancel a step, or**  [**debug the test case**.](/core-features/intelligence-hub/generate-test-cases/smart-recording/debug-a-test-case-in-smart-recording)

{% hint style="info" %}
For detailed information on modifying individual test steps, refer to  [**Manage a Test Step**.](/test-and-quality-management/test-management/test-cases/manage-test-step)
{% endhint %}

* On the Parameters tab, click **Chat with AI** to generate test data for the generated test case.
* You can execute test cases and heal failed test steps directly through the chat panel.
* Once you have completed the required modifications, click **Disconnect** to end the session and then click **Save** to save the generated test case.


# Debug a Test Case in Smart Recording

In **Smart Recording**, the **Debug** feature allows you to validate a test case before saving it. Once the AI generates the test case based on the provided prompt and the required steps are recorded, you can use Debug to execute the **entire test case** and verify that the recorded steps, actions, and parameters work as expected.

During debugging, the recorded **steps and parameters remain visible**. The live screen in the current window is disabled, and the test case is launched in a **separate browser window** for execution.

**Steps to Debug a Test Case**

* Record the required test steps using either **AI Recording** or **Manual Recording** in Smart Recording.&#x20;

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FoomdnfvaC4ygXfnIvqxL%2FScreenshot%202026-08-10%20at%203.10.57%E2%80%AFPM.png?alt=media&amp;token=47328c1f-c985-4435-afd8-cdefec466d3a" alt=""><figcaption></figcaption></figure>

* Once the test case is generated. Click the **Debug** button available in the **top-left corner** of the screen. Set breakpoints at the required steps to pause the execution and inspect the test flow.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F0SRvxuSddlKjdfdiCTop%2FScreenshot%202026-08-10%20at%203.17.06%E2%80%AFPM.png?alt=media&amp;token=32a71136-904e-4f33-9046-31b3bfa088f6" alt=""><figcaption></figcaption></figure>

* While debugging, the test case opens in a **separate browser window**. The **steps and parameters remain visible**, while the **Chat panel and Live Screen are closed**.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FPeGxBoJjagUl4LwGJKY4%2FScreenshot%202026-08-10%20at%203.12.54%E2%80%AFPM.png?alt=media&amp;token=dde4f303-6833-4672-8520-30bb190951b3" alt=""><figcaption></figcaption></figure>

* You can make changes to the test case while debugging. This includes modifying **steps, actions, parameters, test data, and other required configurations**. These changes can be made to correct or refine the test flow before saving it

{% hint style="info" %}
For detailed information on modifying individual test steps, refer to [**Manage a Test Step**.](/test-and-quality-management/test-management/test-cases/manage-test-step)
{% endhint %}

* Click a **parameter** and select **Write with AI** to generate test data for the selected parameter. Provide the required context or instructions, and WalnutAI will generate the corresponding test data for use during test execution.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FfxmIsQ1E05h02xPI1qz6%2FScreenshot%202026-08-12%20at%204.25.11%E2%80%AFPM.png?alt=media&amp;token=ac279bc6-27a7-4d5e-8641-e77005b40786" alt=""><figcaption></figcaption></figure>

* Once the test case has been successfully validated and any required corrections have been made, **save the test case** for future execution.


# Playwright Scripts

Import your existing Playwright automation framework into WalnutAI and automatically convert your scripts into structured, execution-ready test cases.

**1. Git Repository**

* Connect any Git repository that contains Playwright automation scripts. WalnutAI analyzes the complete framework, including the existing **Page Object Model, tests, fixtures, and helpers**, and uses the framework context to generate automated test cases within WalnutAI.
* **When to Use:** Use this option when your Playwright project is maintained in a Git repository and you want to import the complete framework.
* **Result:** The framework is analyzed, and automated test cases are generated in WalnutAI while preserving the existing framework context.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FeLYs771u5OpZdtQ60kyo%2FScreenshot%202026-08-17%20at%2012.42.23%E2%80%AFPM.png?alt=media&amp;token=65fe62df-183c-404c-acf7-2de8213ad910" alt=""><figcaption></figcaption></figure>

**2. ZIP Archive**

* Upload a Playwright project as a ZIP file directly from your local device. WalnutAI analyzes the project files and converts the existing automation scripts into automated test cases.
* **When to Use:** Use this option when your Playwright project is available locally as a ZIP archive.
* **Result:** The uploaded project is analyzed and converted into automated test cases that can be reviewed and saved in WalnutAI.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FTz5mL8K2TZtNwDhFcUqv%2FScreenshot%202026-08-17%20at%201.11.44%E2%80%AFPM.png?alt=media&amp;token=b4c9dc91-c528-43da-9675-64ef286310da" alt=""><figcaption></figcaption></figure>

**3. Script Files**

* Upload individual Playwright test scripts to convert existing automation scripts into structured test cases within WalnutAI.
* **Supported Scripts:** Playwright (`.ts`, `.js`, `.spec.ts`, `.spec.js`)
* **When to Use:** Use this option when you have specific Playwright test scripts that you want to convert without importing the complete framework.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FstSmnXEeaYVxMBKy0A9P%2FScreenshot%202026-08-17%20at%2012.40.19%E2%80%AFPM.png?alt=media&amp;token=c65ab242-abac-48d7-ba8f-c49004527376" alt=""><figcaption></figcaption></figure>

**Steps to Generate Test Cases:**

* From Intelligence Hub, select the **Playwright Framework.**
* Upload the supported Playwright script files.
* Review the generated test cases.
* Click Save to store the test cases in WalnutAI.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FLhPZO80C5tcTNnndJt8h%2FScreenshot%202026-08-17%20at%2012.44.48%E2%80%AFPM.png?alt=media&amp;token=17bb89ba-082e-4b1d-b39a-97d64bc5fd26" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Result:** The saved test cases are available in the **Test Case** module as automated test cases.
{% endhint %}


# Gap Analysis

The **Gap Analysis module** serves as the alignment engine of the WalnutAI platform. It continuously evaluates how well business requirements (stories) align with the implemented code, ensuring that development accurately reflects product intent while maintaining overall code quality.

#### How is Gap Analysis helpful?

In complex and evolving projects, it’s important to have clear visibility into how the system is built, tested, documented, and secured. Gap Analysis helps identifying architectural issues, documentation gaps, unit test coverage gaps, and security risks early, helping teams maintain quality and control across the SDLC.

This helps you quickly understand what needs attention and where to focus first, making it easier to prioritize fixes and improve overall code quality with clarity and confidence.

The following are the Insights provided during Gap Analysis:

#### Story Coverage Analysis

Analyse whether each documented requirement has been fully and correctly implemented in the codebase.

#### Missing Story Detection

Identify implemented functionality that does not have an associated requirement, helping prevent scope creep and undocumented changes.

#### Implementation Health Metrics

View coverage percentages, gap counts, and alignment scores to quickly assess project health at a glance, along with indicators of code quality, testing completeness, and technical risk.

#### Code Quality & Documentation Review

Evaluate engineering standards, technical debt indicators, documentation completeness, architectural structure, unit test coverage, and security posture to ensure a robust and maintainable codebase.

#### Traceability & Governance

Maintain a clear, auditable link between business intent, development output, and quality validation, ensuring transparency across requirements, implementation, and engineering quality.

#### AI-Powered Risk Detection

Leverage WalnutAI to intelligently analyse requirements and code, identifying functional gaps, architectural weaknesses, security vulnerabilities, and testing gaps beyond simple keyword matching.

Gap Analysis transforms alignment from a manual review process into a continuous, end-to-end intelligence layer. It enables teams to monitor and improve every phase of development from requirement coverage and implementation accuracy to architecture quality, testing reliability, documentation completeness, and security ensuring high-quality, scalable, and reliable software delivery.

&#x20;


# Phase 1: Missing Code Detection

**Phase 1:** Missing Code Detection validates whether documented requirements are implemented in the connected code repository. In this phase, User Stories act as the baseline, and WalnutAI verifies whether corresponding functionality exists in the selected code branches.

* Before starting the analysis:
  * The project must contain **User Stories** in the Action Items.
  * Ensure all required stories are created and available, these stories will be used as the reference for comparison against the codebase.
* To start the analysis:

  * Click **Start Analysis**.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F6zKrP5c2n9qjqXvsa2QQ%2Fimage.png?alt=media&amp;token=46d72b03-8327-47bb-94a7-891b05ba74a3" alt=""><figcaption></figcaption></figure>

  * Select one or more **connected repositories** (repositories that were linked during project creation).

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FBBlQKCNqdAhZuSJMOnPI%2Fimage.png?alt=media&amp;token=cdf074c3-7ff5-4243-a5b3-efadd30d3e12" alt=""><figcaption></figcaption></figure>

  * Click "**Start Analysing"** to begin evaluation and start Analysing.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FcEO0jaxoR2lZoV0g6qHp%2Fimage.png?alt=media&amp;token=8f7f5402-1879-4758-a8c6-ba3019dfe441" alt=""><figcaption></figcaption></figure>
* During analysis:
  * WalnutAI compares each user story with the selected repository branches.
  * It checks whether the requirement is fully implemented.
  * It detects partially implemented functionality.
  * It identifies requirements that are not implemented at all.
* After the analysis completes, the **Analysis Summary** section displays:

  * **Stories Analysed** – Total number of user stories evaluated.
  * **Gaps Found** – Total number of gaps identified.
  * **Coverage %** – Overall implementation coverage based on analysis.
  * A breakdown of **Missing**, **Incomplete**, and **Outdated** counts.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Flc0zoxitxxvnKZqQOJFN%2Fimage.png?alt=media&amp;token=12d9e746-1fe9-4c93-a7d1-dc2b4732c6c4" alt=""><figcaption></figcaption></figure>

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F4lJ68xzhiICcedawL53C%2Fimage.png?alt=media&amp;token=1aed3207-66dc-493e-bafb-137fd4a2eaf3" alt=""><figcaption></figcaption></figure>
* When a user clicks on a specific user story, the **AI Recommendations** panel displays suggestions such as:
  * Implementation suggestions
  * Displays estimated effort (if available).
  * Highlights missing elements.
  * Shows related code references with match percentage.
  * Recommends an approach to close the identified gap.
* The **Confidence Score** indicates how strongly the implementation aligns with the requirement based on WalnutAI’s semantic comparison.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FPGoIH8rzFt8oAMav8GFG%2Fimage.png?alt=media&amp;token=b37de370-7cf7-4beb-90d7-b67b5d5f6214" alt=""><figcaption></figcaption></figure>

* Click **Run New Analysis** to re-evaluate the selected user stories against the latest code changes and update the analysis results accordingly

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FQ87v4qexyHSLTi0MTQ5V%2Fimage.png?alt=media&amp;token=eedbcba0-6daf-486c-8f88-e329107c8f54" alt=""><figcaption></figcaption></figure>

Phase 1 ensures every user story is validated against the codebase, clearly identifies missing or incomplete implementations, maintains requirement-to-code traceability, and enables teams to proactively resolve gaps before release.


# Phase 2: Missing Story Detection

**Phase 2:** Missing Story Detection identifies functionality that exists in the codebase but is not documented as user stories. WalnutAI also validates existing stories to assess coverage and provides AI-driven suggestions for improving and updating them. In this phase, the code acts as the baseline, and WalnutAI detects undocumented or incomplete requirement coverage.

* **Before starting the analysis:**
  * The project must be connected to one or more repositories.
  * Ensure the repositories were properly integrated during project creation.
  * The codebase from the selected repositories will be used as the reference for comparison against existing user stories.
* **To start the analysis:**

  * Click **Start Analysis**&#x20;

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F8miCiIiUaR4eDxZxVCPc%2Fimage.png?alt=media&amp;token=034a3959-4d9e-4e0d-876a-4d1f00f5726d" alt=""><figcaption></figcaption></figure>

  * Select one or more connected repositories.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F7B3rGACYDnsIpsSzrKX3%2Fimage.png?alt=media&amp;token=d06dd9ed-630e-451c-b6c3-e7e435b2e6b2" alt=""><figcaption></figcaption></figure>

  * Click **Start Analysing** to begin evaluation.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FEFHbc6MYEErZjTmfMcG7%2Fimage.png?alt=media&amp;token=c1338651-de37-403b-98ae-04005eb3579c" alt=""><figcaption></figcaption></figure>
* **During analysis:**

  * WalnutAI scans the selected repository and branch.
  * It compares implemented code with documented user stories.
  * It identifies functionality implemented in code but not documented as a story.
  * It detects stories that require corrections or acceptance criteria improvements.
  * It enhances acceptance criteria to fully reflect implemented behaviour.
  * It generates new user story suggestions for uncovered features.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FVqENmRAj8TSmOtHpEM13%2Fimage.png?alt=media&amp;token=9c5207ea-cf02-463c-8130-daab82c91716" alt=""><figcaption></figcaption></figure>
* **After the analysis completes, the dashboard displays:**
  * **Stories Analysed** – Total number of stories reviewed.
  * **Corrections Needed** – Stories requiring refinement.
  * **Missing Stories** – Undocumented features detected from code.
  * **High Priority** – Critical missing or impacted stories.
* **In the Analysis Results section:**
  * Separate tabs for **Corrected Stories** and **Missing Stories** with respective counts.
* **For Corrected Stories:**

  * Click on Option to **Select All** or select individual stories and directly  **Apply Correction** using the **Apply Correction** action.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FkuOL4a3eIAdD6Cbng8vh%2Fimage.png?alt=media&amp;token=240d0f5d-5cd2-4a31-a846-c1ef729f3203" alt=""><figcaption></figcaption></figure>

  * Clear selection option to reset selections.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FxDcX9zuk3Xo25UfJZtWd%2Fimage.png?alt=media&amp;token=8f001493-120e-4fb1-b9ab-43f3125425a7" alt=""><figcaption></figcaption></figure>

  * Click on Story for Side-by-side comparison of **Original** and **Corrected** versions.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FiuaxvH2JLskIUz6TIdIW%2Fimage.png?alt=media&amp;token=6197e213-844a-454f-9155-aede4712599b" alt=""><figcaption></figcaption></figure>

  * &#x20;Updated Title, Description, and Acceptance Criteria suggested by Walnut AI.
  * &#x20;Highlighted improvements in acceptance criteria coverage.
  * &#x20;Confidence percentage indicating alignment strength.
  * &#x20;**AI Reasoning** explaining why corrections are recommended.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FDAPLue2C3R6Xz4BoqLHe%2Fimage.png?alt=media&amp;token=246ca945-18dc-451f-8a6e-ea244d3f58d4" alt=""><figcaption></figcaption></figure>
* **For Missing Stories:**

  * Click on Option to **Select All** or select individual stories and directly create user stories using the **Create Story** action.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FM3CbzQcrPot8LsLY4eRK%2Fimage.png?alt=media&amp;token=dc6186fc-3bba-4ccd-9d5f-5d89faeea03d" alt=""><figcaption></figcaption></figure>

  * Clear selection option to reset selections.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FHtYsxdAoYgVdEtlY5I0X%2Fimage.png?alt=media&amp;token=06cd084e-87ac-4692-b282-a2470ce370d6" alt=""><figcaption></figcaption></figure>

  * Suggested story title derived from code behaviour.
  * Priority level (e.g., High).
  * The **Confidence Score** indicates how strongly the detected functionality aligns with the suggested or corrected user story based on Walnut AI’s semantic and structural analysis.
  * **Functionality Description** generated from implementation.
  * **Suggested Acceptance Criteria** based on detected logic.
  * **Related Code Files** showing impacted source files.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FAyByk3ZI6y0auypUE71z%2Fimage.png?alt=media&amp;token=b7223350-490a-4d21-b047-0f358dc8385c" alt=""><figcaption></figcaption></figure>
* Click **Run New Analysis** to scan the updated codebase and user stories again, ensuring newly implemented features and recent changes are reflected in the analysis results

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FE2Ci6TgLck3SSIdKWaSV%2Fimage.png?alt=media&amp;token=1e8c1814-f688-4e95-88cb-a6d31da4942a" alt=""><figcaption></figcaption></figure>

Phase 2 ensures implemented features are fully documented, improves requirement and acceptance criteria quality, maintains code-to-requirement traceability, and keeps documentation aligned with actual system behaviour while preventing undocumented development.


# Phase 3: Code Quality & Documentation

**Phase 3: Code Quality & Documentation** analyses the technical health of the codebase and the code quality to identify architectural issues, documentation gaps, unit test coverage gaps, security vulnerabilities, and overall engineering quality.

This analysis helps identify gaps early, as structural code issues can pose risks at any stage, not just over the long term.\
In this phase, the codebase acts as the baseline, and WalnutAI evaluates technical debt, maintainability, and best practice compliance.

* **Before starting the analysis:**
  * The project must be connected to one or more repositories.
  * Ensure the repositories were properly integrated during project creation.
  * The selected repository and branch will be used for technical quality evaluation.
* **To start the analysis:**

  * Click **Run Analysis**

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FNwq3d51PRw0cuXcjJmaM%2Fimage.png?alt=media&amp;token=7a352907-a034-4aac-b068-5b19815ce808" alt=""><figcaption></figcaption></figure>

  * Select the connected repository.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FTHaX7wqYUQZxPOACXCLl%2Fimage.png?alt=media&amp;token=c02c997f-925a-499b-b6a3-dfede6a1c82b" alt=""><figcaption></figcaption></figure>

  * Click **Start Analysing** to begin evaluation.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F3XSVWvIykUvMPN2KWZ55%2Fimage.png?alt=media&amp;token=a4fa7771-79f4-421b-9695-794de936cb15" alt=""><figcaption></figcaption></figure>

  **During analysis:**

  * WalnutAI scans the entire repository structure and evaluates the code across multiple engineering dimensions.
  * It detects architectural weaknesses and design issues while also identifying missing or incomplete documentation.
  * At the same time, it analyses unit test coverage to find critical path gaps and evaluates performance-related concerns.
  * The system also detects security vulnerabilities and risk patterns, categorizes all identified issues based on severity and impact, and generates AI-powered suggestions to improve the overall code quality.

  **After the analysis completes, WalnutAI displays the complete insights:**

  * Quality & Additional Metrics
  * Architectural Analysis
  * Documentation Gaps
  * Unit Tests Gaps
  * Security Gaps
  * Compliance Gaps
* **Quality Metrics & Additional Metrics:**
  * It assess the system’s overall quality by evaluating documentation, unit test coverage, API documentation, architecture strength, security effectiveness, and performance efficiency.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F8uNqfIWcCO2FsUaqTI8S%2Fimage.png?alt=media&amp;token=f52b3561-e557-4c3f-bd6e-b8fbcbb1db33" alt=""><figcaption></figcaption></figure>

WalnutAI provides an initial overview of key technical gaps across the codebase, including architectural issues, documentation gaps, unit test coverage gaps, and security risks, helping users quickly understand and prioritize areas that need attention.

**Architecture Analysis:**

* The system identifies large or complex functions, detects multiple responsibilities within a single module, highlights improper dependency management, flags structural design issues.
* WalnutAI also provides impact explanations along with AI-driven refactoring suggestions, displays the severity level and affected files, and allows users to select issues and create tasks accordingly.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FtQln0ljmfRuT5cBR5EpD%2Fimage.png?alt=media&amp;token=cd06c95e-02e4-42b1-9805-6047c1e63e68" alt=""><figcaption></figcaption></figure>

* Click on “**Create Task**” after selecting either individual items or using the “Select All” option to create tasks.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FLxnqGSa40T3BCpU7VSYs%2Fimage.png?alt=media&amp;token=6bb45204-329b-4482-bf6b-ecc62cdb1d93" alt=""><figcaption></figcaption></figure>

* After clicking on “Create Task”, you can assign the task either to a user (using bulk or individual assignment) or to a [Cloud Agent](/development-and-infrastructure/cloud-agent), which can automatically handle the task without human intervention.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FPkwa3z7MNVAJ57lT9xY3%2Fimage.png?alt=media&amp;token=8df148cc-eb82-4fdd-9b41-36bd139ff9a5" alt=""><figcaption></figcaption></figure>

**Documentation Gaps:**

* The system identifies incomplete or missing explanations in functions and configurations, highlights areas with low documentation coverage percentage, suggests clearer and more comprehensive documentation improvements, and enables users to select identified gaps and create tasks to address them efficiently.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fvmz7Vuin2JJ1lXyFcOmw%2Fimage.png?alt=media&amp;token=52261463-8b1b-4c62-9cf0-3a5331f5fdad" alt=""><figcaption></figcaption></figure>

* Click on “**Create Task**” after selecting either individual items or using the “Select All” option to create tasks.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FPLsjnb3HhWjuAl1NEnMS%2Fimage.png?alt=media&amp;token=2255d765-263e-4daf-8e6c-fefbebd796f5" alt=""><figcaption></figcaption></figure>

* After clicking on “Create Task”, you can assign the task either to a user (using bulk or individual assignment) or to a [Cloud Agent](/development-and-infrastructure/cloud-agent), which can automatically handle the task without human intervention.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fg87HUc5piGSJEuzKkBxY%2Fimage.png?alt=media&amp;token=74d2f118-873f-43d3-9e18-74c5882c47c1" alt=""><figcaption></figcaption></figure>

**Unit Test Coverage Gaps:**

* The system identifies missing unit tests for critical and high-risk code paths, detects the absence of edge case and boundary condition testing, highlights the need for additional integration tests, provides coverage percentage at a file level for better visibility, suggests relevant and comprehensive test scenarios, and enables users to select identified gaps and create tasks to systematically improve overall test coverage and quality.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FavYCTSkbQHcq5bFA33Eq%2Fimage.png?alt=media&amp;token=7957d22c-a10b-478b-8088-9a15384ee722" alt=""><figcaption></figcaption></figure>

* Click on “**Create Task**” after selecting either individual items or using the “Select All” option to create tasks.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FY3QhTt8IFsuGwtpD51OU%2Fimage.png?alt=media&amp;token=a4217435-f27d-4ed6-b254-35048a567710" alt=""><figcaption></figcaption></figure>

* After clicking on “Create Task”, you can assign the task either to a user (using bulk or individual assignment) or to a [Cloud Agent](/development-and-infrastructure/cloud-agent), which can automatically handle the task without human intervention.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FSkAKxl7wQgC6RAshuuPd%2Fimage.png?alt=media&amp;token=9f53a478-30ff-43b5-adeb-c6c499233c1d" alt=""><figcaption></figcaption></figure>

**Security Gaps:**

* The system detects potential security vulnerabilities such as injection risks, unsafe configurations, and XSS issues, maps them to appropriate severity levels and recognized security standards like CWE, identifies the impacted source files, provides AI-driven mitigation suggestions, and enables users to select these vulnerabilities and create tasks to address them effectively.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F79TM9qWYZVnWTF9XSqhm%2Fimage.png?alt=media&amp;token=14b8c8aa-77d1-4b59-be9b-f2c1cfcd97e3" alt=""><figcaption></figcaption></figure>

* Click on “**Create Task**” after selecting either individual items or using the “**Select All**” option to create tasks.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FQG8k4noijWoj7SNkFvcy%2Fimage.png?alt=media&amp;token=66274441-1cc1-4e2a-a260-65b8915e0ded" alt=""><figcaption></figcaption></figure>

* After clicking on “Create Task”, you can assign the task either to a user (using bulk or individual assignment) or to a [Cloud Agent](/development-and-infrastructure/cloud-agent), which can automatically handle the task without human intervention.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F43kwlsvkZ3H2u3DlEmye%2Fimage.png?alt=media&amp;token=de92b811-7909-4319-9e06-ab2c72ed6ded" alt=""><figcaption></figcaption></figure>

**Compliance Gaps:**

* WalnutAI helps you evaluate your codebase against industry-standard compliance frameworks, including **HIPAA Security Rule**, **GDPR**, **FDA 21 CFR Part 11**, and **HITRUST CSF**. Select the required framework from the **Framework** dropdown to view compliance findings specific to that standard.
* The analysis categorizes each control as **Compliant**, **Non-Compliant**, **Partial**, or **Not Determinable**, giving you a clear overview of your current compliance posture. For every identified gap, WalnutAI provides the control name and ID, a confidence score, the affected files or code locations, related compliance mappings, and AI-powered recommendations explaining what needs to be implemented or remediated to satisfy the selected compliance requirement.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FeMyOsRrZdIWxR30CyNPY%2FScreenshot%202026-07-24%20at%203.30.19%E2%80%AFPM.png?alt=media&amp;token=08e97107-fe11-4bb8-929c-5043c177e576" alt=""><figcaption></figcaption></figure>

Users can:

* Navigate between Architecture, Documentation, Unit Tests, Security and Compliance tabs.
* Select All or individual issues and create tasks directly from identified issues.
* The **Confidence and scoring system** reflects how well the codebase aligns with engineering best practices and maintainability standards.
* click **Run New Analysis** to re-scan the codebase for quality, security, and performance issues, ensuring the latest code changes are reflected in the analysis results.

Phase 3 ensures early detection of technical debt, maintains engineering quality standards, improves documentation and test coverage, mitigates security risks, and strengthens long-term code maintainability across the project.


# WalnutAI Coder

The **WalnutAI Coder** is an extension that integrates directly into your IDE, setting up an AI-powered development environment that enables users to efficiently create, edit, and manage application code within a structured workspace. It converts high-level requirements into technical solutions, making it easier to build and maintain applications.

{% hint style="info" %}
**Prerequisites:** Before setting up WalnutAI Coder, ensure that [**Node.js**](/development-and-infrastructure/walnutai-coder/walnutai-installation/installation-guide-node.js) and [**Git Bash**](/development-and-infrastructure/walnutai-coder/walnutai-installation/installation-guide-git-bash) are installed on your system.&#x20;
{% endhint %}

#### What can WalnutAI Extension do?

**AI-Assisted Coding**\
Simply describe what you need in plain language, and WalnutAI Coder helps you generate components, APIs, and business logic. It cuts down repetitive work so you can focus more on solving real problems and less on boilerplate code.

**Works with Existing Applications & New Development**\
Whether you’re starting a brand-new project or working on an existing codebase, WalnutAI adapts seamlessly. It understands your current application structure, helps you extend features, refactor code, or even modernize legacy systems-while also being equally effective in building applications from the ground up.

**Deep Project Understanding**\
When you open a repository, the agent scans your folders, frameworks, dependencies, and coding patterns to provide suggestions that actually fit your project -not generic answers.

**Structured & Guided Workflow**\
From understanding requirements to planning architecture and finally implementing code, WalnutAI encourages a clear, step-by-step development process. This keeps your projects organized and reduces chaos as they grow.

**Interactive & Thoughtful Assistance**\
Instead of jumping straight into code, WalnutAI asks follow-up questions when something isn’t clear. This ensures the output aligns closely with what you actually want, saving time on rework.

**Safe & Controlled Actions**\
WalnutAI always keeps you informed. Before making significant changes-like running terminal commands, installing packages, or modifying key files-it asks for your approval, so nothing happens without your consent.

**Key Benefits of Using WalnutAI Code Editor**

* **Structured Automation:** Transitions seamlessly from planning to implementation without losing project context.
* **Safety & Transparency:** Every major change is gated by user approval, preventing unintended modifications.
* **End-to-End Reliability:** From the first line of code to automated test healing, the agent ensures the feature is built, tested, and maintained.


# WalnutAI Installation

Follow these steps to download and install the WalnutAI extension to enable seamless integration within your development environment:

* Open **Visual Studio**.
* Click on the **Extensions** icon located in the left sidebar of Visual Studio.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fvu7p9J6ANu2ceK4Xiep2%2Fimage.png?alt=media&amp;token=77666606-af6b-4cf4-82a0-855f8a25dd47" alt=""><figcaption></figcaption></figure>

* In the search bar of the Extensions dialog, type **WalnutAI.**
* Find the WalnutAI extension from the search results and click the **Install** button associated with the extension.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F3QFzwyobw9bQcr28okjE%2Fimage.png?alt=media&amp;token=103d56fe-af83-460b-b53e-20f5c89a2454" alt=""><figcaption></figcaption></figure>

* Once installed, WalnutAI will be available in your Visual Studio environment for use.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F8cJoCUxUF7jBEfzjSFqL%2Fimage.png?alt=media&amp;token=09f2ef11-87b4-458b-bfa7-fdefe8d799ed" alt=""><figcaption></figcaption></figure>

* Log in with your WalnutAI account.
* Select a project and start prompting.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F6YCfLFcWxCuqm4Nn8qxE%2Fimage.png?alt=media&amp;token=34275e73-bd01-4e5a-bf95-55f809187b2e" alt=""><figcaption></figcaption></figure>


# Installation Guide: Node.js

Node.js is an open-source, cross-platform JavaScript runtime environment that allows JavaScript code to run outside a web browser. It includes npm (Node Package Manager), which is used to install and manage the packages and dependencies required by applications. Before proceeding with the setup, Node.js must be installed on your system to ensure the required environment is available.

#### Steps to Install Node.js

**Step 1:** Visit the official [Node.js website](https://nodejs.org/en).

**Step 2:** Select the appropriate download for your operating system (Windows, macOS, or Linux).

**Step 3:** Download and run the installer. Follow the on-screen instructions to complete the installation using the default settings.

**Step 4:** Open a terminal and execute the following command to verify the Node.js installation:

```
node -v
```

**Step 5:** Verify that npm (Node Package Manager) is installed by running the following command:

```
npm -v
```

If both commands display version numbers, Node.js and npm have been installed successfully.


# Installation Guide: Git Bash

Git is an open-source version control system used to track changes in source code, manage project versions, and collaborate with other developers. Git Bash provides a command-line environment for using Git on Windows, while macOS users can run Git commands through the Terminal. Git must be installed on your system to manage code changes and work with repositories.

### Steps to Install Git Bash

**Step 1:** Visit the official Git website: <https://git-scm.com/downloads>

**Step 2: Select Your Operating System**

Select your operating system, copy the corresponding Git installation command, and paste it into the VS Code integrated terminal to install Git.

**For Windows (Git Bash):**

```
winget install --id Git.Git -e --source winget
```

**For macOS (Homebrew):**

If Homebrew is not installed, run the following command in the VS Code terminal to install it:

```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

Once Homebrew is installed, run the following command to install Git:

```
brew install git
```

**Step 3: Verify the Installation**

After installation, restart the VS Code terminal and run the following command:

```
git --version
```

If the command displays the installed Git version, Git is installed successfully.


# Working with New Applications and Existing Repositories

The WalnutAI Agent adapts its workflow based on whether you are building a new application or working with an existing repository. The agent remains the default interface, dynamically transitioning between modes as required by the task.

**Building a New Application**

To start a project from scratch:

* Create a folder on your local machine and open it in VS Code.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FLGmdAW97V4Bs0tI0WaKd%2Fimage.png?alt=media&amp;token=04b40cb7-4be0-4f30-8036-c0eafbe94593" alt=""><figcaption></figcaption></figure>

* Activate the WalnutAI extension and select the project.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FsqtPiqH0ZZEABeEIOyuq%2Fimage.png?alt=media&amp;token=3f785448-18d6-4540-bdb1-032ca164f7db" alt=""><figcaption></figcaption></figure>

* Provide the Agent with your high-level requirement (for example, “Build a Task Management API”). Once submitted, the Agent proceeds through the following structured workflow:

  * **Analyze:** The Agent reviews your request and automatically enters [**Plan Mode**](#user-content-fn-1)[^1] to create a structured technical roadmap.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FIkNr0ePM7pwPQ2glw3c2%2Fimage.png?alt=media&amp;token=b386af7e-a7d3-407c-a919-2629f59e0629" alt=""><figcaption></figcaption></figure>

  * **Clarify:** If any information is unclear or incomplete, WalnutAI triggers a Q\&A mechanism to gather the necessary details, ensuring it avoids assumptions and does not hallucinate.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FViTNDBTT8tow32bfXVK9%2Fimage.png?alt=media&amp;token=45589fad-1911-4907-b050-82a78b6bbd3e" alt=""><figcaption></figcaption></figure>

  * **Implement:** After you approve the proposed plan, the Agent begins implementation, requesting explicit permission before running terminal commands or making significant changes.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FFlLDVzvGFlFszfPzy3QE%2Fimage.png?alt=media&amp;token=2ed566fc-774d-4489-bc16-54136e9d1ea3" alt=""><figcaption></figcaption></figure>

**Working with an Existing Repository**

To enhance or maintain an existing project:

* Clone the repository manually using VS Code.
* Open the project folder to allow the Agent to scan dependencies, frameworks, and architectural patterns.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FtJ1onIV6HQcTBVNtQ6ah%2Fimage.png?alt=media&amp;token=17d76020-5754-47ed-9e57-88fa136c7d14" alt=""><figcaption></figcaption></figure>

* Start prompting for specific use cases like bug fixes, refactoring, or documentation.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FS79L9a4J4j6EoewgArsK%2Fimage.png?alt=media&amp;token=7a42f00e-0659-4fbd-ae06-b50460025f21" alt=""><figcaption></figcaption></figure>

[^1]: Converts high-level ideas into a clear, step-by-step technical plan before any code is written.


# Dev & QA Workflow Overview

WalnutAI unifies development and quality assurance into a single, seamless workflow. In Dev Mode, it guides you through planning, understanding, and building features-whether for new projects or existing applications. In QA Mode, it ensures reliability through test design, automated test generation, and continuous stability. The agent serves as the default interface, intelligently switching between modes based on the task to deliver a smooth, end-to-end development experience.

#### Dev Mode

In Dev Mode, the agent assists with development through the following modes:

* **Plan Mode**: Acts as the architect, transforming high-level prompts into a structured, step-by-step technical roadmap before any code is written.&#x20;
* **Ask Mode**: Enables users to clarify requirements, gather insights, and receive guidance throughout the development process.

Additionally, the **Tasks** section in Dev Mode provides visibility into all tasks assigned to the user. By selecting a task, users can directly begin working on and resolving it.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FamFPmq8TBjSNMP2vTVsU%2Fimage.png?alt=media&amp;token=1ece06d9-1e90-479c-a67a-23eb7e24b27a" alt=""><figcaption></figcaption></figure>

#### QA Mode

In QA Mode, the agent supports testing and quality assurance through the following modes:

* **Test Planner Mode**: Acts as the strategist, identifying critical paths that require testing and defining the overall validation strategy.
* **Test Generator Mode**: Functions as the QA engineer, automatically generating executable unit, integration, or end-to-end tests.
* **Test Healer Mode**: Acts as the maintainer, executing tests, diagnosing failures, and automatically updating code or test logic to restore stability.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FbgNQ7bW0OLr0Cvoo8zIq%2Fimage.png?alt=media&amp;token=623c5191-d67e-4a84-a140-f2feb7a069c7" alt=""><figcaption></figcaption></figure>

* **Repository & Custom Method Workflow:** Within QA Mode, users can manage repositories and create custom methods. Before proceeding, ensure that the selected project is properly configured with the appropriate repository.

  * **Open Repo**: Clicking **Open Repo** allows you to select a local folder, where the repository will be cloned.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fr56DM1sMgDkAhLD5RpGG%2Fimage.png?alt=media&amp;token=7e55a0d4-0056-44d8-9a15-9a3e31b6de52" alt=""><figcaption></figcaption></figure>

  * **Initialize:** Sets up the repository and creates a sample method.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FulIQznv4LSV25FQASPR9%2Fimage.png?alt=media&amp;token=0039c56d-df91-427f-82a9-23786bf6e7cd" alt=""><figcaption></figcaption></figure>

  * **Custom Method Creation**: Selecting “Custom Method” initiates a series of structured questions to capture the method’s purpose, required actions, and inputs. Based on these inputs, the system automatically generates the requested method.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FLkQ7XY7YRQqTLL7YoT0y%2Fimage.png?alt=media&amp;token=aa72edb0-d361-4778-a714-8c6612db4914" alt=""><figcaption></figcaption></figure>

  * **Sync**: The created method is synced to WalnutAI. Once synchronized, it can be accessed via Admin Settings under Action Settings or within test steps using “/ → Actions.”

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FvLuFZyyQ0p2xbmeqyxXi%2Fimage.png?alt=media&amp;token=9dca6005-9bf7-4372-b3f6-639cb4ee4f07" alt=""><figcaption></figcaption></figure>

  * **Version Control**:
    * **Push**: Upload the created method to the repository.
    * **Pull**: Fetch the latest updates from the repository.
  * **Debug Mode**:

    * Activate Debug Mode to test and troubleshoot custom methods.

    <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FMlTZbHvW847lRle4fJOJ%2Fimage.png?alt=media&amp;token=9a50924c-1851-47ab-8cd0-6a6e6ac1b867" alt=""><figcaption></figcaption></figure>
  * To debug, create a test case, link the custom method, and execute the test case to validate functionality.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FTlEU7lS1BdSt0XluIoFa%2Fimage.png?alt=media&amp;token=a2c669d8-5b0d-412f-b98c-560097fe2a58" alt=""><figcaption></figcaption></figure>

**Human-in-the-Loop Workflow**

To ensure you maintain total control, the agent operates within a strict safety and collaboration framework:

* **Interactive Q\&A Mechanism:** If a prompt is ambiguous (e.g., "Add login"), the Agent pauses to ask targeted questions about authentication methods or database preferences rather than making assumptions.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F7BDBopzgGFgs1467eGUI%2Fimage.png?alt=media&amp;token=bb19ea83-acbd-4e8c-9c3c-ca3f022ad8d9" alt=""><figcaption></figcaption></figure>

* **Approval Framework**: The Agent must receive your explicit permission before performing impactful actions, including:

  * Running terminal commands.
  * Deleting or restructuring project files.
  * Applying large-scale refactors or database migrations.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FeUYkeHGaDPfXJmZqgfij%2Fimage.png?alt=media&amp;token=85be7f31-f5f7-41d4-9cfa-c32c5ec6b961" alt=""><figcaption></figcaption></figure>


# Cloud Agent

The **Cloud Agent** feature enables you to provision remote machines and deploy AI-powered agents that automatically execute development tasks in a secure cloud environment. After configuring a compute instance, the system prepares the remote machine by installing the required dependencies, configuring the environment, and deploying the agent.

Once deployed, Cloud Agents remain in an idle state until tasks are assigned. Tasks created from any module in WalnutAI are automatically queued and executed by the assigned Cloud Agent. During execution, the agent launches a browser-based development environment, analyzes the codebase, applies fixes, and generates pull requests with the required code changes. If review comments are added to the pull request, the agent can process the feedback and apply the necessary updates, enabling an efficient, end-to-end automated development workflow.

**Why Use Cloud Agents?**

* Automates the execution of development tasks on remotely provisioned machines.
* Eliminates the need for manual environment setup and task execution.
* Automatically applies code changes and generates pull requests.
* Helps resolve pull request review comments by applying the required fixes.
* Reduces manual effort, accelerates development, and improves overall productivity.


# Cloud Machine Setup and Agent Deployment

Before an agent can run, you must prepare the remote Machine that will host it.

Steps to create a remote Machine:

* Navigate to Admin Settings and click 'Compute Configuration'
* Click 'Add Compute'.&#x20;

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FTvvZTG69qovs5nkyHqSX%2Fimage.png?alt=media&amp;token=f1ff1cfc-7dfe-4f58-bb92-8151bdb50ed5" alt=""><figcaption></figcaption></figure>

* Fill in the details:

  * **Name & Type:** Fill in the Compute Name and select the type.
  * **Connection:** Enter the Host / IP (internet address) and the SSH Port (usually 22).
  * **Authentication:** Provide the Username and Password/SSH Key so the system can access the server.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FDJRkT3mObDKe0fpKx7Nx%2Fimage.png?alt=media&amp;token=e167e9f0-c528-4c83-9109-e1a215e1e00e" alt=""><figcaption></figcaption></figure>
* **Define the Environment:** Enter the Docker Image path (e.g., `walnut-cloud-agent:latest`). If the image is private, provide the Registry Server, Username, and PAT.
* **Assign a Subdomain:** Assign a unique URL (e.g., `agent2.walnut.ai`) for browser-based access. Ensure the domain's A record points to your VM IP.
* **Validate & Provision:**

  * Click Test to confirm the credentials and network settings are correct.
  * Click Update VM: This autonomously installs Docker, configures, performs DNS mapping, and pulls the latest Code Editor Docker images.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FjjM8dGSBA3JQidsj3MJl%2Fimage.png?alt=media&amp;token=020b0779-5262-4d4f-beee-fa3b6e8fa1f0" alt=""><figcaption></figcaption></figure>

**Steps to Create a Cloud Agent**

Once the machine status is Active and the environment is fully provisioned, you can deploy the agent.

* Go to the Agents and click 'New Agent'.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F7qaapk7ZpXhXzrvfEd5z%2Fimage.png?alt=media&amp;token=089c54ab-6723-468d-8bb4-7ccdd15eb25d" alt=""><figcaption></figcaption></figure>

* Provide a name for the agent and select the Compute Instance you just created from the dropdown menu.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F3jdYaFQRBPw99CMUXceC%2Fimage.png?alt=media&amp;token=bb5d9ba1-55b4-467e-9e2c-ad184e013e33" alt=""><figcaption></figcaption></figure>

* Click 'Create'.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FjgfLwnDk3MJddswKG4MA%2Fimage.png?alt=media&amp;token=677bd4d3-01d2-4893-9368-fc7105f86376" alt=""><figcaption></figcaption></figure>

**What Happens Next?**

Once created, your agent will sit in an Idle state. It consumes minimal resources while waiting for a task to be assigned. As soon as a task enters its queue, it will wake up and begin execution.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F0YunxKSR4JxJZeXSYUaK%2Fimage.png?alt=media&amp;token=9653fa9a-9219-4786-8b45-9cbad9cb6740" alt=""><figcaption></figcaption></figure>


# Task Assignment, Execution, and PR Management

**Task Assignment Workflow:** Tasks are created directly from the Gap Analysis module, allowing for flexible distribution across your agents.

* **Creation:** Select the identified issues in Gap Analysis and click 'Create Task'.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FRci6TpSxn3x84BNdTaY4%2Fimage.png?alt=media&amp;token=6a5920bb-9b1e-47eb-9208-acaaa8b2231b" alt=""><figcaption></figcaption></figure>

* **Assignment Types:**

  * Bulk Assign: Send all selected issues to a single agent for consolidated processing.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FRjZSdxYO4Oo9NEGRLEHS%2Fimage.png?alt=media&amp;token=290959eb-4e6e-45dc-82ea-1703d5494e47" alt=""><figcaption></figcaption></figure>

  * Individual Assign: Distribute specific issues to different agents based on their workload or machine capacity.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FWguUmx4dU5Uo9LjheQD7%2Fimage.png?alt=media&amp;token=a8e93a58-808b-434e-b146-b11cea06823b" alt=""><figcaption></figcaption></figure>
* **Execution:** Once you click 'Create Task', the system wakes up the assigned agent. The agent pulls tasks from its queue, executes them sequentially, and returns to an Idle state once the queue is empty.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FDBNZMMClBGREMTxSBfS3%2Fimage.png?alt=media&amp;token=80c22001-4a89-4c2c-8622-51848186fda7" alt=""><figcaption></figcaption></figure>

**Live Code Execution Environment:** The system launches a real-time, browser-based environment on the cloud machine that functions like a high-performance IDE.

* Autonomous Progress: The editor automatically loads and begins the first task in the queue. You can watch the agent analyze files and apply code fixes in real time.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FBtqd8S8E4Fzd8UMRkPZ3%2FScreenshot%202026-07-28%20at%207.13.21%E2%80%AFPM.png?alt=media&amp;token=eefad2de-3417-441f-8394-d28a75133190" alt=""><figcaption></figcaption></figure>

* Streamlined Logic: To maximize efficiency, this environment skips manual approval gates the system automatically approves and executes actions to maintain momentum.

**Pull Requests and Comment Resolution:** After completing a task, the agent automatically generates the required code changes and creates a Pull Request (PR) in the repository.

* For example, in Azure Repos, the Pull Request may be raised by the WalnutAI Cloud Agent, including the necessary code modifications and fixes identified during task execution.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FcxpJzkqusWb8ySMD1uyz%2FScreenshot%202026-07-28%20at%207.17.21%E2%80%AFPM.png?alt=media&amp;token=311a52d3-a535-4a2c-b158-38d09d93d6f9" alt=""><figcaption></figcaption></figure>

* Users can add comments to the pull request. If feedback is provided, users can click Fix PR Comments. This allows the agent to review the comments and apply the necessary fixes to resolve the feedback.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fpek2rSLC9AzBK7n55JSD%2FScreenshot%202026-07-28%20at%207.18.58%E2%80%AFPM.png?alt=media&amp;token=cfc1880c-cc75-4b59-8989-18edeba93901" alt=""><figcaption></figcaption></figure>


# Test Management

Create, organize, and manage your test cases and test suites in a structured and centralized workspace. This section helps you define clear test scenarios, map them to features and epics, and maintain visibility into key details such as status, priority, and execution results. It enables consistent tracking and better organization of your testing efforts across the project lifecycle.

Within the **Test Management**, all test cases are displayed in a centralized table view. Each row represents an individual test case and includes key attributes such as Test Case ID, Test Case Name, Feature, Epic, Status, Priority, and Execution Status, providing clear visibility into validation progress across the project.

You can also perform bulk actions like **importing** and **exporting** test cases, making it easier to onboard large datasets or share test assets across teams. With filtering, sorting, and quick access to actions, this page is designed to simplify test management. You can **Delete** test cases when they are no longer required, noting that deletion is a **permanent action** and cannot be undone.

WalnutAI also supports the creation and execution of **Test Suites**, enabling users to group multiple test cases together and execute them collectively for feature-level or regression-level validation.

Users can create test cases manually or generate them using AI from user stories, documents, or integrated sources. Each test case supports detailed step configuration, dataset-driven execution, nested test case reuse, and both manual and automated execution modes. With built-in AI assistance and execution tracking, test cases in WalnutAI provide a structured and traceable framework for comprehensive application validation.


# Test Cases

A Test Case in WalnutAI is a structured validation unit designed to verify that an application behaves as expected. It defines a clear sequence of steps, associated objects, expected outcomes, and supporting test data to ensure functional accuracy and requirement compliance. This structured approach enables consistency, traceability, and reliable validation across the application.

In this module, you will learn how to create a test case, manage its test data effectively, build nested test cases, implement conditional workflows (such as If/Else and loops), execute test cases, and leverage AI Healing to automatically detect and resolve UI or object-level changes during execution.

**Organize and View Test Cases**

The **Test Management** module provides two views to help you organize and navigate your test cases efficiently:

* **Test Cases:** Organize and group test cases into folders or modules, making it easier to manage and navigate related test cases based on features, functional areas, or other requirements.
* **User Stories:** View the associated user stories along with the test cases linked to each user story. This provides better visibility into the relationship between requirements and their corresponding test coverage.


# Test Case Creation

**Steps to Create a New Test Case**

* Select '**Create New Test Case.**

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FeAnKin2bEmv5SididO1l%2Fimage.png?alt=media&amp;token=db676f1e-f2be-4ac2-bf20-7c6b4651ad39" alt=""><figcaption></figcaption></figure>

* Open **Test Case Information** and provide all necessary details, making sure all required fields are completed before moving forward.
  * **Test Case ID:** A unique, system-generated identifier used for tracking and referencing the test case across the project.
  * **Title:** Enter a concise name that clearly describes the functionality being validated; this is a mandatory field.
  * **Description:** Provide a detailed overview explaining the purpose of the test and its coverage.
  * **Objective:** Define the specific goal of the test and the exact behaviour you are verifying.
  * **Epic, Feature, & User Story:** Select these from the dropdowns to map the test case to its originating requirement, ensuring 100% traceability.
  * **Test Category & Type:** Categorize the test (e.g., Manual or Automation) and its functional area, such as Regression or UI.
  * **Priority:** Rank the importance of the test (Low, Medium, High, or Critical) to help the team prioritize execution.
  * **Status:** Track the current state of the test case, such as Draft, Reviewed, or Approved.
  * **Preconditions:** List any setup requirements as pre-requisites that must be met before the test begins, such as "User must be logged in".
  * **Expected Outcome:** State the successful result you expect to see once all steps are completed.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FBFUkDGvttxSAIlxDDfS6%2Fimage.png?alt=media&amp;token=1001d994-b606-4938-820b-292f9b9882aa" alt=""><figcaption></figcaption></figure>

#### Defining and Managing Steps

* Use the **Add Step** option to add test steps. Define the step description and specify the expected result for each step.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FebHPP8Tpn9I7lS8wdRIX%2Fimage.png?alt=media&amp;token=fc3e55a5-9492-4d8f-9937-584191471bce" alt=""><figcaption></figcaption></figure>

* Configure relevant **objects and parameters** wherever applicable.
  * **Global Variables:** Type **`$(`** to access the dropdown for static, project-wide values.
  * **Runtime Variables:** Type **`$[`** to access the dropdown for dynamic values generated during execution.
  * **Local Variables:** Type **`${`** to open the dropdown for data specific to the current test case.
  * **Actions:** Alternatively, type **`/`** to open a comprehensive menu that includes objects, test case types, variables, and reusable actions.
* Click **Save** to save the test case.
* After saving, set up the required **test data.**

**WalnutAI provides multiple ways to generate test cases based on your workflow needs.**

* **From the** [**Intelligence Hub**](/core-features/intelligence-hub)**:** You can choose between two approaches:
  * **Requirement-Driven Path:** Generate a User Story first, then **Generate Test Cases** to maintain full traceability.
  * **Direct Generation Path:** Skip story creation and directly generate test cases from source documents or repositories for faster validation.
* **From the** [**Action Items Module**](/overview-and-tracking/action-item/ai-driven-requirement-enhancement-and-test-generation)**:** If requirements are already saved:
  * Open an existing User Story and use the **AI Generate** option.
  * A test case will be automatically created and linked to that story.
* **From an Existing Test Case:**

  * Open any existing test case, select the test steps and click on '**Save as New Test Case'.** This allows you to quickly duplicate and modify existing test cases without starting from scratch.


# Manage Test Data of a Test Case

**Test Data** refers to the set of input values and parameters used to execute a test case and validate system behaviour. Proper test data ensures accurate, consistent, and repeatable test execution.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FqVSAaQUglINaDV2kLer7%2Fimage.png?alt=media&amp;token=b5e1f39a-fdb5-4ca5-9b93-ef9db0c4cfc9" alt=""><figcaption></figcaption></figure>

Test Data Management in WalnutAI consists of [**Test Data**](#user-content-fn-1)[^1] and [**Nested Test Data**.](#user-content-fn-2)[^2]

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FdZqGHuMCOYOmHlPtwmJJ%2Fimage.png?alt=media&amp;token=af4d2f7e-f69d-4db2-9420-af44038c5d2e" alt=""><figcaption></figcaption></figure>

* The Test Data section is specific to an individual test case, allowing you to define the exact values as per the test case which will be used during execution.&#x20;

  * To add a dataset in a test case open the test case > Test Data and click '**Add Dataset'** and enter parameter values (such as URL, Email, or Password). All fields are editable and can be customized based on your test requirements.
  * Use the '**Import'** option to upload external datasets if they are already available.
  * Click '**Export'** to download the existing datasets for external use.
  * After adding or updating data, click '**Save All'** to ensure the datasets are stored and ready for execution.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FlRkRKpPTotwkWq4TVBgi%2Fimage.png?alt=media&amp;token=7ce9e23b-72ca-4836-bb01-7472f516147d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Test cases created using **Smart Recording from the Intelligence Hub** will have parameters automatically identified and mapped.
{% endhint %}

* **Nested Test Data** section applies to nested test cases (reusable test cases executed within other test cases).

  * **Left Panel:** Displays the nested test case structure (branches).
  * **Right Panel:** Shows parameter values and datasets for the selected branch.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fm3f2vEbFkrG7JiKVu6KN%2Fimage.png?alt=media&amp;token=f434a5bb-c48b-4825-9327-843e5270fd2e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If multiple datasets exist, select the required ones using the checkbox to make it as Default which will be used for execution; otherwise, the system defaults to the first dataset. When multiple datasets are selected, the platform performs **Iterative Execution**, running the test once per selected dataset.
{% endhint %}

[^1]: Test Data is the input you give to a test case to check if the system works correctly.

[^2]: Nested Test Data is the input used for a nested (reusable) test case that runs inside another test case.


# Manage Test Step

Each test step provides a range of actions that enable you to control and customize the execution flow with precision.

Within the Test Case Editor, you have full control over step behavior, supported by smart shortcuts for faster and more efficient execution:

**Smart Shortcuts**

* **Global Variables**: Type `$(` to access a dropdown of static, project-wide values.
* **Runtime Variables**: Type `$[` to access dynamic values generated during execution.
* **Local Variables**: Type `${` to open a dropdown for data specific to the current test case.
* **Actions Menu**: Type `/` to open a comprehensive menu that includes objects, test case types, variables, and reusable actions.

**Step Actions**

* **Object Management**: Add or modify the object associated with a specific step.
* **Create New Step**: Insert a new test step at any point in the sequence. Define the step description and expected result to refine validation logic.
* **Advanced Logic**: Apply conditional logic such as if/else statements, loops (e.g., while), or invoke a nested test case.
* **Skip Step**: Skip a specific step during execution without removing it from the test case.
* **Screenshots**: Capture and view screenshots for individual steps as visual evidence.
* **Delete Step**: Remove a test step that is no longer required.
* **Export**: Export the complete test case as a Playwright script for external automation use.

{% hint style="info" %}
After making any changes, you must click Save before navigating away to ensure your updates are not lost.
{% endhint %}


# Nested Test Case

**Nested Test Cases** are reusable test cases that are called and executed within another parent test case as part of its workflow.

They allow you to embed a predefined set of steps (such as login, setup, or validation flows) that are used frquently inside a larger test scenario, enabling modular, reusable, and maintainable test design.

* **Nested Test Case:** To add a nested test case, hover over the desired test step and click the branching icon.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FJKKk7r5Kkd0CriwH5DL4%2Fimage.png?alt=media&amp;token=2cf431b3-ef87-4bb0-a1f4-4876fdf0fea7" alt=""><figcaption></figcaption></figure>

* Choose **'Nested Test Case'** from the available options.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FvW6arfuxNFYIuWqNubDC%2Fimage.png?alt=media&amp;token=393241bf-50c4-4f88-be70-91d96815897d" alt=""><figcaption></figcaption></figure>

* Select the required test case to call, then click **'Confirm Selection'** to proceed.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FGnWVRdI8XBXuFo0gxkKV%2Fimage.png?alt=media&amp;token=bcea8bb0-84ca-4efb-94d9-b621aba13fbd" alt=""><figcaption></figcaption></figure>

* The **Branches View** is also available within the **Nested Test Data** section to view and manage the associated branches and their datasets.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F3lOXQZiWOcWhdEPvhhrD%2Fimage.png?alt=media&amp;token=15cd99a0-b044-4677-9784-53611d2e9d37" alt=""><figcaption></figcaption></figure>


# Add Control Flow (Conditional Statements)

Adding a Control Flow (Logical Conditions) allows you to introduce conditional logic inside a test case to control execution based on defined conditions. It helps create dynamic, intelligent, and flexible test scenarios without writing manual code.

Control Flow is useful when certain steps should execute only under specific conditions, such as validating error messages, handling optional flows, retrying actions, or managing dynamic application behaviour.

**To add a control flow:**

* Hover over the desired test step and click the branching icon.
* Choose one of the available options:

  * [**If / Else**](/test-and-quality-management/test-management/add-control-flow-conditional-statements/if-else)
  * [**While Loop**<br>](/test-and-quality-management/test-management/add-control-flow-conditional-statements/while-loop)

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FazT5FNlAMB7DRmotgGyu%2FWifesle.png?alt=media&amp;token=58d6c41c-f8b9-4e53-99e0-5bd8cc9bf930" alt=""><figcaption></figcaption></figure>


# If / Else

If / Else enables a test case to follow different execution paths depending on whether a specified condition evaluates to true or false, allowing dynamic and logic-based test execution.

If certain steps need to be executed only when a condition is true (for example, login is successful), add them under the **If** section.\
If the condition is false, alternative steps can be added under the **Else** section.

* Click **"If / Else"** to add a conditional block in the test case.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FDaErd4PhcqjuDqAckdbe%2Fimage.png?alt=media&amp;token=dbac5305-7b8e-444e-a638-515c8d829de4" alt=""><figcaption></figcaption></figure>

* **Set Condition for If -**&#x43;hoose how to set the condition:
  * **Element**
  * **Parameter**
* **Element -**&#x43;hoose **"Element"** when the condition depends on an object (UI element, text, etc.) on the screen.
  * From the dropdown, select the required option:
    * Conditions (is visible, is not visible)
    * Actions
    * Interactions(click, type, focus..)
      * **Example:**\
        To check if the **"Login Successful"** message is visible after clicking the login button:
        * If the message is visible → condition is true
        * If not → condition is false
* Select the required "**Object"** (stored using XPath / Playwright).
* Click "**Save"** to apply the condition.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F8kdzkFS8E5D9wfCI9so6%2Fimage.png?alt=media&amp;token=bcb87846-c2ec-4853-a324-8ab6c1121b27" alt=""><figcaption></figcaption></figure>

* **Parameter** - Choose **"Parameter"** when the condition depends on a value.

  * From the **1st dropdown**, choose an existing parameter OR Click "**Create"** to add a new parameter:
    * Enter Name (e.g., login\_status)
    * Enter Value (e.g., success)
    * Select Type (String, Number, etc.)
    * Click **Create**
  * From the **2nd dropdown**, select the comparison type\
    (equals, not equals, greater than, less than, contains, etc.)
  * Enter the comparison value (e.g., success)
    * **Example:**\
      To check if the login status is successful:
      * If login\_status = success → condition is true
      * If login\_status ≠ success → condition is false
  * Click "**Save"** to apply the condition.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FztVdtiiwuZm8lSXzhDIL%2Fimage.png?alt=media&amp;token=aeba20d0-aa86-460c-b720-2b32d762c3be" alt=""><figcaption></figcaption></figure>

* **If (True Condition Steps)-**&#x41;dd the required steps under **If**.

  * These steps execute only when the condition is true.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F9PjwnOWoBZ50s5N4ijcU%2Fimage.png?alt=media&amp;token=63f383f0-e0c8-49d2-b80f-5a703da6b682" alt=""><figcaption></figcaption></figure>

* **Else**

  * Add the required steps inside the "**Else"** section.
  * These steps execute only when the **If condition evaluates to false**.
    * **Example:**\
      If login is not successful:
      * Show error message
      * Retry login
      * Capture screenshot
  * If needed, update or modify the description
  * Click **"Save"** after changing description

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FTSilBWU8oYfoWQNmZHZO%2Fimage.png?alt=media&amp;token=079c3e8e-d147-46f0-baee-19220c1180d1" alt=""><figcaption></figcaption></figure>

* **Else (False Condition Steps)-**&#x41;dd the required steps inside the **Else** section.

  * These steps execute only when the condition evaluates to false.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FP5s7au2YAYM4quOGDiBT%2Fimage.png?alt=media&amp;token=2a418cbf-c4bf-4bbc-a1b3-648c302bc11b" alt=""><figcaption></figcaption></figure>

* **End If**

  * **End If** marks the end of the If / Else condition.
  * It closes the conditional block and completes the flow.
  * If needed, update or modify the description
  * Click **"Save"** after changing description

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F9ns9rZPiL588FctS7XlZ%2Fimage.png?alt=media&amp;token=b4e51951-b456-461b-ae45-1aedd2a15af8" alt=""><figcaption></figcaption></figure>

* **Example Flow**
  * If login is successful:
    * Perform dashboard actions
  * Else:
    * Show error and stop execution
  * After **End If**:
    * Continue with remaining test steps


# While Loop

While Loop enables a test case to repeatedly execute a set of steps as long as a specified condition evaluates to true, allowing controlled and condition-based iteration within the test flow.

If certain steps need to be repeated until a condition becomes false (for example, retry login until successful), add them under the **While** section.

* Click **"While Loop"** to add a loop block in the test case.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FiRg5BiYv57vESFy1oQNG%2Fimage.png?alt=media&amp;token=0ae02586-3d6c-4a52-a402-2790086bae9f" alt=""><figcaption></figcaption></figure>

* **Set Condition for While - Choose how to set the condition:**
  * **Element**
  * **Parameter**

* **Element** - Choose **"Element"** when the condition depends on an object (UI element, text, etc.) on the screen.

  * From the dropdown, select the required option:
    * Conditions (is visible, is not visible)
    * Actions
    * Interactions (click, type, focus, etc.)
  * Select the required "**Object"** (stored using XPath / Playwright).
  * Set **Max iterations** (default: 100).
    * **Example:**\
      To retry login until the success message appears:
      * While **"Login Successful"** message is not visible → condition is true
      * If the message becomes visible → condition becomes false
      * The system will keep retrying login until the message appears or max iterations are reached
  * Click "**Save"** to apply the condition.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FnHIdqb58TuwoSXvG9xzv%2Fimage.png?alt=media&amp;token=e3ff4b60-548d-42ec-ac25-8fd421df07d1" alt=""><figcaption></figcaption></figure>

* **Parameter** - Choose **"Parameter"** when the condition depends on a value.

  * From the **1st dropdown**, choose an existing parameter OR Click "**Create** to add a new parameter" :
    * Enter **Name** (e.g.,retry\_count)
    * Enter **Value** (e.g., 0)
    * Select **Type** (String, Number, etc.)
    * Click **Create**
  * From the **2nd dropdown**, select the comparison type:
    * equals
    * not equals
    * greater than
    * less than
    * contains
  * Enter the comparison value (e.g., 3).
  * Set **Max iterations**.
    * **Example:**\
      To retry login for limited attempts:
      * While retry\_count < 3 → condition is true
        * If retry\_count ≥ 3 → condition becomes false
        * The system will retry the steps until the condition becomes false or max iterations are reached
  * Click "**Save"** to apply the condition.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FsHvKxxWzNEvBcTCCBZMB%2Fimage.png?alt=media&amp;token=b1e8e503-bcee-456d-a2ce-0cd5f832d8c3" alt=""><figcaption></figcaption></figure>

* **While (Loop Steps)**

  * Add the required steps under **While**.
  * These steps execute repeatedly as long as the condition is true.

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FfFLp3c9LUFOdo4j41RYO%2Fimage.png?alt=media&amp;token=4cc5393e-593e-4fce-b3d5-a08a04a1cbdb" alt=""><figcaption></figcaption></figure>

* End While

  * End While marks the end of the While loop.
  * It closes the loop block and completes the flow.
    * The loop stops when:
      * Condition becomes false
      * OR max iterations limit is reached
    * If needed, update or modify the description
    * Click **"Save"** after changing description

  <figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fuk1z5bymE8WAjpWu8jLy%2Fimage.png?alt=media&amp;token=5eb9186b-0a98-4e1b-8980-da80af77eb0f" alt=""><figcaption></figcaption></figure>

* **Example Flow**
  * While login is not successful:
    * Enter username and password
    * Click login
    * Wait for response
  * After End While:
    * If login is successful → go to dashboard
    * Else → show error and stop execution
  * Continue with remaining test steps


# Creating Test Cases in WalnutAI

WalnutAI supports multiple platforms of test cases to validate different layers of your application. Each test case type ensures complete functional coverage, from frontend user interactions to backend services and database validation.

* **Web Test Cases**\
  Designed to validate frontend application behaviour and user journeys.\
  They verify UI elements, form validations, navigation flows, authentication processes, and complete end-to-end workflows.
* **API Test Cases**\
  Designed to validate backend services and system integrations.\
  They allow configuration of HTTP methods (GET, POST, PUT, DELETE, PATCH), headers, authentication, parameters, and request payloads.\
  API test cases verify response status codes, add assertions, headers, and response data, and support variable extraction for use in subsequent steps.
* **Database Test Cases**\
  Designed to validate data integrity and backend storage operations.\
  They connect to supported databases, execute SQL queries, and validate returned results.\
  Database test cases ensure accurate data validation after UI or API operations and support assertions and parameterized execution.
* **Hybrid Test Cases (End-to-End Validation)**\
  WalnutAI also supports combining Web, API, and Database steps within a single test case.\
  This allows full end-to-end validation for example, performing a UI action, validating the API response, and verifying database changes in one structured workflow.\
  This unified approach ensures complete traceability and comprehensive application validation across all layers.

By supporting individual and combined test case platforms within a single framework, WalnutAI enables structured, end-to-end testing with improved quality, better visibility, and reduced risk throughout the application.


# How to create Web test case

A Web Test Case is a structured validation scenario designed to test the functionality and behavior of a web application in a browser. It simulates real user interactions such as entering data, clicking buttons, and navigating pages ensure UI elements and workflows function as intended.

#### **Steps to Create a Web Test Case**

* &#x20;Click on [**Create New Test Case**](/test-and-quality-management/test-management/test-cases/test-case-creation) button to start a new validation scenario.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Frq6v93s8ddMxeB6Hx6bW%2Faddnewstep%20in%20TC.png?alt=media&amp;token=07bf4f48-62ce-458b-b3f7-72317ccb9b57" alt=""><figcaption></figcaption></figure>

* Click "**Add Step"**, then type **“/”** inside the step field. From the dropdown menu, choose **Test Case Type** and select **Web**. This allows you to build structured web validation steps without writing manual code.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fz73CNaamqwJVfl81Ubfo%2FTypesofTC.png?alt=media&amp;token=61b4f705-9a27-4097-a023-4fc0df86ee29" alt=""><figcaption></figcaption></figure>

* **Add Step Description & Use Variables**:
  * Enter the test step description in simple English.
  * **To reuse an existing Variables**:  type `$(` for Global variables, `${` for Local variables, or `$[` for Runtime variables to open the dropdown and select the required value.
  * **To create a new Variables**: Refer to the **Create New Variables** section for guidance.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FOcnWM63vrsJ5RSkYIm63%2FparametsTC.png?alt=media&amp;token=09bfef32-cc60-4914-856f-4151ec64befe" alt=""><figcaption></figcaption></figure>

4. Once all steps are defined, click **Save** to store your test case in the dashboard.
5. Run the created web test case using either **Manual** or **Automation (AI)** mode.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FvDbLAGTArfwk2h75L4Oy%2FAI%26m.png?alt=media&amp;token=99f4cbfb-15fe-4129-bd39-a89c168962ea" alt=""><figcaption></figcaption></figure>

To understand the details of running your tests and how the system handles changes, refer to the documentation on [Execution & AI Healing](/test-and-quality-management/test-management/execution-and-ai-healing).


# How to create API test case

An API Test Case is a structured validation scenario designed to test the functionality and behaviour of backend services. It validates API endpoints by sending requests and verifying responses such as status codes, headers, and response data to ensure the service works as intended.

#### **Steps to Create a API Test Case**

* Click the [C**reate New Test Case**](/test-and-quality-management/test-management/test-cases/test-case-creation) button to start a new validation scenario.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Frq6v93s8ddMxeB6Hx6bW%2Faddnewstep%20in%20TC.png?alt=media&amp;token=07bf4f48-62ce-458b-b3f7-72317ccb9b57" alt=""><figcaption></figcaption></figure>

* Click "**Add Step"**, then type “/” inside the step field. From the dropdown menu, choose **Test Case Type** and select **API**. This allows you to configure structured API validation steps without writing manual code.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fz73CNaamqwJVfl81Ubfo%2FTypesofTC.png?alt=media&amp;token=61b4f705-9a27-4097-a023-4fc0df86ee29" alt=""><figcaption></figcaption></figure>

* Select the required HTTP Method (GET, POST, PUT, DELETE, PATCH).

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fa2disbauytA2PdpkFQdT%2Fimage.png?alt=media&amp;token=0e2b9ab7-06a5-4b9d-8914-8b306b6b1ae5" alt=""><figcaption></figcaption></figure>

* Enter the Request URL. You can use variables inside the URL if needed.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FwoZwItQfLzmeiSaSwDX0%2Fimage.png?alt=media&amp;token=b7e9c81a-5f74-484c-9bdf-abbeaf598169" alt=""><figcaption></figcaption></figure>

* Use the available tabs to configure the request:
  * In **Params**, add query parameters as key-value pairs.
  * In **Authorization**, select the required authentication type such as Bearer Token, Basic Auth, API Key, OAuth, JWT, etc.
  * In **Headers**, add the necessary request headers.
  * In **Body**, choose the required body type such as JSON, Form Data, Raw, x-www-form-URL encoded, or Graph, and provide the payload if needed.
  * In **Variables**, manage Local, Runtime, and Global variables.
  * In **Extractions**, define rules to capture values from the API response for use in subsequent steps.
  * In **Pre-request Script**, add logic that should execute before the request is sent.
  * In **Tests**, define validations to verify response status codes and response data.
* Enter the step description in simple English to clearly describe the API validation scenario.
* To reuse an existing parameter, type `${` to open the parameter dropdown and select the required variable. To create a new parameter, refer to the Create New Parameter section for guidance.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FOcnWM63vrsJ5RSkYIm63%2FparametsTC.png?alt=media&amp;token=09bfef32-cc60-4914-856f-4151ec64befe" alt=""><figcaption></figcaption></figure>

* Once all steps and configurations are completed, click **Save** to store your test case in the dashboard.
* Run the created API test case using either:
  * **Manual Mode** for step-by-step validation.
  * **Automation (WalnutAI) Mode**, where WalnutAI automatically sends the request, resolves parameters, processes variables, performs validations, and generates structured execution results.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FvDbLAGTArfwk2h75L4Oy%2FAI%26m.png?alt=media&amp;token=99f4cbfb-15fe-4129-bd39-a89c168962ea" alt=""><figcaption></figcaption></figure>

To understand the details of running your tests and how the system handles changes, refer to the documentation on[ Execution & AI Healing.](/test-and-quality-management/test-management/execution-and-ai-healing)


# How to create DB test case

A Database Test Case is a structured validation scenario designed to verify data integrity, data accuracy, and backend database operations.

* It connects to a configured database.
* Executes SQL queries or operations.
* Validates returned results to ensure correct data storage and retrieval.

#### **Steps to Create a DataBase Test Case**

* Click "[**Create New Test Case**](/test-and-quality-management/test-management/test-cases/test-case-creation)**"** to start a new validation scenario.
* Click **Add Step**, type “/” inside the step field.
  * From the dropdown, choose "**Test Case Type"**.
  * Select "**Database"** to configure structured DB validation steps without writing manual automation code.
* Select the required **Database Type**.
  * MySQL
  * PostgreSQL
  * MSSQL
  * MongoDB
* Configure the database connection using either:
  * Standard connection fields:
    * Host
    * Port
    * Database Name
    * Username
    * Password
    * Optional SSL toggle
  * OR enable "**Connection String"** toggle and paste the full connection string.
* Click "**Connect"** to establish the database connection.
  * Optionally click **Save Connection** to reuse it in future test cases.
* Under **Operation**, choose the required option (e.g., Custom).
  * Enter the SQL query in the query editor.
  * Or describe the query in plain English and click **Generate Query** to auto-generate SQL.
* Click "**Run Query"** to execute the query and view results.
* Use the available tabs for validation:
  * **Results**
    * View query execution output.
    * Verify returned records.
  * **Assertions**
    * Validate row count.
    * Verify specific column values.
    * Check data types.
    * Ensure fields are not null.
  * **Extract**
    * Capture values from query results.
    * Store values for reuse in later steps.
  * **Test Data**
    * Manage datasets for parameterized execution.
* You can use variables inside queries:
  * Global Variables → Type `$(`
  * Local Variables → Type `${`
  * Runtime Variables → Type `$[`
* To reuse an existing variables:
  * Type `${` and select the required variable from the dropdown.
* Enter the step description in simple English to clearly describe the database validation scenario.
  * Example: “Verify active users are returned from users table.”
  * Example: “Validate user record is inserted successfully.”
* Once configuration is complete, click **Save** to store the test case.
* Run the created DB test case using:
  * **Manual Mode**
    * Execute step-by-step validation.
  * **Automation (WalnutAI) Mode**
    * Automatically connects to database.
    * Executes queries.
    * Resolves variables and parameters.
    * Performs assertions.
    * Extracts values.
    * Generates structured execution results.
* For more details on execution flow and intelligent handling of changes, refer to the documentation on [**Execution & AI Healing**.](/test-and-quality-management/test-management/execution-and-ai-healing)<br>


# Execution & AI Healing

**Test Execution**

Once your test case is saved, click on **'Run Test'** to initiate the validation process. WalnutAI provides two primary modes of execution to fit different testing requirements:

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FOHezBT6XdxgUVKpOJtJI%2Fimage.png?alt=media&amp;token=d7766dcf-e36c-4a75-a3b0-c826cfe7c8aa" alt=""><figcaption></figcaption></figure>

* **Automation Mode:** WalnutAI automatically executes the defined steps using your configured objects and parameters to ensure rapid, consistent validation.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FvFrEdq5LtFh22NBRkuu9%2Fimage.png?alt=media&amp;token=4a2e03f4-c932-4180-a4c7-9cb6b3cce4a4" alt=""><figcaption></figcaption></figure>

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F9XzEu471lpoq03XCFwF4%2Fimage.png?alt=media&amp;token=4ae60319-026b-41e3-b98a-af297369f631" alt=""><figcaption></figcaption></figure>

* **Manual Mode:** This allows you to execute the test step-by-step, providing the flexibility to log actual results, upload evidence, and manually mark each step as Pass or Fail.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fx6YC5MhwaJ1Sy8CQ5mud%2Fimage.png?alt=media&amp;token=bb6dc880-ffa5-4f24-bdd0-96cdcb68573b" alt=""><figcaption></figcaption></figure>

**AI Healer**

WalnutAI includes an intelligent recovery system to handle the common issue of brittle tests failing due to minor application changes.

* If a test fails due to UI changes or object mismatches, you can trigger the AI Healer directly via the chat interface.
* The AI automatically analyzes the failure to detect the underlying issue, such as a renamed button or a shifted element.
* The system suggests the required updates, allowing you to review the changes and fix the step immediately without manual debugging.
* This proactive approach ensures continuous quality monitoring by resolving misalignments between intent and code before they become technical debt.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2F6pmBYBkfjYhoIMEGDHH3%2Fimage.png?alt=media&amp;token=5602f729-705a-4c7f-8be6-96f6b83b3fb7" alt=""><figcaption></figcaption></figure>

After execution, navigate to the Reports section to view detailed test case results and execution summaries.


# Defects

Defects in WalnutAI are managed within the **Action Items** module, providing a centralized place to track, assign, and resolve issues identified during testing.

Defects can be logged directly from failed test executions or created from the **Action Items** screen whenever required. Once created, they can be linked to test cases and user stories, ensuring complete traceability across requirements, testing, and defect management.

From the **Action Items** screen, you can:

* Create and manage defects.
* Assign defects to team members.
* Update defect details, priority, and status.
* Link defects to test cases and user stories.
* View all associated test cases and requirements from the defect.

By centralizing defect management within Action Items, WalnutAI helps QA teams, developers, and product owners collaborate efficiently while maintaining complete visibility into every issue from creation to resolution.




---

[Next Page](https://docs.walnutai.ai/llms-full.txt/1)

