Skip to main content

​
Getting Started

The BIM Agent lets you work with building information models (IFC and Revit files) through conversation. Upload a model, describe what you need, and the agent reads, analyzes, or edits it for you.
1

Go to app.stru.ai

Open app.stru.ai and sign in with your email.
2

Select the BIM Agent

Use the dropdown in the top-left corner to choose BIM Agent.
Select BIM Agent from the agent dropdown
3

Upload Your Model

Attach an .ifc or .rvt file using the + button next to the message box. The file appears as a card above your prompt.
Upload an IFC model and describe what you need
4

Describe What You Need

Write your request in plain language — no need to know any file format or query syntax:
Review the BIM/IFC model and summarize element counts, material
quantities, major assemblies, and any obvious modeling gaps.
5

Review the Results

The agent works through the model, shows its reasoning, and renders the 3D geometry alongside its findings. Use Ortho/Persp to switch views and the Layers panel to isolate categories.
BIM Agent reviewing a model with 3D viewer and layers panel
Pro Tip: Use @ to search building codes and standards while writing prompts, just like the ETABS/SAP2000 agents.

​
IFC vs. Revit: What’s Supported

The agent’s depth of access depends on the file format you upload.

IFC Files

Full support — the agent can read and edit everything:
  • Element lists, properties, and spatial hierarchy
  • Quantity takeoff and cost estimation
  • Data-quality warnings
  • Tagging, renaming, and deleting elements
  • Batch edits across many elements at once

Revit (.rvt) Files

File-level facts only, without a live Revit connection:
  • Project/file metadata
  • Linked-file references
  • Data-quality warnings at the file level
Element-by-element data (counts, properties, geometry edits) requires a live connection to a running Revit session — the agent will tell you clearly when that’s needed rather than guessing.
Working with a Revit model? The agent can convert it to IFC first (where a converter is configured) to unlock full element-level analysis, editing, and costing — just ask: “Convert this Revit file to IFC so we can dig into the elements.”

​
What the BIM Agent Can Do

Model Inspection

Summarize a model’s spatial tree, element counts, properties, and material breakdown. Spot missing data, unclassified elements, and modeling gaps.

Quantity Takeoff & Costing

Run per-element quantity takeoffs (areas, volumes, lengths) and roll them up into a priced bill of quantities, broken down by storey or element type.

Tagging & Editing

Set or fix properties (fire ratings, classifications, names) on one element or hundreds at once, as a single all-or-nothing batch.

Data Quality Checks

Surface deterministic warnings — missing properties, unclassified elements, orphaned geometry — before they become downstream problems.

Model Comparison

Compare two versions of a model to see what changed: element counts, quantities, or newly introduced warnings.

Ad-Hoc Analysis

Ask open-ended questions the standard summaries don’t cover — the agent writes and runs the analysis behind the scenes and reports back the answer, not the code.
Nothing is ever silently changed or fabricated. The agent asks before saving changes, tells you exactly what it modified, and reports missing data as “unavailable” rather than guessing a number.

​
Writing Effective Prompts

​
The Golden Rule

Either be specific OR explicitly give the agent discretion. Avoid vague prompts. 
Set the FireRating property to "2HR" on every beam under
Pset_BeamCommon. Show me the list of beams you'll update
before saving.

Review this model for data quality issues and use your
judgment on what's worth flagging — focus on anything that
would block a quantity takeoff.

Fix the model.

​
Key Prompt Elements

If you’re uploading a Revit file but only need file-level facts, say so — it avoids the agent reaching for element-level data it can’t get offline:✅ “This is a Revit file — just pull the project metadata and linked files for now.”
For large tagging or costing jobs, work incrementally:
First, list all beams missing a fire rating.
[Review the list]
Now tag all of them with FireRating = 2HR.
[Confirm]
Finally, run a cost estimate on the updated model.
For edits you want to double-check first:✅ “Show me what would change, but don’t save yet.”✅ “Once I confirm, save this as a new file rather than overwriting the original.”

​
Common Use Cases

​
Model Summary

Review this IFC model and summarize element counts, material
quantities, major assemblies, and any obvious modeling gaps.

​
Spatial Breakdown

Show me the building's spatial hierarchy — sites, buildings,
storeys, and spaces — and how many elements live in each storey.

