Building and Deploying Custom AI Agents in Zoho Desk - Online Help | Zoho Desk

Building and Deploying Custom AI Agents in Zoho Desk

Businesses can build custom agents in Zoho Desk that perform various support activities and also run processes autonomously with human-in-loop wherever the workflow requires. For example, automatic content creation from ticket conversations, classifying, triaging, and replying to tickets in one action, recommend next steps to guide support reps.

The agents are configured via Agent Store directly accessible from the Desk interface. The created agents are deployed either as digital employees that perform specialized actions or via connection where they are invoked on API call for example, send reply, get articles, read threads.

Actions that the agent can perform or the department it can access are regulated by permissions. These controls determine the departments in which the agent can work and the actions it can perform. For example, an agent without permission to send replies cannot send ticket replies.

Setting up Zoho Desk and Zia Agent integration

Administrators can setup integration with Zia agents from marketplace to start building custom agents or hire pre-built agents from with the Zoho Desk interface. During setup the primary contact's email address and the portal (Desk account) must be selected to ensure the integration is enabled for the respective portal.
Notes
Note:
  1. To change the portal, you must first disable the integration and then select the new portal and re-authorize the integration.
  2. Disabling the integration doesn't impact the deployed agents. The agents will continue to function in the respective account.
  3. Disabling a portal simply removes the options: New agent and Hire agent from the Zoho Desk screen. You can still build custom agents from Zia agents and deploy them independently. You can also hire agents from the store.
To integrate Zoho Desk with Zia Agent
  1. Go to Setup > Integrations > Zoho > Zia Agents.
  2. In the Configuration details tab, enter the Primary email address and select the Portal or Desk account from the drop-down list.
  3. Click Authorize.
  4. Click Ok, in the success message dialog box.
  5. Click Go To Zia Agents, to Build or Hire an agent. 

Creating custom AI agents  

Alert
Building custom Zia agents and Hiring agents from the Agent Store are available for all paid editions. It is currently available for the following DCs: US, IN, CN, EU, AU, and JP. 
Admins can create single or multi-agent system in Zoho Desk using two option:

Creating agents from scratch

  1. Describe the business use case and the what the agent needs to do in the agent instructions.
  2. Select a suitable LLM model from Zoho Hosted or OpenAI models.
  3. Set Guardrails to prevent hallucinations and define what the agent must not do.
  4. Add system tools that connect the right application to the right action through APIs. You can also build custom tools from the available APIs in Zoho Desk. The tools determine the input and output from the agent. Example, get all overdue tickets and send a reply with 'xyz message'.
  5. Include Knowledge base for the agent's reference example skill files, style guides, web scraped content etc.

Creating agent with Zia AI (prompt-based)

Users need to briefly explain their use case based on which the system will build the agent. The system will draft agent instruction, role, and description that aligns with the prompt. Users can then modify the instructions, include custom guardrails, and tools as needed. Prompt-based approach gives a framework to begin with.
Alternately, you can also select an agent from the picker which will auto-populate the prompt and build the complete agent with the requisite tools, instructions, models, and guardrails. You can always edit it to match the requirements.

To create agents in Zoho Desk from the agent store
  1. Navigate to Zoho Desk Setup > User Management > Zia Agents.
  2. Click New Agent.
    You will be redirected to Agent Studio.
  3. Select Create with Zia AI.
  4. Describe your use case or select an already available agent from the available list.
    If you select an agent, the prompt for the selected agent will be displayed in the textbox for you to edit as needed.
  5. Edit the Basic information and other details as needed.
  6. Click Create.
    Once the agent is created it needs to be deployed to make it operational.

Deploying an agent in Zoho Desk

Once the agent is created it will listed under Active AI agents in Zoho Desk (Setup > User management > Zia agents > Active AI agents). These agents need to be deployed in two ways:
  1. Digital employee
  2. Using connection
While deploying the appropriate tool params must be selected and the connection should be built with the right Zoho Desk account or portal. Once deployed the Active AI agents will list all the active deployed agents. 

