Skip to content

You are viewing documentation for Instruqt 2.0 Labs. For Tracks documentation, please visit docs.instruqt.com.

Creating a Lab with AI


You can create a lab from a short description. You tell the AI assistant what the lab should teach and who it is for. Instruqt creates a new lab, opens the assistant beside the editor, and the assistant starts to build the sandbox, instructions, and checks. You watch the changes land and keep chatting to shape the result.

  • Your team needs an active Anthropic API key. A team Owner adds it once — see Using your own API key. Without a key, the dialog explains that AI is not set up and does not let you create a lab.
  • You need permission to edit labs. Team Owners and content creators have it.
  1. Go to Labs in the management interface.
  2. Click Create lab and choose With AI.
  3. In the Create a lab with AI dialog, describe the lab you want (see The form below).
  4. Optionally, choose a Duration and an Audience experience.
  5. Click Create.

Instruqt creates a new lab from a blank template, opens it in edit mode, and opens the assistant. Your description, with the duration and audience you chose, becomes the first message of the conversation. The assistant starts to build straight away and gives the lab a title that matches the topic.

FieldRequiredDescription
Prompt✓A description of the lab you want — what it should teach and, ideally, why. This is the main instruction the assistant works from.
DurationHow long the lab should take a user to complete. Options range from 5 minutes to 4 hours. Defaults to 10 minutes. Longer labs get more chapters, not just more text.
Audience experienceHow experienced the audience is with the topic: Beginner, Intermediate, or Advanced. This sets how much the instructions explain and how much they assume. Defaults to Intermediate.

The prompt is the only field you have to fill in.

The lab is a normal lab from the start. The assistant writes into the lab’s working branch, the same place your own edits go:

  • Each change the assistant makes appears in the editor as it lands.
  • When a turn ends, the chat lists what the assistant added, updated, and removed, and offers to run or test the lab.
  • Nothing reaches users until you publish.

To continue, send the assistant more instructions in the chat, or edit the lab yourself. See Working with the assistant for how the chat works.