Skip to main content

Builder - Projects

Updated this week

The Projects page in the Builder lets you create and manage integration projects. Each project links to a registry module that defines the AI Employee's conversation flows, events, and behaviors. Use this page to add projects, assign modules, and publish builds.

Access the Projects page

  1. Open the Builder.

  2. Click Projects in the left sidebar.

The Projects page displays a table of all projects with the following columns:

Column

Description

Idn

Unique identifier for the project.

Title

Display name.

Description

Optional description text.

Auto Update

Badge showing Enabled (green) or Disabled (gray).

Registry

Registry the project pulls its module from.

Module

Module assigned to the project.

Module version

Current module version, or Latest if set to auto-select.

Created At

Date and time the project was created.

Updated At

Date and time the project was last modified.

Version

Project version number, or N/A if not set.

Create a project

For a step-by-step walkthrough, see Create a new project.

  1. Click the three dots icon in the top-right corner of the Projects page and select Create New Project.

  2. Fill in the project form fields described in the table below.

  3. Click Create.

Edit a project

  1. In the project row, click the three dots menu.

  2. Select Edit Project.

  3. Modify the fields and click Save.

Initialize a project with force update

After creating a project, you may need to force an update to pull the module and finalize the setup.

  1. In the project row, click the three dots menu.

  2. Select Force Update Project.

The system fetches the latest module version from the registry and applies it to the project.

Make a project image

A project image is a snapshot of the project's current state. Use it to create versioned releases.

  1. In the project row, click the three dots menu.

  2. Select Make Project Image.

  3. The Idn field defaults to [project_idn]_[YYYY_MM_DD]. Adjust it if needed.

  4. Select the Storage where the image will be saved.

  5. Click Create.

Project images appear on the Storages tab of the Version Control page. From there you can release them to a registry. See Builder - Version Control for details.

Delete a project

  1. In the project row, click the three dots menu.

  2. Select Delete Project.

🚨 WARNING

Deleting a project removes it permanently. This action cannot be undone.

Project detail page

Click Manage on any project row to open the project detail page. The detail page has two tabs: Agents and Libraries.

Agents tab

The Agents tab lists all agents assigned to the project. Each agent row shows:

  • Agent idn

  • Creation date

  • Linked persona

  • Description

Expand an agent row to see its flows. Click a flow name to open the Flow Designer.

To add an agent, click the create menu and select Create Agent.

Libraries tab

The Libraries tab lists shared libraries associated with the project. Each library row shows the library idn. Click a library name to open its editor.

To add a library, click the create menu and select Create Library.

Publish a project

The Publish button appears in the top-right corner of the project detail page. Publishing bundles the project's agents and flows into a deployable build and sends a start update event to the runtime.

  1. Open the project detail page by clicking Manage on the project row.

  2. Click Publish "[project name]" project.

After publishing, the button disables for 10 seconds while the system synchronizes the build.

❗❗ IMPORTANT

Publishing a project deploys the current version of all agents and flows. Make sure all flow scripts are saved and published before you publish the project.

Did this answer your question?