Skip to Content
Welcome to the new DatumOS documentation!

Example Prompts & Use Cases

This guide provides practical examples of prompts you can use with the Autodesk ACC connector. Each prompt is designed to help you get specific information from your construction projects quickly and efficiently.

How to Use These Examples

Copy any prompt below and paste it into your DatumOS conversation. Replace placeholder text like [Project Name] or [Level Name] with your actual project details.


Finding Documents

Search and retrieve construction documents across your ACC projects.

Find documents by name

Prompt: “Find all documents containing ‘[Keyword]’ in the [Project Name] project”

What it does: Searches file names and titles for the keyword across all folders.

Returns: File names, types, locations, and last modified dates.

Search across all projects

Prompt: “Search for [Document Type] across all my ACC projects”

What it does: Performs a multi-project search for matching documents.

Returns: Files from all connected projects with project names indicated.

Filter by File Type

Find PDFs only

Prompt: “Show me all PDF drawings in the [Folder Name] folder of [Project Name]”

What it does: Filters results to only PDF files in the specified location.

Returns: PDF files with download links and metadata.

Find Revit models

Prompt: “List all Revit files (.rvt) in the [Project Name] project”

What it does: Searches specifically for Revit model files.

Returns: Revit files with version info and BIM query availability.

Find CAD drawings

Prompt: “Find all DWG files updated in the last month in [Project Name]”

What it does: Combines file type and date filtering.

Returns: AutoCAD files modified within the specified timeframe.

Filter by Date

Recent uploads

Prompt: “What files were uploaded to [Project Name] in the last 7 days?”

What it does: Filters by upload/modification date.

Returns: Recently added or updated files with timestamps.

Date range search

Prompt: “Find specifications uploaded between [Start Date] and [End Date]”

What it does: Searches within a specific date range.

Returns: Files matching both the keyword and date criteria.

Fuzzy/Approximate Matching

Typo-tolerant search

Prompt: “Find ‘[Misspelled Keyword]’ drawings in [Building Name]”

What it does: Uses fuzzy matching to find similar terms despite typos.

Returns: Files with similar names, ranked by relevance.

Pro tip: Fuzzy search works with a 0.4 threshold by default—close matches will be included, but very different terms won’t.


Browsing Project Folders

Navigate your ACC project folder structure to understand organization.

View folder hierarchy

Prompt: “Show me all folders in the [Project Name] project”

What it does: Retrieves the complete folder tree structure with file counts.

Returns: Hierarchical folder list with names, paths, and document counts.

Explore subfolders

Prompt: “What subfolders exist under [Folder Name] in [Project Name]?”

What it does: Navigates to a specific folder and shows its contents.

Returns: Subfolder names with nested structure and file counts.

Project organization overview

Prompt: “How is the [Project Name] project organized?”

What it does: Provides a summary of the project’s document organization.

Returns: Folder tree with descriptions of what each main folder contains.

Deep folder exploration

Prompt: “Show me the complete folder structure of [Project Name], go as deep as possible”

What it does: Traverses the folder hierarchy deeply (default 5 levels, up to 10 when requested).

Returns: Full hierarchical view with all subfolders and file counts.

Find folder by name

Prompt: “Where are the specifications stored in [Project Name]?”

What it does: Searches folder names to locate specific document types.

Returns: Path to matching folders with their file counts.

Pro tip: Folder browsing helps you understand where documents are before searching, making file searches more targeted and efficient.


Analyzing BIM Models

Query building information models for element properties, quantities, and structural data.

Property Queries

Element properties by type

Prompt: “Show me all doors on [Level Name] of the [Model Name] model in [Project Name]”

What it does: Queries BIM elements filtered by category and level.

Returns: Door types, sizes, fire ratings, hardware sets, and locations.

Filter by material

Prompt: “List all walls with [Material Type] material in the [Model Name] model”

What it does: Filters structural elements by material property.

Returns: Wall IDs, dimensions, material specs, and structural classifications.

Filter by level/floor

Prompt: “What mechanical equipment is on [Level Name] of the [Model Name] model?”

What it does: Queries MEP elements filtered to a specific floor.

