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.

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

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

The app is created as a draft and opens on its detail page, 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.

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.
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).

Note — The Configuration page shows each part as Configured or No model / No data / No instruction so you can see at a glance what's left to do.

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's detail page.
2. Check the Configuration card shows Model, Data and Instruction as configured.
3. Click Activate my application.

The status becomes activated and the detail page now shows 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 — If you later remove a required part of the configuration, the app automatically returns to draft until it's complete again.

Rename an application

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.

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.