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.
Create an application
- Open your applications list, then click Create an application.
- On Create an application, enter the Application Name and a Description of what it does.
- Click Register.
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.
- Open the app, then click Configure.
- Under Model Selection, click Select a model and pick one — see Choosing a model.
- Under Collect data, click Add data to define each input field the app asks for at run time (see the task below).
- 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.
Add a data field
Data fields are the inputs your app collects from whoever runs it.
- On the Configuration page, under Collect data, click Add data.
- Enter the Field name — the name shown to the user during the run.
- Choose the Field type (for example a single-line input, a text area, a number or an email).
- Set Field requirement to Required or Optional.
- 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.
Add an instruction
An instruction guides how your app responds; its Response format defines the type of result expected.
- On the Configuration page, under Transmission of Instructions, click Add instructions.
- Enter your instruction in the Instruction field.
- Choose a Response format (the output type — for example text, a number, a score or a percentage).
- Click Record.
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.
- Open the app's detail page.
- Check the Configuration card shows Model, Data and Instruction as configured.
- 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
- Open the app, then Settings.
- On the Application card, click Edit.
- Change the Application Name and Description, then click Register.
You'll see Changes saved successfully.
Change the logo
By default an app shows a coloured letter; you can upload an image instead.
- Open the app, then Settings.
- On the Logo card, click Edit.
- 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.
- Activate the app first — only an active app can be published.
- Open the app, then Settings, then Edit on the Visibility card.
- Click Add to catalog.
The visibility becomes Published on the catalog. To unpublish, return here and click Remove from 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
- Open the app, then Settings.
- On the Delete this application card, click Delete.
- Confirm on Confirm deleting this application?
The app is removed from your workspace and no longer appears in your applications. This action is permanent.