Returns: Equipment types, model numbers, capacities, and connection points.

Custom parameter queries

Prompt: “Find all elements with ‘[Parameter Name]’ property containing ‘[Value]’”

What it does: Searches custom Revit parameters for specific values.

Returns: Elements matching the parameter filter with full property details.

Window schedule data

Prompt: “Generate a window schedule for [Building Name] showing type, size, and U-value”

What it does: Extracts window properties formatted as a schedule.

Returns: Tabular data with window specifications.

Quantity Takeoffs

Count elements by category

Prompt: “How many doors are in the entire [Project Name] model?”

What it does: Counts all door instances across the model.

Returns: Total count with breakdown by door type.

Aggregate by level

Prompt: “Show wall quantities by level in the [Model Name] model”

What it does: Groups wall counts and areas by floor level.

Returns: Per-level breakdown with lengths and areas.

Group by material

Prompt: “What are the total floor areas by material type in [Building Name]?”

What it does: Aggregates floor elements by their material.

Returns: Square footage totals grouped by material (concrete, tile, carpet, etc.).

Structural quantities

Prompt: “Calculate total volume of concrete columns in the [Model Name] model”

What it does: Sums volume properties for structural elements.

Returns: Total cubic volume with count of columns.

Version Comparison

Compare two versions

Prompt: “What changed between version [X] and version [Y] of the [Model Name] model?”

What it does: Analyzes element-level differences between versions.

Returns: Lists of added, modified, and removed elements.

Find added elements

Prompt: “What new doors were added in the latest version of the [Model Name] model?”

What it does: Identifies elements that exist in the new version but not the old.

Returns: New door details with properties and locations.

Find modified properties

Prompt: “Show me walls with changed dimensions in the latest [Model Name] model update”

What it does: Detects property changes on existing elements.

Returns: Wall IDs with old vs. new dimension values.

Track removed elements

Prompt: “What elements were removed from [Level Name] in the latest revision?”

What it does: Identifies elements that existed before but are now deleted.

Returns: List of removed elements with their last-known properties.

Model Navigation

Browse model hierarchy

Prompt: “Show me the model structure for the [Model Name] model in [Project Name]”

What it does: Retrieves the hierarchical organization of model elements.

Returns: Tree structure of categories, families, and types.

Explore property definitions

Prompt: “What custom parameters are available in the [Project Name] [Model Name] model?”

What it does: Lists all defined parameters and their data types.

Returns: Parameter names, types (text, number, yes/no), and categories they apply to.


Tracking RFIs

Access Requests for Information with status tracking and filtering.

Open RFIs by assignee

Prompt: “Show me all open RFIs assigned to [Assignee Name/Company]”

What it does: Filters RFIs by status and assigned party.

Returns: RFI numbers, titles, due dates, and days open.

RFIs by status

Prompt: “List all RFIs with status ‘[Status]’ in [Project Name]”

What it does: Filters by specific RFI workflow status.

Returns: RFIs awaiting response with assignee and due date.

Date range filtering

Prompt: “Find RFIs created in the last [Number] days for [Project Name]”

What it does: Shows recent RFI activity.

Returns: Newly created RFIs with status and urgency.

Keyword search

Prompt: “Search for RFIs mentioning ‘[Keyword]’ or ‘[Keyword]’”

What it does: Searches RFI titles and descriptions for keywords.

Returns: Matching RFIs with context snippets.

Overdue RFIs

Prompt: “What RFIs are past their due date in the [Project Name] project?”

What it does: Identifies RFIs that have exceeded their response deadline.

Returns: Overdue RFIs with days past due and escalation status.


Managing Issues

Search and track project issues across your construction projects.

Issues by priority

Prompt: “Show me all critical and high-priority issues in [Project Name]”

What it does: Filters issues by severity level.

Returns: Issues sorted by priority with status and assignee.

Issues by location

Prompt: “What open issues are on [Level Name] of [Building Name]?”

What it does: Filters issues by their tagged location.

Returns: Issues with their specific location details and photos.

Assigned issues

Prompt: “List all issues assigned to [Assignee Name/Company] that are still open”

