Project Overview -> Create project

Create project

Summary

This page provides a straightforward way to initiate new Smart Automization projects. You have the flexibility to begin your project by uploading a pre-existing configuration file, leveraging an AI assistant to generate project details based on your description, or simply starting a new project with a blank slate. Each method guides you towards a project editing screen where you can further define and refine your automation.

Page Access

You can access this page by navigating to: /automization

Page Functionalities

Option 1: Upload from JSON

Button: "Upload Project JSON" - Click this button to select a JSON file from your computer. This file should contain the basic setup for your project.

Option 2: Generate with AI

Text Field: "Describe the goal of your project..." - Enter a detailed description of what you want your project to achieve. The AI will use this information to propose a project setup. Ensure your description is at least 16 words long for the AI to provide a good suggestion.

Button: "Generate Project" - After entering your description, click this button to start the AI generation process. A progress indicator will show that the AI is working, which may take up to two minutes.

Option 3: Generate empty project

Text Field: "Project name" - Enter a unique name for your new project.

Button: "Create Empty Project" - Click this to create a new project with the name you provided, starting from scratch.

Scenario Executions

Possible usage steps within this page

Scenario 1: Uploading a project from a valid JSON file

  1. Click the "Upload Project JSON" button.
  2. A file dialog will appear. Select a valid .json file that contains your project's configuration (e.g., project name, description, agent type).
  3. The system will process the file, and if successful, you will be taken to the project editing page with your project details pre-filled.

Scenario 2: Generating a project using AI with a valid prompt

  1. In the "Describe the goal of your project..." text field, type a clear and detailed description of your project's objective (at least 16 words). For example, "I want to create an automated system that checks my email inbox daily for new messages from 'sender@example.com' and, if found, extracts the attachment and saves it to a specific folder on my cloud storage."
  2. Click the "Generate Project" button.
  3. A progress indicator will appear, showing that the AI is working on your request. This may take a moment.
  4. Once the AI finishes, you will be directed to the project editing page with the AI-suggested project details.

Scenario 3: Creating an empty project with a name

  1. In the "Project name" text field, type a desired name for your new project. For example, "My New Automation Project".
  2. Click the "Create Empty Project" button.
  3. You will be navigated to the project editing page, where you can start configuring your new, empty project from scratch.

Possible errors which may occur on this page

Error: Missing required fields when uploading a JSON file

If the JSON file you upload is missing essential information like the project name, description, or agent type, an error message will appear at the bottom of the screen, listing the missing fields. To fix this, ensure your JSON file includes all necessary details before re-uploading.

Error: Invalid JSON file format

If the file you select is not a valid JSON format, or if it's corrupted, an error message indicating a JSON parsing error will be displayed. Please check your file's integrity and format and try again.

Error: Prompt is too short for AI generation

When using the "Generate with AI" option, if your description in the text field is too short (less than 16 words), an error message will prompt you to provide a more detailed project goal. The AI needs sufficient information to generate a meaningful project.

Error: Project writing agent failed or was cancelled

If the AI agent encounters an issue during generation or if you manually close the AI agent window before it completes, an error message will indicate that the project writing agent failed or was cancelled. You may need to try again with your prompt.

Error: Agent returned an error result

After the AI agent process, if the agent itself reports an error (e.g., it could not generate valid project data based on your prompt), a message will appear stating "Agent returned error." This means the AI could not successfully generate the project data.

Error: No project name entered for an empty project

If you attempt to create an empty project by clicking the "Create Empty Project" button without entering a name in the "Project name" text field, an error message will remind you to provide a name. Please enter a suitable name for your project to proceed.