Build your first Klu app

This guide takes you from a new workspace to a deployed Action. You will connect an LLM provider, build a reusable prompt in Studio, test it with sample input, and publish it for use outside Klu.

Before you start

You need a Klu account and an API key for an LLM provider you want to use. Open your Klu workspace and sign in.

If your workspace already has a suitable provider and model, continue to create an Action.

Finish onboarding

On the Welcome screen:

  1. Select New App or Feature.
  2. Click Continue.
  3. On the Workspace screen, enter the Workspace Name and Workspace URL. A workspace image is optional.
  4. Click Continue.

If Klu finds an existing workspace for your company domain, you can join it instead of creating another one. When onboarding finishes, Klu opens your workspace.

Connect an LLM

Connections determine which providers and models are available in Studio.

  1. Select Connections in the workspace sidebar.
  2. Stay on the LLM Providers tab.
  3. Click Add LLM.
  4. Select a provider and enter the credentials requested by the form.
  5. Save the connection.
  6. In the provider row, select a Default Model.

You can also choose a Default LLM Provider at the top of the page. Klu uses the workspace defaults when you open a new Studio Action, and you can change the provider or model inside Studio later.

If a credential is rejected, verify that it is active and has access to the model you selected. A provider can appear in the table before every model is available to your credential.

Create an Action

An App groups related Actions. An Action stores the prompt, model configuration, Context, and deployment versions for one task.

  1. Select Studio in the sidebar.
  2. Select Completion at the top of Studio.
  3. Choose your provider and model in the left panel.
  4. Add a system message if the selected model supports it, then add a user message with the template below.

User message

Analyze this customer feedback:

{{feedback}}

Return three fields:
- Topic
- Underlying need
- Criticality from 1 to 5, with a short reason

Klu treats {{feedback}} as a variable and creates an input for it in the test area. If you need another template message, click Message in the left panel.

  1. If the test area is empty, click Create Variation.
  2. Enter sample text in the feedback input.
  3. Click Run.

The generated response appears in Studio. A provider error, unsupported model, or missing variable value prevents a successful generation; correct the highlighted configuration or input and run it again.

Save the App and Action

  1. Click Save in the Studio toolbar.
  2. Select New App.
  3. Enter an App Name. Klu uses this name for the new App and its first Action.
  4. Click Save.

After the first save, later edits create new Action versions when you save them. The Action name replaces Untitled New Action in the toolbar.

Deploy the Action

  1. Click Deploy in the Studio toolbar.
  2. Under Deploy to environment, select Production.
  3. Wait for the deployment confirmation. The button changes to Deployed when the current deployment is active. If you edit and save a newer version, it changes to Deploy latest until you deploy that version.
  4. Open the deployment menu again and select API.

The Publish dialog lets you choose Shareable URL, Python SDK, Typescript SDK, or cURL Request and shows the Action GUID. Copy the integration generated for the deployed Action.

Deployments are versioned by environment. Testing an unsaved Studio change does not update Production; save the change and deploy the latest version when you are ready.

Next steps