Article verified for Release 16.0 on February 3, 2026.
The AI Orchestrator allows you to perform actions in the application using simple, natural-language commands. Instead of manually navigating through different pages, you can instruct the Orchestrator to complete tasks for you, such as creating users, tests, or surveys, assigning candidates to groups or sessions, and more.
The Orchestrator helps streamline workflows and speeds up repetitive actions by executing commands directly from a single interface.
Note: This feature is included in the EE package. If you are unsure whether your environment includes this package, please contact sales@youtestme.com or your designated account manager for confirmation.
Enabling the Orchestrator
-
Navigate to Users > Roles and Permissions.
-
Locate and edit the desired role.
-
Enable the Access AI Orchestrator permission.
-
Click Update to save your changes.
Important Note:
This feature is designed to make content creation faster and more efficient. When enabled, it automatically grants all content creation permissions to the selected role, including creating testing sessions, tests, surveys, training courses, users, and more.
For this reason, ensure that this permission is assigned only to appropriate roles. Roles such as Student should not have this permission enabled, as it would allow them to create and interact with content within the application beyond their intended access level.
Accessing the Orchestrator
To access the Orchestrator, follow these steps:
In the top-right corner of the application, select Orchestrator.
A pop-up window will open, allowing you to start interacting with it.
Using the Orchestrator
Once the Orchestrator is open, you can begin issuing commands and managing actions.
-
Enter the command you want to execute in the input field.
Use clear and concise instructions to describe the action you want the system to perform. -
Select the Send command to submit your request.
The Orchestrator will process the command and execute the corresponding action in the application. -
Tips and Tricks
Use this section to explore ready-made examples of common actions. It includes sample prompts that demonstrate how to phrase commands for tasks such as creating users, assigning tests, or managing sessions. -
Glossary
This section provides guidance and rules for writing effective prompts. Following these rules helps ensure the Orchestrator correctly understands your commands and performs the expected actions. -
Configuration
Here you can view configuration details related to the Orchestrator, including information about the API token used for secure communication. -
Debug Monitor
The Debug Monitor displays detailed information about each executed command. It shows the action that was triggered and the data sent for processing, which can be useful for tracking execution flow or troubleshooting unexpected behavior.
Examples
Example 1: Successfully Executed Command
Prompt
Create three questions about geography and insert them into the question pool with id 12881.
Result
The command is executed successfully, and three geography questions are created and added to the specified question pool. Each question includes the required structure (question text, answer options, and a correct answer).
Example 2: Unsuccessful Command Execution
Prompt
Create a test.
Result
The command fails because the request is too general and does not include enough information to create a test. To execute the action, the prompt must be clear and detailed.
