Skip to main content
REA-02 · Real Estate & Construction

Construction Project Controls Copilot

Outcome​

Give the construction project manager one grounded control surface across schedule, cost, RFIs, submittals and change orders so schedule slip and cost exposure are explained by the contract documents and the daily field record rather than reconstructed in a spreadsheet before each owner meeting.

Portfolio attributeValue
Primary personaProject manager
Primary aggregateConstructionProject
Cosmos DB containers1
Grounding dataschedules, budgets, RFIs, logs, change orders
Development estimateUSD 60-220 monthly dev estimate
Runtime optionsPython FastAPI and C# ASP.NET Core

Productivity hypothesis​

These measures reflect the workflow, evidence, decision boundary, and industry risk for this use case.

Impact typeMeasureConservative internal assumptionCustomer measurement
ProductivityControls analysis cycle time10-18% reduction(baseline median controls-analysis minutes - assisted median minutes) / baseline median minutes * 100
Quality or riskFirst-pass acceptance5-10 percentage-point improvementassisted percentage accepted without material rework - baseline percentage accepted without material rework

Important: Conservative internal pilot assumptions only; not public benchmarks, commitments, or expected customer results. Validate against a comparable baseline or matched control cohort with mandatory human review.

Rationale: Schedules, budgets, RFIs, logs, and changes support faster status and impact-analysis preparation.

Pilot guardrail: Keep budget, schedule, RFI, change-order, and project-control decisions human-owned.

Customer validation plan​

  1. Baseline the current workflow with representative users and tasks.
  2. Run the accelerator on the same task mix with human review retained.
  3. Measure controls analysis cycle time and first-pass acceptance with the documented formulas.
  4. Replace internal assumptions with customer-observed results before a business case.

Why Azure Cosmos DB​

This AI solution needs an operational data plane, not only a vector index:

  • Hybrid vector and full-text retrieval combines semantic recall with exact identifiers, codes, names, and domain language.
  • Hierarchical partition keys and metadata predicates keep tenant and domain boundaries in the normal query path.
  • Operational JSON, source chunks, workflow and agent state, feedback, and audit records remain together for low-latency reads and governed writes.
  • Change feed reacts to source and operational updates without polling.
  • Autoscale throughput, configurable consistency, and multi-region distribution support variable demand and enterprise availability.

Domain workflow​

Domain workflow

StageActorInput → outputApproval
1. Schedule and cost update ingestionScheduling and ERP connectorsScheduleActivity → periodControlSnapshotPolicy controlled
2. Slip and variance attributionConstruction project controls copilotperiodControlSnapshot → driverAttributionSetPolicy controlled
3. Contract entitlement groundingRetrieval orchestratordriverAttributionSet → ContractDocChunkPolicy controlled
4. Owner narrative draftingConstruction project controls copilotContractDocChunk → ControlsNarrativePolicy controlled
5. Project manager approval and change order submissionProject managerControlsNarrative → submittedChangeOrderHuman required

Technical architecture​

Technical architecture

Cosmos DB data model​

ContainerHierarchical partition keyDocumentsSearch paths
constructionProjects/tenantId, /projectIdProject, ScheduleActivity, CostCommitment, ContractDocChunk, ProjectIssue, ControlsNarrative/chunkVectorEmbedding, /subjectVectorEmbedding, /narrativeVectorEmbedding, /chunkVector, /subjectVector, /narrativeVector

Query contract​

QueryContainerScopePurpose
CriticalPathSlippageconstructionProjectssingle-partitionIdentify critical-path activities that lost float in the latest schedule update.
CostCodeVarianceconstructionProjectssingle-partitionShow cost codes whose forecast at completion exceeds budget beyond the reporting tolerance.
OverdueBallInCourtIssuesconstructionProjectssingle-partitionList RFIs and submittals past their response due date by responsible party.
EntitlementClauseRetrievalconstructionProjectssingle-partitionRetrieve the contract and specification language governing a claimed time extension or extra cost.

Python and C# services route each document type to its declared container and hierarchical partition key. ETag-based writes protect mutable aggregates, while append-only records and bounded cross-partition queries preserve scale.

Azure deployment​

Azure deployment

Clone the source repository, authenticate with Azure, and run:

Set-Location accelerators/real-estate-construction/construction-project-controls-copilot
az login
./Deploy.ps1 -Runtime python -Location eastus2

Change python to csharp to deploy the .NET implementation.

Explore the implementation​

Return to all accelerators