Building an app

An application links an AI model to your instructions and data to carry out a task. You create it with a name, configure its three parts — the model, the data it collects and the instructions it follows — then activate it so it can run reasonings. From your applications list you open an app to see its status and configuration, and from its settings you can rename it, change its logo, publish it to the catalog or delete it.

Before you start — Creating apps depends on your plan: each plan allows a number of custom applications. If you've reached the limit you'll see Creation unavailable with a link to View plans. See Plans & billing.

Find your applications

The Applications area lists everything you have built in this project, and is where every other task below starts. It carries a tab bar — Overview, All my applications, Search and Create an application.

1. Open My applications, then click the All my applications tab.
2. Read the row for the app you want: Application, Status, Model, Data, Instructions, Visibility, Statistics and Created on.
3. Click Details at the end of the row to open the app.

Model, Data and Instructions each read Configured or Not configured, and Visibility is Private or Public on every row, so you can see at a glance which apps are ready and which are published. Use Previous and Next to browse, or the Search tab to find an app by name.

With no apps yet the tab shows Your application / Create your customized application tailored to your needs. and a Create an application button.

Create an application

Create an application is both the last tab of the tab bar and the button on the empty All my applications tab. The tab opens the form full size; the empty-state button opens the same form in a panel over the list.

1. Open My applications, then click Create an application.
2. Enter the Application Name and a Description of what it does.
3. Click Save.

The app is created as a draft on its Overview tab, ready to configure. If you leave a field empty you'll see Please enter the name of your application. or Please enter your application's description.

Note — Only the Create an application button shown when the project has no application yet opens in a right-hand panel, so you never lose the list you started from: Close leaves without creating anything, View full page at the foot of the panel opens the same form full size, and the page behind the panel reloads as soon as the panel closes. From the Create an application tab the form is a page of its own, with no panel and no View full page link; Close takes you back to your applications.

Read an application's Overview

An application's record opens on Overview, and its own tab bar sits under its name: Overview, Configuration and Settings.

1. Open the app from All my applications with Details.
2. Read the Statistics card: Private counts the runs your own project made, Public the runs other projects made of it through the catalog, and Total the two together.
3. Read the Information card: Status, Visibility and the app's Identifier.
4. Read the Configuration card: Model reads Configured or No model, Data reads Configured or No data available., and Instruction reads Configured or No instructions available.
5. Use the action at the top right — Access to run the app, Configure to finish setting it up, or Activate my application to put it into service.

Note — Public counts runs only for an app you published to the catalog; it stays at 0 for a private app. Both figures are rounded on the same scale as every other tally in the workspace, so a large count reads as 1.2k rather than in full.

Configure the model, data and instructions

A draft app needs three things before it can run: a model, its data fields and its instructions. You set them all from the Configuration page.

1. Open the app, then click Configure — or click Configuration in the tab bar under the app's name.
2. Under Model Selection, click Select a model and pick one — see Choosing a model.
3. Under Collect data, click Add data to define each input field the app asks for at run time (see the task below).
4. Under Transmission of Instructions, click Add instructions to tell the app what to do with the input (see the task below).

Every one of those actions — and the Edit and Delete beside a field or an instruction — opens in a panel that slides in from the right, over the page you are on. Save, and the panel closes and the page behind it reloads with your change. Close leaves without saving; View full page at the foot of the panel opens the same form full size.

Note — To check at a glance what is still missing, read the Configuration card on the app's Overview tab: Model, Data and Instruction each answer Configured or name the gap.

Tip — The How this configuration works box at the foot of the page explains the three building blocks — The model, The data and The instructions — and how they are assembled on each run.

Tip — The heading of the Configuration page is a breadcrumb: Application › the app's name. Click Application to go back to your list.

Add a data field

Data fields are the inputs your app collects from whoever runs it.

1. On the Configuration page, under Collect data, click Add data.
2. Enter the Field name — the name shown to the user during the run.
3. Choose the Field type (for example a single-line input, a text area, a number or an email).
4. Set Field requirement to Required or Optional.
5. Click Save.

The field appears in the configuration with a live preview. You can Edit or Delete it later. At least one field must stay Required.

Ask for a document or an image

Two of the field types collect a file instead of typed text:

• Upload a document — the app reads the text of a PDF, DOCX, XLSX, CSV or TXT file.
• Upload an image — the app looks at a picture (PNG, JPG or WebP).

They are chosen exactly like any other Field type, at step 3 above. At run time the field shows a list of the files your project has already sent, plus an Upload a document / Upload an image link that opens the upload panel; once the panel closes, the new file is in the list. Files are limited to 2 MB each and stay inside your own project.

Note — Upload an image is only offered to apps whose model reads images. If the model doesn't, saving the field is refused with a message asking you to change the model first; on the Configuration page a model that reads images carries an Image badge. A document field works with every model, because the app reads the document's text.

Add an instruction

An instruction guides how your app responds; its Response format defines the type of result expected.

1. On the Configuration page, under Transmission of Instructions, click Add instructions.
2. Enter your instruction in the Instruction field.
3. Choose a Response format (the output type — for example text, a number, a score or a percentage).
4. Click Save.

The instruction is saved and listed under the configuration, where you can Edit or Delete it.

Activate an application

A draft app must be activated before it can run reasonings.

1. Open the app on its Overview tab.
2. Check the Configuration card shows Model, Data and Instruction as Configured.
3. Click Activate my application.

The status becomes activated and Overview now offers Access, which opens the app to run it. If anything is missing you'll see Please check the configuration. and the app stays a draft.

Note — While something is missing, the button at the top right reads Configure instead of Activate my application and takes you to the Configuration page.

Note — If you later remove a required part of the configuration, the app automatically returns to draft until it's complete again.

Rename an application

Settings is the third tab of the app's record, headed Application settings — Manage your application name, logo and visibility.

1. Open the app, then Settings.
2. On the Application card, click Edit.
3. Change the Application Name and Description, then click Save.

You'll see Changes saved successfully.

Note — Each of the four actions on Settings — Edit on Application, Edit on Logo, Edit on Visibility and Delete — opens in a panel that slides in from the right, titled with the action you clicked. The page behind it reloads as soon as the panel closes, so the card shows your change. Close leaves without saving; View full page at the foot of the panel opens the same form full size.

Change the logo

By default an app shows a coloured letter; you can upload an image instead.

1. Open the app, then Settings.
2. On the Logo card, click Edit.
3. Click Upload an image and pick a square image (PNG, JPG or WebP, up to 2 MB), then click Save the image.

You'll see Logo image updated. Leave it empty to keep the coloured letter.

Important — An app needs an image logo before it can be published to the catalog.

Publish an application to the catalog

Publishing makes your app Public so anyone in the catalog can run it.

1. Activate the app first — only an active app can be published.
2. Open the app, then Settings, then Edit on the Visibility card.
3. Click Add to catalog.

The Visibility card then reads Public / Published on the catalog. To unpublish, return here and click Remove from catalog — the card goes back to Private / Not published on the catalog.

Important — The app must be active and have an image logo before it can be published. Without them you'll see The application must be active to be published. or Your application needs an image logo before it can be published to the catalog.

Delete an application

1. Open the app, then Settings.
2. On the Delete this application card, click Delete.
3. Confirm on Confirm deleting this application?

The app is removed from your workspace and no longer appears in your applications. This action is permanent.