Create objectives from a prompt
This recipe creates an objective by describing it to an AI assistant connected to the Cognitive3D MCP Server. The assistant looks up the event names in your project, so you do not need to find them in the dashboard or type them exactly.
Use it when you know what success looks like in your application, such as "the trainee picks up the extinguisher and then pulls the alarm", and want it measured across sessions.
Before you start
- Connect your assistant to the MCP Server.
- You need an organization-admin or project-admin role for the project. Without one, the assistant can read objectives but cannot create them. An organization or project API key with read-write permissions will also work.
- Your application must already record the events or Dynamic Objects the objective depends on.
Steps
-
Ask what the project records. This grounds the rest of the conversation in your real event names.
What custom events does my Warehouse Training project record?
The assistant finds the project and lists its event names.
-
Describe the objective in your own words. Name the steps in order, and say how many times each must happen.
Create an objective called "Safe startup". The trainee must trigger the lockout applied event at least once, and then the machine started event at least once, in that order.
The assistant matches your wording to the event names it found. If a step is ambiguous, it asks you which event you mean.
-
Read the preview. The assistant does not create anything yet. It shows the objective name, the steps it will create, and a note that creating an objective re-scores about 30 days of past sessions.
-
Confirm. Reply that the preview is correct, and the assistant creates the objective.
-
Check the result after re-scoring finishes, which should take a few minutes.
How is the Safe startup objective performing?
Variations
- Gaze and fixation steps. Ask for a step where participants look at a Dynamic Object, such as "the trainee must look at the pressure gauge".
- Zone steps. Ask for a step where participants spend time in a zone, such as "spend at least 5 seconds in the Inspection zone". See Create zones from a prompt.
- Steps in any order. Say that the order does not matter.
- Copy an objective to another project. Ask the assistant to read an objective from one project and create the same one in another.
Things to know
- Objective names are limited to 32 characters and descriptions to 128 characters.
- Editing the steps of an objective creates a new version and re-scores past sessions again.
- Deleting an objective removes all of its versions and cannot be undone.
See also
- Objective queries — every objective tool and its parameters.
- Creating Objectives — how objectives work, and how to create them on the dashboard.
- Objectives Summary — reading objective results.
If you have a question or any feedback about our documentation please use the Intercom button (purple circle) in the lower right corner of any web page or join our Discord.