Skip to content

Create zones from a prompt

This recipe creates zones on a scene by describing them to an AI assistant connected to the Cognitive3D MCP Server. The assistant creates the zones as drafts, and you review them on the dashboard before they start counting visits.

Use it when you have many areas to mark, many scenes, or scenes that are generated, where drawing each zone by hand is slow.

Before you start

  • Connect your assistant to the MCP Server.
  • You need an organization-admin or project-admin role for the project.
  • The scene must be uploaded. The assistant places zones best when it has a reference for the scene's layout: your Unity or Unreal project, recorded sessions on the scene, or one or two zones that already mark known landmarks.

Note

Zones count visits only for sessions recorded after you save them. Earlier sessions are not reprocessed. See Zones.

Steps

  1. Ask what already exists on the scene.

    Which zones and shapes are defined on the Showroom scene of my Retail project?

  2. Give the assistant a reference for the scene's layout. The MCP Server does not send it the scene's geometry, so choose one of these:

    • Work alongside your project. If your assistant is a coding agent, such as Claude Code, open in your Unity or Unreal project, it can read object positions from the scene and place zones around them: "Create a draft zone around the CheckoutCounter object in the Showroom scene." This is the most precise option.
    • Ask for a heatmap of where participants stand: "Show a position heatmap of the Showroom scene for the last 90 days."
    • Point to a zone you already drew: "The Entrance zone marks the front door."
    • Give coordinates from your project, in meters: "The checkout counter is centered at x 4, z -2."
  3. Describe the zones you want.

    Propose draft zones for the three busiest areas on the heatmap. Make each one a 2 by 2 meter floor area and name them by what is nearby.

  4. Read the preview. The assistant lists each shape with its position and size, and creates nothing yet.

  5. Confirm. The assistant creates the shapes as a draft and returns a link to the dashboard's Zones page for that scene.

  6. Open the link and check each draft against your scene. Move or resize a draft if it is off.

  7. Press Save changes to publish the drafts as zones.

Warning

Save changes publishes every draft on that scene, not only the ones you just created.

Variations

  • Publish without a review. Ask the assistant to publish the zone immediately. Use this for scripted, bulk definitions where you already know the coordinates.
  • Zones with a height. Ask for a box, cylinder, or sphere at a given height, such as "a 1 meter sphere at head height around the control panel".
  • Use the zone in an objective. After a zone is published, see Create objectives from a prompt.

See also

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