The TDM Agent is an AI-assisted task search capability available in the TDM App. It makes it easier to find and prepare TDM tasks using natural language.
Instead of browsing or filtering through the task list and then manually provisioning the data, testers can simply describe what they want to do. The TDM Agent identifies the most appropriate task, opens it, and pre-fills its editable execution attributes based on the user's request. When needed and allowed, it also adds new attributes. The tester can then review the suggested values, make any necessary changes, and execute the task.
This makes task execution faster and easier, particularly for users who may not be familiar with the available tasks or their configuration options.
The TDM Agent is available in addition to the existing search option in the Manage Your Tasks window. It does not replace the existing search functionality.
The TDM Agent can be used through the following channels:
| Channel | Used by | Description |
|---|---|---|
| Chat in the TDM App | Testers and developers | Describe a data need in the chat, for example "I need 6 VIP customers with an address in New York City". See Using the TDM Agent in the TDM App. |
| REST API | CI/CD pipelines and test-management tools | Submit a user story with its test cases and get back a prepared execution per test case. Available starting from TDM 10.1. See Invoking the TDM Agent via API. |
| MCP tools | MCP clients, such as AI assistants and IDEs | TDM lookups (Business Entities, environments, parameters, tasks and execution status), and tools to save an execution draft and start a task execution. See TDM MCP Tools. |
For how the TDM Agent is built, see TDM Agent Architecture. For the data it sends to the LLM and its security controls, see TDM Agent Security and Privacy.
Install Fabric 8.5.x or later.
To enable the TDM Agent, complete the following steps:
apps.json file. In the TDM application entry, set the showChat attribute to true. This attribute is set to false by default.Important notes:
- The TDM deployment is required to run the
initRefreshTaskDescBroadway job, which is configured during the TDM deployment. This job uses the LLM to scan the TDM tasks and update their descriptions in a dedicated table. The TDM Agent uses this information to match tasks to user requests. Deleted tasks (tasks with an Inactive status) are ignored by this job.- If you upgrade your TDM project from a version earlier than 10.0.1, verify that the
java.project.referencedLibrariesattribute in the workspacesettings.jsonfile contains the following JAR path:/opt/apps/fabric/workspace/fabric/lib/fabric/fabric-task*.jar.- The TDM Agent writes its log messages at the DEBUG level. To view the TDM Agent messages in the Fabric log, set the log level to DEBUG.
The TDM Agent evaluates permissions based on the identity and Fabric roles of the user who activates the agent. The agent proposes and prepares only tasks that the user is permitted to execute, and the execution is validated against the user's TDM permissions.
The TDM Agent currently searches Business Entity (BE)-based tasks only. It does not search table-level tasks.
The TDM Agent currently supports the following task actions:
The TDM Agent is an AI-assisted task search capability available in the TDM App. It makes it easier to find and prepare TDM tasks using natural language.
Instead of browsing or filtering through the task list and then manually provisioning the data, testers can simply describe what they want to do. The TDM Agent identifies the most appropriate task, opens it, and pre-fills its editable execution attributes based on the user's request. When needed and allowed, it also adds new attributes. The tester can then review the suggested values, make any necessary changes, and execute the task.
This makes task execution faster and easier, particularly for users who may not be familiar with the available tasks or their configuration options.
The TDM Agent is available in addition to the existing search option in the Manage Your Tasks window. It does not replace the existing search functionality.
The TDM Agent can be used through the following channels:
| Channel | Used by | Description |
|---|---|---|
| Chat in the TDM App | Testers and developers | Describe a data need in the chat, for example "I need 6 VIP customers with an address in New York City". See Using the TDM Agent in the TDM App. |
| REST API | CI/CD pipelines and test-management tools | Submit a user story with its test cases and get back a prepared execution per test case. Available starting from TDM 10.1. See Invoking the TDM Agent via API. |
| MCP tools | MCP clients, such as AI assistants and IDEs | TDM lookups (Business Entities, environments, parameters, tasks and execution status), and tools to save an execution draft and start a task execution. See TDM MCP Tools. |
For how the TDM Agent is built, see TDM Agent Architecture. For the data it sends to the LLM and its security controls, see TDM Agent Security and Privacy.
Install Fabric 8.5.x or later.
To enable the TDM Agent, complete the following steps:
apps.json file. In the TDM application entry, set the showChat attribute to true. This attribute is set to false by default.Important notes:
- The TDM deployment is required to run the
initRefreshTaskDescBroadway job, which is configured during the TDM deployment. This job uses the LLM to scan the TDM tasks and update their descriptions in a dedicated table. The TDM Agent uses this information to match tasks to user requests. Deleted tasks (tasks with an Inactive status) are ignored by this job.- If you upgrade your TDM project from a version earlier than 10.0.1, verify that the
java.project.referencedLibrariesattribute in the workspacesettings.jsonfile contains the following JAR path:/opt/apps/fabric/workspace/fabric/lib/fabric/fabric-task*.jar.- The TDM Agent writes its log messages at the DEBUG level. To view the TDM Agent messages in the Fabric log, set the log level to DEBUG.
The TDM Agent evaluates permissions based on the identity and Fabric roles of the user who activates the agent. The agent proposes and prepares only tasks that the user is permitted to execute, and the execution is validated against the user's TDM permissions.
The TDM Agent currently searches Business Entity (BE)-based tasks only. It does not search table-level tasks.
The TDM Agent currently supports the following task actions: