Skip to main content

How to Run a Workflow

1

Navigate to Workflows

Click Workflows in the sidebar.
2

Select a Workflow

Choose the workflow you want to execute from the list.
3

Choose a Project

Select which project’s documents you want to review.
4

Select Documents

Choose which documents to include in the review (project and/or organization documents).
5

Run the Workflow

Click “Run” or “Execute” to start the AI review.
6

Wait for Processing

The AI will analyze your documents against the workflow items.
7

View Results

Navigate to the Results section to review findings.
[SCREENSHOT PLACEHOLDER: Run workflow modal showing project and document selection]

Document Selection

When running a workflow, you select which documents the AI should analyze.

Project Documents

Choose from documents uploaded to the selected project:
  • Select specific documents (e.g., only structural drawings)
  • Select all project documents
  • Mix and match as needed

Organization Documents

Optionally include organization-level documents as reference context:
  • Design standards
  • Building codes
  • Company guidelines
The AI will use organization documents to inform its review and check compliance.

Selection Tips

Include Relevant Standards - Add organization documents (like building codes) to provide context for compliance checks.
Select Complete Sets - Include all related drawings and specifications for comprehensive reviews.

Execution Process

Once you click “Run”:
  1. Queueing - Your workflow execution is queued
  2. Document Analysis - AI processes selected documents
  3. Item Evaluation - Each workflow item is checked
  4. Finding Generation - Issues and observations are identified
  5. Results Ready - Navigate to Results to view findings

Processing Time

Workflow execution time varies based on:
  • Number of documents selected
  • Size and complexity of documents
  • Number of workflow items
  • Current system load
Typical execution times range from a few minutes to 30+ minutes for large document sets.

Monitoring Progress

While a workflow runs:
  • You can navigate away and return later
  • Check the Workflows or Results section for status updates
  • You may receive notifications when execution completes
[SCREENSHOT PLACEHOLDER: Workflow execution progress indicator]

After Execution

Once complete:
  1. Navigate to Results in the sidebar
  2. Select the completed workflow execution
  3. Review findings organized by workflow item
  4. Respond to findings as needed
  5. Export results to Excel
See Results Overview for detailed guidance on reviewing findings.

Running Workflows Multiple Times

You can run the same workflow on:
  • Different projects
  • Different document sets
  • Updated document versions
Each execution creates a separate set of results, allowing you to:
  • Track changes over time
  • Compare different projects
  • Review design iterations

Workflow Execution Best Practices

Run your workflow on a small set of documents initially to verify it works as expected.
Select all documents and standards needed for the AI to perform accurate reviews.
When comparing results, use the same document selection for consistency.
After viewing results, refine your workflow items for better future results.

Troubleshooting

Execution Fails

  • Verify all selected documents processed successfully
  • Check that workflow has valid items
  • Try with fewer documents
  • Contact support if issues persist

Results Take Too Long

  • Large document sets may take significant time
  • Check workflow status or refresh the page
  • Consider breaking into smaller reviews

No Results Generated

  • Ensure workflow items are properly configured
  • Verify documents contain relevant content
  • Check that documents are text-searchable (not just images)

Next Steps