Deploying agent as digital employee

To deploy the agent as digital employee
  1. Go to Agent Store (agent.zoho.com) or go to Desk Setup > User management > Zia Agent.
  2. Select the agent and click Deploy.
  3. Select Deploy as digital employee.
  4. In Tools Param mapping, provide the necessary details.
  5. Click Next.
  6. In Service Deployment details, select the right portal or account to which the connection will be established.
  7. Click Deploy.
  8. In the Consent form, click Continue.
    You will be redirected to Applications and Portals for further steps. 
  9. In Applications and Portals, click Continue.
  10. In Applications Roles and Permissions, select the permission as Agent, Admin,  Light Agent, or Custom.
  11. Select the Departments to which the agent will have access to.
    You can select all departments too.
  12. Click Save and then click Continue.
  13. In Agent Details, enter Agent First Name and Last Name eg., John Smith or Ticket Finder Agent.
  14. An email address will be auto-generated using the first name and last name.
    The complete email address will look like this: john_.smith.zde5489@ziaagents.ai
  15. Click Continue.
    The agent will be successfully deployed. 

Deploying agent using connection

To deploy the agent through connection
  1. Go to Agent Store (agent.zoho.com) or go to Desk Setup > User management > Zia Agent.
  2. Select the agent and click Deploy.
  3. Select Deploy by connection.
  4. In Tools Param mapping, provide the necessary details.
  5. Click Next.
  6. In Service Deployment details, under Choose Portal the portal or account authorized during integration setup will be preselected.
    The portal cannot be changed here. If you want to change you need to re-authorize the connection from integration.
  7. In Associate a connection, select a Desk account or click New > Connect > Allow the connection.
    You will be redirected to the Zia Agent interface.
  8. Click Deploy.
    The deployed agents can be viewed in the Desk > User management > Zia Agents > Active AI agents list view. 

Hiring ready-to-use agents from the Agent Store  

The Agent Store provides ready made agents that perform specialized functions such as Ticket classifier, next step recommender etc. Users cannot modify these agents, that is agent instruction, model, and other configurations cannot be changed.
Businesses can directly hire these agents and let them perform the specified actions in their Desk workplace.
Notes
Note: Hiring an agent doesn't mean its deployed. Once hired the agent will be listed under Active AI agents. It will be fully functional only after its deployed.
To hire agents from Agent store
  1. Navigate to Setup > User management > Zia Agents > Agents store tab.
  2. Select an agent and click Hire.
  3. In Confirm Hiring popup, edit profile to change the name, email address and other personal details.
  4. Check I allow the vendor of the agents to contact me regarding news, promotions, offers, and other relevant updates, if needed.
  5. Scroll and under Hiring details, select the Desk portal (Desk org account) from the dropdown.
  6. Check the Terms and Conditions checkboxes.

  7. Click Hire.
    You will be redirected to the Zia agent page.

  8. In the Zia agent page, click Deploy and select Deploy as connection or Digital employee.
  9. To deploy follow the steps mentioned above under Deploy agents from the store. 

Deploying Zoho Desk's pre-built agents

Alert
Pre-built agents are available for Professional and Enterprise editions. It is currently available in the following DCs: US and IN. 
Zoho Desk offers pre-configured agents that can be directly used without deploying or hiring. The prebuilt agents support specialist and resolution expert are equipped to answer L1 queries and commonly asked support questions autonomously and draft resolutions for closed tickets for customer support teams reference.

Read more about Pre-built digital agents in Zoho Desk

Deactivating the deployed AI agents   

The deployed agents will be listed under Active AI Agents, users can view the departments to which the agent is associated with, the role of the agent, and the permission from this list view.
To deactivate an agent
  1. Navigate to Setup > User Management > Zia Agents > Active AI Agents.
  2. Select the required agent.
  3. Toggle the status to Deactivate the agent.

Reviewing AI agent activity  

Actions performed by the AI agents are recorded in ticket history with the AI agent’s name for identification.