Skip to main content

Interpret AI Agent: Generate Program from Custom Sheets

Updated today

Snaptrude now supports a powerful new AI-assisted workflow called Interpret, which allows you to auto-generate a structured Program Data Sheet directly from your custom sheets—all within Program Mode.

With a simple command and a cell selection, the AI assistant intelligently extracts space names, areas, counts, departments, and other metadata from your input and converts it into usable program data in seconds.


What is Interpret?

Interpret is an AI agent inside Program Mode that reads your selected table data and converts it into structured:

  • Room-level (Net area) data

  • Program Block / Department-level (Gross area) data

  • Area targets

  • Counts

  • Metadata

The interpreted output is first shown in a structured review table — allowing you to edit before committing changes. Interpret helps streamline the process — no manual re-entry needed for program creation on Snaptrude.


How to Use the Interpret Command

1. Prepare Your Data

  • Open the Program Mode.

  • To bring in your custom program, follow either of these two steps:

    • Import the Excel directly into new sheets in the Program mode from the project name dropdown menu. (For new projects with imported program spreadsheet, ‘Create object’ action surfaces by default. Use this option to directly spaces & program blocks/departments from the imported program)

    • Once your research and analysis are complete with AI's research agent, select the relevant cells from the AI Table sheet to proceed with generating the program. (Learn mode about Research Agent here.)

    • Create your program on a blank sheet in the program mode as per your standard format then use interpret to directly convert to Program Data sheet later.

2. Select the Data & Triggering the Command

  • Manually select the relevant range of cells you want the AI to interpret for a more controlled creation of data in the program data sheet.

Image

Note: If you’ve added multiple sheets, make sure the sheet you want to use for creating the program is active, then select the relevant cells from it.

  • You will find two options after selecting the cells above the AI prompt box:

    • Create Objects → Use this when your goal is to generate model objects from tabular program data.

    • Set Targets → Use this when either the objects already exist and you only wish to set targets for them or to define targets without creating objects on the canvas.

    (Note: This will automatically switch the existing AI Agent to Interpret for further prompting if required.)

Image
  • (Optional) Add a structured prompt for improved accuracy (see examples below in the table). Skip this if you do not wish to add any additional context.

Image

Sample Prompts:

You can run @Interpret with or without a structured prompt. However, structured prompts provide better control and accuracy. Here are some examples:

Use Case

Sample Prompt

Specify column mappings

Create spaces using “Title A”/"Column A" as space label, “Title C”/"Column B" as area, “Title D”/"Column C" as count.

Include custom metadata

Create spaces using “Title A”/"Column A" as space label, “Title C”/"Column B" as area, “Title D”/"Column C" as count. Add “Category” and “Code” as metadata.

Combine columns for labels

Create spaces using combination of “Title A”/"Column A" + “Title B”/"Column B" as space label, “Title C”/"Column C" as area, “Title D”/"Column D" as count.

  • Then, press Enter to proceed.

  • You will then be asked to select either options:

    • Net Area→ Room objects

    • Gross Area → Program Block objects

Image

4. See the Output

  • The agent will first create a preview of the tabular data with department, space label, area & count. Here you can edit the data before continuing to create into the Program Data sheet.

Image
  • Once finalized, click on 'Continue' to either create objects or set targets as selected earlier. (Read about both these options in detail below.)

4.a. Create Objects

Use this option to create room or program block objects directly on the design canvas while also adding them to the Program Data Sheet.

You can choose between:

  • Net Area (Room) Objects – Creates room-level objects and automatically sets their net area targets.

  • Gross Area (Program Block) Objects – Creates department-level program block objects only (does not set department targets).

Image

Based on your selection, a preview table is generated for review. You can edit labels, areas, or counts as needed. Once confirmed, the data is added to the Program Data Sheet and the corresponding object blocks are created on the canvas.

4.b. Set Targets

Use this option to set area and count targets for rooms or program departments without creating new objects on the canvas.

This is useful when:

  • You prefer to design the objects manually instead of using AI-generated ones.

  • You’ve already created a design and want to assign targets afterward for validation and comparison.

In short, choose this option when you only want to define or update targets — not generate new canvas objects. Targets can be se for either Net Area (Rooms) or Gross Area (Departments). If you set Gross (Department) targets, you must also define the corresponding Room (Net) targets. You can do this by:

  • Setting room targets using the same Interpret steps, or

  • Drawing rooms on the canvas and assigning them to a department from the Properties panel dropdown. (Note: Even if rooms are drawn manually, their targets must still be set — either manually or using Interpret.)

This is important because a department’s total area is calculated as the sum of its room areas. Department values will only display in the net summary section once the room targets are defined.

Pro-tip: After generating the program, you can continue using 'Update Program' to update.


Best Practices

  • Always select the data range before triggering Interpret.

  • Include header rows in your selection — improves accuracy.

  • Use clear, structured prompts for complex sheets.

  • Avoid vague prompts or selecting the entire sheet (Ctrl+A) — this may fail or reduce accuracy.


Key Features

  • Works within Program Mode on any custom sheet.

  • Supports multiple tabs — new spaces are appended to the Program Data Sheet.

  • Imports any other metadata as extra custom columns automatically.

  • Repeatable — you can use the interpret agent multiple times across sheets.


Additional Notes:

  • Tested on sheets with up to 250 rows / 1400+ cells

  • Typical processing time: under 2–3 minutes

  • Better accuracy with well-labeled columns and structured prompts

Did this answer your question?