From within a project

1. Click on the required project in the Home page.
   
   
   
   

2. Navigate to Settings > Agents.
   
   

Note: If your agent is in a Yet to Connect state, it requires your attention, as the registration process may not have completed successfully. This could be due to several reasons:

1. The code entered may be incorrect. In this case, try regenerating a new code.

2. The agent may have been down during the registration process. Wait for some time and try again.

3. There could be a network or server issue. Ensure your network connection is stable.

To resolve the Yet to Connect state, click Update, which will open a pop-up window to retry the registration process. Enter the new code in the pop-up and click Update to complete the registration. If the issue persists, contact support at support@zohoqengine.com.

Alternatively, you can register your agent either from within a specific project or while customizing a test case run in that project.

1. From the Select Agent field, click +Register Agent.
   
   
   

2. Provide an agent name and paste the registration code you copied. Click Register.
   
   
   

You can associate your projects with any registered agents using the following steps:

1. From Projects, navigate to Settings and select Agents.
   
   
   
   

2. Click Add Agent.
   
   
   

3. Select the agent you want to add and click Save.
   
   

5.  Manage Agent  

• View Agents

• Edit Agent

• Delete Agent

 5.1  View Agents  

To view the list of registered agents, follow the steps below:

1. Click on the required agent to view its configuration details.
   
    

2. View the respective Agent Information, number of Parallel Threads, associated Projects, the Browser Option, and the connected devices.
• Agent Information - This includes comprehensive agent information, including agent name, computer name, version, and IP address.
  
  
• Parallel Thread - This refers to the simultaneous execution of multiple test cases that the agent can handle concurrently. This gives the maximum count of how many parallel execution of test cases are possible with your agent.

Note: The count is according to the machine's configuration.

• Projects - This is the list of projects associated with this agent.
  
  

• Browser Option - This gives the list of browser versions available in your machine.

 5.2 Edit Agent  

Note: When an agent is edited from within a project, only the Agent's name and Number of threads can be edited.

 5.3 Delete Agent 

Note: If any of the agents are used in test plans, they'll have to be removed from those test plans before they can be deleted.

6. Agent Troubleshooting and Logs

This allows users to send logs to the Zoho QEngine team for support, issue resolution, or problem diagnosis.

Note: This action can only be performed from the Agents section within the respective projects.

1. Click Send Logs.
   
   
   

2. If needed, you can add any relevant comments to help provide more context for the logs. This step is optional.
   
   
   
   

3. Click Send.
   

7. Points to Note

• The agent is optional to use, and is needed only when you want to run tests locally on your machine. You can also simply use the default agent that comes with Zoho QEngine if running tests on cloud is not a concern, in which case you don't need to have any agent installed.
• You can only install one agent per machine.
  

8. Related Links 

• Download and Install Agent Application
• Live Preview
• Test Plans
  
• Results