What it does: Shows workload by responsible party.

Returns: Open issues with creation date and priority.

Resolution tracking

Prompt: “Show me issues resolved in the last week in [Project Name]”

What it does: Tracks recently closed issues.

Returns: Resolved issues with resolution notes and closure date.

Issue type filtering

Prompt: “Find all [Issue Type]-related issues in the [Project Name] project”

What it does: Filters by issue type or category.

Returns: Matching issues with severity, status, and corrective actions.


Reviewing Submittals

Track submittal packages and approval workflows.

Pending approvals

Prompt: “What submittals are waiting for [Reviewer Role] review in [Project Name]?”

What it does: Shows submittals in the review queue.

Returns: Pending submittals with submission date and spec section.

By contractor

Prompt: “Show me all submittals from [Contractor Name]”

What it does: Filters submittals by submitting party.

Returns: Submittals with status, revision number, and review notes.

By date range

Prompt: “Find submittals approved in [Month/Date Range]”

What it does: Searches submittals by approval date.

Returns: Approved submittals with approval stamps and comments.

Status tracking

Prompt: “List submittals returned for revision in the [Project Name] project”

What it does: Identifies submittals requiring resubmission.

Returns: Rejected/revision-required submittals with reviewer comments.

Spec section search

Prompt: “Find all Division [Number] submittals for [Project Name]”

What it does: Searches by specification division.

Returns: Matching submittals with approval status.


Team & Project Management

Navigate accounts, projects, and team members.

Find team members

Prompt: “Who are the [Role] on the [Project Name] project?”

What it does: Searches team members by role.

Returns: Names, emails, companies, and roles.

Project overview

Prompt: “Give me a summary of the [Project Name] project”

What it does: Retrieves project metadata and recent activity.

Returns: Project details, folder structure, and recent files.

Browse accounts

Prompt: “What ACC accounts and hubs do I have access to?”

What it does: Lists all connected Autodesk accounts.

Returns: Hub names, IDs, and your access level.

List projects

Prompt: “Show me all active projects in the [Hub Name] hub”

What it does: Lists projects within a specific account.

Returns: Project names, status, and your role on each.

Contact lookup

Prompt: “Find the email for [Person Name] in the [Project Name] project”

What it does: Searches team members by name.

Returns: Contact details and company affiliation.


Advanced Scenarios

Combine multiple capabilities for complex queries.

Cross-Referencing Data

BIM + Documents

Prompt: “Find the specification document for door type [Type ID] in [Project Name]”

What it does: Identifies the door type, then searches for related specs.

Returns: Door properties and matching specification documents.

Issues + BIM location

Prompt: “Show me BIM elements near the location of Issue #[Issue Number]”

What it does: Cross-references issue location with model geometry.

Returns: Issue details and nearby BIM elements.

Multi-Project Analysis

Compare across projects

Prompt: “How many Revit models are in each of my active projects?”

What it does: Aggregates model counts across all connected projects.

Returns: Project-by-project breakdown of BIM assets.

Portfolio search

Prompt: “Find all projects with open critical issues”

What it does: Scans all projects for high-priority problems.

Returns: Projects with critical issue counts and summaries.

Complex Filtering

Multiple criteria

Prompt: “Find [Material Type] walls on [Level Name] that were modified in the last version of the [Model Name] model”

What it does: Combines material filter, level filter, and version comparison.

Returns: Modified walls with change details.

Conditional queries

Prompt: “List all MEP equipment on [Level Name] with a power requirement over [Value]”

What it does: Filters by category, level, and numeric property value.

Returns: High-power equipment with specifications.

Performance Tips

Optimize Query Performance

AEC Data Model (Fast Path): For Revit 2024+ models, queries typically complete in under 2 seconds. Always specify the model name and limit results when possible.

Model Derivative (Fallback): Older models use the Model Derivative API, which can take 30-60 seconds for initial queries. Results are cached for subsequent queries.

Best practices:

  • Specify project and model names to avoid searching all projects
  • Use element type filters (walls, doors, etc.) to limit result sets
  • For large models, add level or location filters
  • First queries to a model may be slower; subsequent queries are cached

Next Steps