Decision owner
Licensed broker
The named role remains accountable for the consequential decision.
Real Estate & Construction
Designed for Buyer, tenant, or broker
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.
Contract REA-01 · primary aggregate PropertyListing · mode loading
Decision brief
This brief starts with the decision, evidence, and accountable owner. The guided workflow then shows how the recommendation was produced.
The evidence and control points that shape this recommendation.
Decision owner
Licensed broker
The named role remains accountable for the consequential decision.
Governed evidence
6 record types
Structured records and cited text ground the recommendation.
Workflow
5 controlled stages
Each transition records its input, output, status, and audit context.
Human controls
1 approval gate
Approval gates prevent the copilot from making consequential decisions.
A relocating buyer states a 640,000 dollar ceiling, three bedrooms, a maximum 35-minute transit commute to a downtown anchor, and no HOA above 250 dollars monthly.
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.
deliveredAdvisory gives Licensed broker the evidence needed to begin the final governed business outcome, with the decision trail retained for review.
Step 1 of 5
| Field | Value |
|---|
| Field | Value |
|---|
The output appears here immediately. More technical evidence remains available below.
The demonstration keeps deterministic controls, AI assistance, and approval separate.
Source systems enforce identity, workflow order, policy filters, and record updates.
Retrieval and generation assemble relevant evidence into a cited recommendation or draft.
Licensed broker verifies material claims and approves the consequential action.
Run the stages in order before using the Copilot. Every stage explains what happens, why it matters, the evidence it uses, and the complete API request and response.
Automated stage
What happens: Buyer, tenant or broker performs declared requirement capture using clientConversation and produces BuyerRequirementProfile. The transition is deterministic and does not require autonomous model approval.
Why it matters: BuyerRequirementProfile gives Property search and advisory copilot the evidence needed to begin Criteria-based candidate retrieval, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/declared-requirement-capture
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Property search and advisory copilot performs criteria-based candidate retrieval using BuyerRequirementProfile and produces candidateListingSet. The transition is deterministic and does not require autonomous model approval.
Why it matters: candidateListingSet gives Valuation analyzer the evidence needed to begin Comparable and price positioning, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/criteria-based-candidate-retrieval
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Valuation analyzer performs comparable and price positioning using MarketComparable and produces pricePositionAnalysis. The transition is deterministic and does not require autonomous model approval.
Why it matters: pricePositionAnalysis gives Compliance guardrail service the evidence needed to begin Fair-housing compliance screening, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/comparable-and-price-positioning
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Compliance guardrail service performs fair-housing compliance screening using AdvisoryBrief and produces fairHousingCheckResult. The transition is deterministic and does not require autonomous model approval.
Why it matters: fairHousingCheckResult gives Licensed broker the evidence needed to begin Broker review before client delivery, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/fair-housing-compliance-screening
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Licensed broker performs broker review before client delivery using AdvisoryBrief and produces deliveredAdvisory. A named human approver must review the evidence before the transition completes.
Why it matters: deliveredAdvisory gives Licensed broker the evidence needed to begin the final governed business outcome, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/broker-review-before-client-delivery
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Run a stage to see its explanation, evidence, full request, and full response.
Ask a question and receive an answer grounded in retrieved PropertyListing evidence.
Select a starter question or enter your own.
Loaded live from /api/config, /api/domain/model, and
/api/domain/sample.
propertyListings/tenantId + /listingIdA relocating buyer states a 640,000 dollar ceiling, three bedrooms, a maximum 35-minute transit commute to a downtown anchor, and no HOA above 250 dollars monthly. The copilot returns nine candidates, flags that two exceed the HOA ceiling, and for the leading candidate shows an asking price 4.2 percent above five adjusted comparables within half a mile closed in the last 120 days. It supplies flood zone X, the 2024 millage rate and the transit line headway, all with issuing authorities named. A phrasing about neighborhood character is caught by the fair-housing guardrail and rewritten to cite only the published transit and tax facts before the broker reviews and delivers the advisory.
| Container | Role | Hierarchical partition key | Document types |
|---|---|---|---|
propertyListings |
Primary | /tenantId + /listingId |
Listing, ListingDetail, MarketComparable, BuyerRequirementProfile, AdvisoryBrief |
neighborhoodFactLibrary |
Reference | /tenantId + /geographyCode |
NeighborhoodFactChunk |
| Type | Container | Partition key | Identifier pattern | Embedding fields |
|---|---|---|---|---|
Listing |
propertyListings |
/tenantId + /listingId |
listing::{listingId} |
None |
ListingDetail |
propertyListings |
/tenantId + /listingId |
listing::{listingId}::detail::{detailId} |
narrativeVector |
MarketComparable |
propertyListings |
/tenantId + /listingId |
listing::{listingId}::comp::{compListingId} |
None |
NeighborhoodFactChunk |
neighborhoodFactLibrary |
/tenantId + /geographyCode |
geography::{geographyCode}::fact::{factDocId}::{chunkOrdinal} |
chunkVector |
BuyerRequirementProfile |
propertyListings |
/tenantId + /listingId |
listing::{listingId}::requirement::{clientPseudoId} |
None |
AdvisoryBrief |
propertyListings |
/tenantId + /listingId |
listing::{listingId}::advisory::{advisoryId} |
advisoryVector |
Return active listings matching the client's declared must-haves and budget in the target market areas. Application-side partition-key fan-out listing search: bounded by the tenantId prefix, active status, the buyer's target market areas and declared price and bedroom limits.
propertyListings
partition-key-fan-out
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.type = 'Listing' AND c.listingStatus = 'active' AND ARRAY_CONTAINS(@targetMarketAreas, c.marketAreaCode) AND c.listPriceUsd <= @budgetCeilingUsd AND c.bedroomCount >= @minBedrooms ORDER BY c.listPriceUsd ASC
Pull recent comparable closings near the listing to explain where its asking price sits.
propertyListings
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.listingId = @listingId AND c.type = 'MarketComparable' AND c.closedAtUtc >= @lookbackUtc AND c.distanceMiles <= @radiusMiles ORDER BY c.closedAtUtc DESC
Retrieve only neighborhood facts classified as fair-housing permissible for the question asked.
neighborhoodFactLibrary
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.geographyCode = @listingGeographyCode AND c.type = 'NeighborhoodFactChunk' AND c.fairHousingClassification = 'permissible' AND c.factCategory = @factCategory ORDER BY RANK RRF(VectorDistance(c.chunkVector, @queryVector), FullTextScore(c.chunkText, @queryTerms))
Queue drafted advisories that a licensed broker must review before delivery. Application-side partition-key fan-out broker review queue: bounded by the tenantId prefix, the pending review state and a cleared fair-housing check.
propertyListings
partition-key-fan-out
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.type = 'AdvisoryBrief' AND c.reviewState = 'pending' AND c.fairHousingCheckResult = 'clear' ORDER BY c.generatedAtUtc ASC