![Notes](https://static.zohocdn.com/zoho-desk-editor/static/images/file.png/)
Note:
- Generated scripts may not always be accurate, as is common with any AI. However, we are constantly refining it to maximize its reliability.
- Generated scripts are adaptive. The same prompt may generate different scripts at different times based on how much the machine has learned.
1. Deluge Zia Assistance in a Nutshell
Zia Assistance can generate Deluge scripts directly from the Deluge editor by understanding your requirements through conversational prompts. Zia Assistance leverages advanced technologies like Natural Language Processing (NLP) and machine learning, powered by
OpenAI, to make complex scripting more accessible and efficient. By following best practices in Deluge, it reduces potential errors and enhances the overall development process, providing optimized and reliable scripts to boost faster implementation.
![Idea](https://static.zohocdn.com/zoho-desk-editor/static/images/lights.png/)
2. Availability
- Available for paid plans of Creator
- Available across United States (.com), Europe (.eu), India (.in), Australia (.au), and Canada (.ca) data centers
3. Overview
Zia Assistance, powered by
OpenAI GPT-4o mini an advanced, reliable and cost efficient model that leverages Natural Language Processing (NLP). It generates Deluge scripts in Zoho Creator by interpreting your requirements through conversational prompts. Zia can be accessed directly from the Deluge editor within workflows or functions, offering real-time assistance for writing Deluge scripts. This accelerates and streamlines the scripting process. By analyzing the application's metadata, Zia generates optimized scripts that consider the existing relationships between forms. It also eliminates the unsupported tasks in the associated workflows or functions, making Deluge coding more user-friendly and error-free.
To access Zia Deluge Assistance in your Creator's Deluge editor, you'll need to complete a one-time setup, which includes:
- Creating an OpenAI API key - Since Zia operates on the OpenAI API, you must create an API key from your OpenAI account.
- Configue Zia and enable Deluge Assistance - Zia must be configured with the generated OpenAI API key to enable Deluge Assistance within Zoho Creator.
4. See How it Works
5. Business use cases
Case 1: Generate script to send invite mail
Consider a Zoho Creator Sales application used by an organization to manage sales activities. To enhance customer engagement, you can automatically send an invitation email whenever a new customer is added. Traditionally, this would involve configuring a workflow with an '
on success' action and writing a script using the
send mail task. However, with Zia Assistance, this process is streamlined. By providing a natural language prompt, Zia generates the required script by analyzing the workflow and application metadata.
As you can see, Zia smartly accesses form fields using the input keyword, as the script is written in the 'on success' workflow action. It also includes sample email content within the generated script.
- Whenever new customer data is added to the form, send an invitation email to the customer's address.
Case 2: Calculate the number of days between two date fields
Assume a Creator Project Management application with a Project Details form used to store relevant project information for planning and allocating tasks across your organization. To ensure the project stays on schedule, it's crucial to calculate the number of available business days between the start and end dates in the Project Details form, excluding weekends and public holidays. For this, a Deluge script is needed to determine the exact number of working days for a particular task. With Zia AI Assistant, you can easily generate this script by providing a prompt, as shown below.
- Write a script to calculate the number of working days between Start_date and End_date.
![Info](https://static.zohocdn.com/zoho-desk-editor/static/images/info.png/)
Info:
- Start_date and End_date are the two field link names of the date fields.
6. Set up Zia AI Assistant
6.1. Prerequisites
![Notes](https://static.zohocdn.com/zoho-desk-editor/static/images/file.png/)
Note: Ensure that your are in paid plan of OpenAI with sufficient API credits for
OpenAI API key to work.
You must have an OpenAI account along with the
API key to use this feature in Creator. To get the OpenAI API key:
- Navigate to Settings in your OpenAI account and select the Billing section.
![](https://help.zoho.com/galleryDocuments/edbsn3ac12388cdc0f1df677f5e2278741acb93c188617afa03b3059a43785b005363b66e478d8a2c025f313b1ea50b5438b3?inline=true)
- Click the Add Payment Details button in the Settings page and add your required details.
- Navigate to the API keys section and click Create new secret key.
![](https://help.zoho.com/galleryDocuments/edbsn78da32285c0b44064844d13e6419ca6e1a56bc66551c4eec5dfe8eab260f8b0d52ca91e24b6f73cb2201ff11de3902f9?inline=true)
- Enter a name (optional) and choose the required project. Click Create secret key.
![](https://help.zoho.com/galleryDocuments/edbsn92cba10ac240527666f68d8d6c566e0d1fb25f8c5afdc34d4e2aadae1f46177fdabf1064a7ea14f4eef697a4ecc31eab?inline=true)
Now, proceed to the
next section to configure Zia with the generated Open AI API key.
- Navigate to Operations in your Creator account.
- Click Zia in the Applications card. The Settings screen will appear.
![](https://help.zoho.com/galleryDocuments/edbsn1d3067a5aa3210ebc682d6ac211dcb35fe976dc488ae3ea455e99fc328f3ae5d1a5e34447fe81eab03289716fa7a9034?inline=true)
Note: If you have already added an API key, then proceed to step 6.
- Ensure the OpenAI model is selected from the drop-down in the Configuration tab and click the Add API Key button. A popup will appear.
![](https://help.zoho.com/galleryDocuments/edbsnf9751e30367021a8ee3c291b4903a3b64c14f61cead68bbb0b39107c1b8d3a8c489fb57db9030f337b05d32de51bd4eb?inline=true)
Note: Currently, Zia Deluge assistance is only supported with the OpenAI language model integration.- Enter your OpenAI API Key and click Add.
![](https://help.zoho.com/galleryDocuments/edbsn0eca232e2121beff8a34df317ef2e75f49cd0a47f4a858025b18da8a93bdac9e114d6e3bd277e90dd294ac196af6dc94?inline=true)
- To edit or update the key after adding it, click Edit. update the key in the pop-up that appears, and click Save.
![](https://help.zoho.com/galleryDocuments/edbsnfb52517defe19f5426da7d02e76f52a6d4d45030a182297e6020b94713713b5ecc02d6efe8216bf2881d0282a934f75e?inline=true)
![](https://help.zoho.com/galleryDocuments/edbsnaf782f764f07cff85233a958a47d09beb2fc04f226348cabf00d3de9d92f4bf46bb07c23b43014e80d25b5adb5526400?inline=true)
Refer to this page to know more about OpenAI's authentication.- Toggle the Access button beside Deluge Assistance in the Enable Features section. This button will be disabled by default. Enabling it will allow you to use the combined capabilities of Zia and OpenAI to generate scripts.
![](https://help.zoho.com/galleryDocuments/edbsn0851eb17ce38eae86f7977fb3db8aba0db56a1515e44d2a57f7513b8aeba494dae4f3d1f10a562c69507682542b87e6a?inline=true)
7. Generate a script with the help of AI
![Notes](https://static.zohocdn.com/zoho-desk-editor/static/images/file.png/)
Note: You can generate scripts using Zia from the Deluge editor across any workflows or functions. For demonstration purposes, we've used the Deluge editor in the
On Success workflow action to illustrate how to create scripts with Zia.
- Create a workflow to execute on a preferred event and click Add New Action > Deluge Script to open the Deluge Editor as shown in the video below.
- Click the Zia icon (
) in the editor to open the Zia Assistant chat window.
![](https://help.zoho.com/galleryDocuments/edbsn117c87b1976a5ee44144d66fd11e6a57857ecbb5339dba778c74e752897e137b0b48983ca469433cc2f83b888f398d48?inline=true)
- Type your prompt in the window that slides up. The relevant script based on your prompt will be generated by the Zia Deluge Assistant.
![](https://help.zoho.com/galleryDocuments/edbsn7fb8c55270561d5c5c555a56e8b74d0ffe6d7c818ab3fbc3e78d26c6fa38d8b893286b4bbcab16fb8e076ecaea50d634?inline=true)
- You can either copy the script by clicking the copy icon (
), or drag and drop it into the editor from Zia.
You can review the generated script and either use it directly in your workflows or modify it to meet your specific requirements. It is recommended to test the script's functionality by triggering the workflow in the application's live mode. For more streamlined development, you can enable environments and test the script effectively using the live mode of the
development or staging environment.![Notes](https://static.zohocdn.com/zoho-desk-editor/static/images/file.png/)
Note:
- Once you exit the Deluge editor, the prompts and responses within the Zia Assistant chat window will be cleared.
- You can use the thumbs up or down buttons to provide feedback on the generated script. By doing so, your prompt and script are shared with us for improving Zia's performance.
![](https://help.zoho.com/galleryDocuments/edbsnaf782f764f07cff85233a958a47d09bed05f6ca8583db56cd1fc8e4473ac568ecc1a00a9dcefa10bd4c9daae7be8fa88?inline=true)
7.1. Prompt guidelines
- It is recommended to use clear and appropriate language when entering prompts. The use of harsh or unclear language will result in inaccurate responses. For example, if you want to send an email to specific email addresses stored in a field of a form, it’s advisable to clearly mention the form name, the email field name, the criteria for selecting the emails, and the subject content in the prompt to generate a more precise and accurate script.
- You can specify the component name, link name, field name, or field link name along with the prompt to effectively utilize your created components for generating accurate scripts.
- Examples of well-structured prompts:
- “Create a script for sending email notifications to the address in the 'Email' field of the 'Orders' form to track the delivery of a product.”
- “Write a script to update an element in the collection variable and return the updated variable.”
8. Manage OpenAI API Usage
To view the monthly usage of OpenAI API:
- Navigate to Operations > Zia > Usage and click the Visit OpenAI button. You will be redirected to the OpenAI developer platform login page.
![](https://help.zoho.com/galleryDocuments/edbsn80955265c4e0af251ec6721165849931b865228898affbbba6353ba89fb7f7b592ebe8741e5ba212dd8212078a61b445?inline=true)
- Log in to your OpenAI account that contains the API key used for this integration and click Usage from your OpenAI Dashboard to view the monthly usage of APIs in your OpenAI organization. Learn more about OpenAI Usage Dashboard
9. Limitations
- The script generated may not be accurate, which is also the case with any AI. However, we are working on improving this.
- The generated scripts are adaptive, indicating the same prompt may yield different responses at various times based on how much the machine has learned.
- Based on your prompt and requirements, Deluge Zia assistance can generate scripts with capabilities like deleting records or modifying critical data. It is recommended to carefully review the generated code before execution to prevent unintended data loss or changes.
- OpenAI API Rate limits: Rate limits are restrictions that OpenAI's API imposes on the number of times a user or client can access their services within a specified period of time and vary based on their usage tier and the model consumed. Since Zia operates with the OpenAI API key, the rate limits are applicable to it as well. To check the rate limit for your account associated with the API key used in this integration, visit https://platform.openai.com/account/limits.
- Along with your prompts, our system will add supplementary prompts to enhance the accuracy of the script generation process. These system prompts will also contribute to your OpenAI token usage.
- A user can only give up to 20 prompts per minute.
- Zia Deluge Assistance is not available in page scripts and application IDE.
- The script generated by Zia will not include custom functions calls, App variables, Connections, and User details in your Zoho Creator Account.
- Understand Zia features in Creator
- Create forms using Zia assistance
- Generate field suggestions for AI assisted forms