---
sourceDocument: Brazil Build or modify applications
sourceDocumentLink: https://www.servicenow.com/docs/r/application-development

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Install the Task Mining agent

# Install the Task Mining agent {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
The Task Mining agent is a service installed on workstations that logs certain events from desktop applications.  
Role required: Task Mining Agent Install  
Note:  
You must be a part of the Task Mining Agent Install group with roles itil, sn_tm_core.service_user, and agent_client_collector_admin to install the Task Mining agent. If the group doesn't exist, create a group with that name and those roles manually. For more information, see [Assign a role to a group](https://www.servicenow.com/docs/access?context=t_AssignRoleToGroup&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).  
The process to install a Task Mining agent is as follows:

1. A data request is submitted by a Task Mining analyst or power user.

   When a Task Mining adds a workstation user to a Task Mining project, a data request is sent to all managers of every workstation user. For more information, see [Add workstation users to a Task Mining project](https://www.servicenow.com/docs/dVz~pF2I~TyszDyGuqipZQ "Select workstation users you want to collect activity data from and create data requests.").
2. The manager approves the data request.When the manager approves the data request, the Task Mining agent can be installed. For more information, see [Approve workspace user data collection](https://www.servicenow.com/docs/cMue6euqVJcH4GfxUIQByA "Approve data requests from Task Mining analysts to enable workstation user data collection.").

3. Installation is performed by an IT or security user who is a part of the Task Mining Agent Install group with admin rights on the target workstation.

   For more information, see the article in the Now Support Knowledge Base for your operating system:
   * [Install the Task Mining agent for macOS](https://www.servicenow.com/docs/GehQdqE1bDoFe49zvq2zQg "Install the Task Mining desktop agent on macOS workstations and deploy the Task Mining agent to managed macOS devices using JAMF. This procedure creates the package, scripts, policies, and configuration profile required for enterprise deployment.")
   * [Install the Task Mining agent for Windows](https://www.servicenow.com/docs/Zy6hGBrjSgoadO7ilC2VbA "Install the Task Mining desktop agent on Windows workstations using the installation wizard. Convert the agent installer to .intunewin format and deploy it to managed Windows devices through the Microsoft Intune admin center.")
   * [Install the Task Mining Portable Windows agent](https://www.servicenow.com/docs/tSlzKqbXBaxfSVa6Mx~Vrw "Run the Task Mining agent from a portable archive without installing it on the system. The portable agent does not modify the Windows registry or write files outside its extracted folder.")

   {#install-agent__ul_sx2_zkt_sgc}  
   Note:  
   Use the standard Windows Agent unless instructed otherwise. The Portable Windows agent is only designed for users in a proof of concept state and shouldn't be used in production.
4. Workstation users are notified about workstation monitoring.
{#install-agent__ol_rx2_zkt_sgc}

For more information about the data collected, see [Data collected by Task Mining](https://www.servicenow.com/docs/A8WLvcaBEDBlxOU4WBWnFw "Task Mining collects workstation and user categories of data.").