Cloud BOT DocsRequest to AI (Cloud BOT Operator)
Home > User guide > BOT > How to use the BOT editor > Request to AI (Cloud BOT Operator)
About Cloud BOT Operator
The Cloud BOT Operator is a feature that enables an AI agent to automatically perform browser operations based on user-provided instructions (prompts).
The execution of the Cloud BOT Operator uses transactions.
*Learn more about transactions here.
*Learn more about transaction usage guidelines here.
Execute Cloud BOT Operator
The Cloud BOT Operator can be executed as part of an automated procedure in Cloud BOT.
When the "Operator" button within the task is clicked, a prompt input window is displayed.
Once a prompt is entered and OK is clicked, a task is added that executes the Operator according to the provided prompt.
Selecting a Model
Select the model to be used.
Structure Recognition - ECO ：Ideal for simple operations with low cost.
Structure Recognition - ECO Reasoning：Ideal for simple operations with low cost, with reasoning capabilities for more complex decision-making.
Structure Recognition - Smart：Offers high performance, flexibility, and stability.
Structure Recognition - Smart Reasoning：Offers high performance, flexibility, and stability, with reasoning capabilities for more complex decision-making.
Visual Recognition：High-performance model enabling operations through visual recognition.
Writing Prompts
The prompts describe what you want the Cloud BOT Operator to do in natural language.
It is not interactive, so instructions should be entered together.
Referencing Data Stored in the BOT
Values stored as BOT data can be referenced using the format ${dataName}.
By clicking the “Refer to Data” button, available data can be browsed and inserted into the prompt.
Setting Data to Retrieve
Specify the data name and data description of the data you want Cloud BOT Operator to retrieve.
About “Data description (Referenced by Operator)”
By entering a description of the target data, the Cloud BOT Operator is better able to retrieve it accurately.
Example : If the data name is set to "ID" but the label shown on the screen is “Username,” the AI may fail to identify the correct value.In this case, entering a clear positional or contextual description in “Data description”—such as“The number shown to the right of the username” can improve accuracy.
Example : “Data Description” can also be used to store the result of AI-based analysis or summarization, such as “Summarize what this page is trying to communicate”.
Setting the maximum
Limits can be set for Cloud BOT Operator execution.
If any of the set thresholds are exceeded, the task results in an error.
Maximum execution time : Set the upper limit of execution time in “seconds”.
Maximum reasoning steps : One step consists of a thought and an action. The upper limit for the number of steps can be configured.
Maximum transaction usage : The upper limit for transaction usage can be configured.
The upper limit for transaction usage can be configured.
Transactions are counted per thought step. When the cumulative usage exceeds the limit, the task results in an error.
However, the step in progress is still executed to completion, and its transaction usage is also counted—even if the limit is exceeded.
Approximate Transaction Usage
The amount of transactions used is only a guide and will vary depending on the page being operated on.
Please be sure to check how many transactions are used per step.
| Model | Approximate Transaction Usage |
|---|---|
| Structure Recognition - ECO | 100-300 reasoning steps / 100 transactions |
| Structure Recognition - ECO Reasoning | 100-300 reasoning steps / 100 transactions |
| Structure Recognition - Smart | 5-15 reasoning steps / 100 transactions |
| Structure Recognition - Smart Reasoning | 5-15 reasoning steps / 100 transactions |
| Visual Recognition | 1-5 reasoning steps / 100 transactions |
Execute Cloud BOT Operator by specifying a selection
Specifying a Selection Range
When a selection range is defined, the Cloud BOT Operator processes only the content within that range.
Information outside of the selection range is not recognized by the Operator.
*More on adjusting the selection range here.
Specifying Multiple Selection Ranges
When elements with the same structure are repeated, multiple selection ranges can be specified.
Information outside of the selection range is not recognized by the Operator.
*More on adjusting the selection range here.
*This function is only available with structural recognition models.
Prompt Examples
In order to correctly convey your intentions to the Cloud BOT Operator, it is important to describe “what you want us to do” in a clear, straightforward, and specific manner.
Enter a concise summary of the necessary information, such as what you want them to do and how you want them to acquire it.
| Operation | Example Prompt |
|---|---|
| Enter the necessary information in the input form. *It is assumed that the information required for input is data reference from the input value. | Please enter the following information in the form Name: ${Name} Contact Person Name: ${Contact Person Name} Email Address: ${Email Address} Newsletter Subscription: ${Newsletter Subscription} Inbound Pathway: ${Inbound Pathway} |
| Clicking a button | Click on the blue button that says “Submit. |
| Retrieving data | Obtain a member ID. Data to be retrieved Data name: Member ID Data description: The number to the right of the user name. |