​
Finding Specific Elements

List every beam on Level 2, along with their sections and
lengths.

​
Data Quality Sweep

Check this model for data quality issues — missing properties,
unclassified elements, or anything that would block a cost
estimate.

​
Advanced Usage

​
Batch Operations

Describe the whole batch in one prompt — the agent treats it as one all-or-nothing change, so a problem with one element doesn’t leave the model half-edited: 
Tag beams 151, 162, and 178 with FireRating = 2HR under
Pset_BeamCommon, and rename beam 151 to "Exterior Beam A".
Apply all of these together, and if any one of them fails,
don't save any of the changes.

​
Study and Compare Models

Compare 'Design_A.ifc' and 'Design_B.ifc':
1. Element count differences by type
2. Material quantity differences
3. Any new data-quality warnings introduced in Design_B
Use cases: Track changes between design revisions, verify a consultant’s model matches expectations, or audit what changed after a coordination pass.

​
Convert Between Formats

Convert 'Building_Model.rvt' to IFC so we can run a full
quantity takeoff and check for data quality issues.

​
Ad-Hoc Questions

When a standard summary doesn’t answer your question, just ask — the agent figures out how to get the answer: 
How many exterior wall types are in this model, and what's
the total exterior wall area?

Are there any spaces without a defined area? List them by name.

​
Best Practices

Start broad, then narrowAsk for a full summary first, then drill into specific categories or storeys once you know what’s there.Ask about gaps, not just what exists“What’s missing or unclassified in this model?” often surfaces more useful information than a plain element count.

​
Troubleshooting

This is expected for Revit files opened offline — element lists, properties, and geometry edits need a live Revit connection. The agent will tell you this rather than guessing. Ask for file-level metadata instead, or request a conversion to IFC for full access.
The agent won’t delete a spatial container (like a storey or space) that still holds other elements, since that would silently orphan its contents. Ask it to first move or delete the contained elements, or confirm you want the whole branch removed.
The agent never overwrites a file silently. Give it a new file name, or explicitly confirm you want to update the existing model in place.
Batch edits are all-or-nothing — if one item in the batch fails, none of the changes are saved. Ask the agent what failed and why, fix that item, and re-run the batch.
The agent never fabricates a quantity or rate — if something is missing, it shows up as “unavailable” or as an exception in the estimate, not a silent zero. Ask “What’s missing from this estimate?” to see the gaps directly.

​
Real-World Workflow

1

Upload and Review

Review this model and summarize element counts, material
quantities, and any data quality issues.
Agent reports element counts by type, flags 23 beams missing a fire rating.
2

Investigate the Gap

List the 23 beams missing a fire rating, with their IDs
and locations.
Agent returns the list with IDs, levels, and coordinates.
3

Tag in Bulk

Tag all 23 of those beams with FireRating = 2HR under
Pset_BeamCommon. Show me the change set before saving,
then save as 'Model_Tagged.ifc'.
Agent previews the batch, confirms, and saves the new file.
4

Verify

Re-check the tagged model for data quality issues — confirm
no beams are still missing a fire rating.
Agent confirms the gap is closed.
5

Cost the Model

Run a quantity takeoff on the tagged model, then generate a
priced bill of quantities using MasterFormat, broken down
by storey.
Agent runs the takeoff, classifies elements, and returns a priced BOQ with any coverage gaps flagged.

​
Tips for Success

  • Start with a summary - Get the lay of the land before diving into edits or costing
  • Preview before saving - Ask the agent to show you the change set first for anything non-trivial
  • Batch related edits - Group similar tagging or property changes into one request so they apply as a single transaction
  • Name your outputs - Tell the agent what to call the saved file so you can track revisions
  • Ask “what’s missing” - Gaps and warnings are often more actionable than raw counts

​
Next Steps

Try It

Upload an IFC model and ask for a full reviewGo to app.stru.ai

Run a Cost Estimate

Take a model from quantity takeoff to a priced bill of quantities

Clean Up a Model

Find and fix missing properties or unclassified elements in bulk

Compare Revisions

Upload two versions of a model and see what changed

Convert a Revit File

Convert a Revit model to IFC to unlock full element-level analysis

Reference Codes

Use @ in prompts to search relevant standards
Questions? Email support@stru.ai or book a call to discuss your use case.