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

Building Operations Assistant

Outcome​

Let the facility manager resolve building faults faster by joining live BMS alarms to the asset's BIM record, O and M manuals, warranty terms and work-order history, so the technician is dispatched with the right procedure, part and warranty posture already determined.

Portfolio attributeValue
Primary personaFacility manager
Primary aggregateBuildingAssetOperations
Cosmos DB containers3
Grounding dataBIM, manuals, BMS events, work orders, warranties
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
ProductivityEvidence discovery time15-25% reduction(baseline median evidence-search minutes - assisted median evidence-search minutes) / baseline median evidence-search minutes * 100
Quality or riskRework rate5-10% reduction(baseline reopened, corrected, or repeated task rate - assisted rate) / baseline rate * 100

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: Facility managers can assemble fragmented building and maintenance context faster for human-approved action.

Pilot guardrail: Reconcile BIM, BMS, work-order, manual, and warranty evidence before maintenance action.

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 evidence discovery time and rework rate 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. Alarm correlation and triageBuilding operations assistantBmsAlarm → correlatedFaultSignalPolicy controlled
2. Asset and BIM context resolutionAsset resolvercorrelatedFaultSignal → BuildingAssetPolicy controlled
3. Procedure and warranty groundingRetrieval orchestratorBuildingAsset → ManualProcedureChunkPolicy controlled
4. Dispatch package draftingBuilding operations assistantManualProcedureChunk → DispatchRecommendationPolicy controlled
5. Facility manager dispatch and warranty decisionFacility managerDispatchRecommendation → WorkOrderHuman required

Technical architecture​

Technical architecture

Cosmos DB data model​

ContainerHierarchical partition keyDocumentsSearch paths
buildingAssetOperationses/tenantId, /buildingIdBuildingAsset, BmsAlarm, WorkOrder, DispatchRecommendation/rationaleVectorEmbedding, /rationaleVector
equipmentManualLibrary/tenantId, /modelNumberManualProcedureChunk/chunkVectorEmbedding, /chunkVector
warrantyTermsLibrary/tenantId, /warrantyDocIdWarrantyTermChunk/chunkVectorEmbedding, /chunkVector

Query contract​

QueryContainerScopePurpose
ActiveAlarmsByPrioritybuildingAssetOperationsessingle-partitionShow unacknowledged high-priority alarms across the building for the operations board.
AssetRepeatFaultHistorybuildingAssetOperationsessingle-partitionFind whether this asset has failed the same way before, which changes the diagnosis and the warranty argument.
ModelSpecificProcedureRetrievalequipmentManualLibrarysingle-partitionRetrieve the manufacturer procedure matching the exact model and fault category, with its certification and lockout requirements.
WarrantyCoverageCheckwarrantyTermsLibrarycross-partition-boundedDetermine whether the asset category and fault date fall inside an active warranty or service contract.

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/building-operations-assistant
az login
./Deploy.ps1 -Runtime python -Location eastus2

Change python to csharp to deploy the .NET implementation.

Explore the implementation​

Return to all accelerators