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

Property Search and Advisory Copilot

Outcome​

Help a buyer, tenant or broker narrow a property search using verified listing attributes, neighborhood and geospatial context and financial feasibility, while keeping every statement inside fair-housing bounds and grounded in disclosed listing data rather than inference about occupants.

Portfolio attributeValue
Primary personaBuyer, tenant, or broker
Primary aggregatePropertyListing
Cosmos DB containers2
Grounding datalistings, amenities, geospatial and market data
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
ProductivityShortlist and comparison time20-35% reduction(baseline median property-search minutes - assisted median minutes) / baseline median minutes * 100
Quality or riskAccepted recommendations5-10 percentage-point improvementassisted percentage of recommendations accepted - baseline percentage

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: Buyers, tenants, and brokers can compare listings and market evidence faster, subject to current data coverage.

Pilot guardrail: Disclose listing, availability, price, amenity, geospatial, and market-data freshness limitations.

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 shortlist and comparison time and accepted recommendations 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. Declared requirement captureBuyer, tenant or brokerclientConversation → BuyerRequirementProfilePolicy controlled
2. Criteria-based candidate retrievalProperty search and advisory copilotBuyerRequirementProfile → candidateListingSetPolicy controlled
3. Comparable and price positioningValuation analyzerMarketComparable → pricePositionAnalysisPolicy controlled
4. Fair-housing compliance screeningCompliance guardrail serviceAdvisoryBrief → fairHousingCheckResultPolicy controlled
5. Broker review before client deliveryLicensed brokerAdvisoryBrief → deliveredAdvisoryHuman required

Technical architecture​

Technical architecture

Cosmos DB data model​

ContainerHierarchical partition keyDocumentsSearch paths
propertyListings/tenantId, /listingIdListing, ListingDetail, MarketComparable, BuyerRequirementProfile, AdvisoryBrief/narrativeVectorEmbedding, /advisoryVectorEmbedding, /narrativeVector, /advisoryVector
neighborhoodFactLibrary/tenantId, /geographyCodeNeighborhoodFactChunk/chunkVectorEmbedding, /chunkVector

Query contract​

QueryContainerScopePurpose
CandidateListingsByDeclaredCriteriapropertyListingscross-partition-boundedReturn active listings matching the client's declared must-haves and budget in the target market areas. Intentional cross-partition listing search: bounded by the tenantId prefix, active status, the buyer's target market areas and declared price and bedroom limits.
ComparablesForPricePositionpropertyListingssingle-partitionPull recent comparable closings near the listing to explain where its asking price sits.
PermissibleNeighborhoodFactsneighborhoodFactLibrarysingle-partitionRetrieve only neighborhood facts classified as fair-housing permissible for the question asked.
AdvisoriesAwaitingBrokerReviewpropertyListingscross-partition-boundedQueue drafted advisories that a licensed broker must review before delivery. Intentional cross-partition broker review queue: bounded by the tenantId prefix, the pending review state and a cleared fair-housing check.

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/property-search-and-advisory-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