> ## Documentation Index
> Fetch the complete documentation index at: https://terrascout.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Property Search Agent

> A dedicated site scout trained to find properties matching your specifications

<Info>
  **A dedicated site scout trained to find properties matching your exact specifications.**
</Info>

## Overview

| Property              | Value                                           |
| --------------------- | ----------------------------------------------- |
| **Boundary Required** | Yes                                             |
| **Best For**          | Finding properties that match specific criteria |
| **Workflow**          | Structured two-phase: Planning → Execution      |

## How It Works

The Property Search Agent uses a structured two-phase workflow to methodically identify viable sites.

### Phase 1: Planning

When you start a conversation, the agent will:

<Steps>
  <Step title="Understand your requirements">
    Ask clarifying questions about what you're looking for—lot size, zoning, use case, etc.
  </Step>

  <Step title="Research jurisdictions">
    Analyze the municipalities within your boundary to understand local regulations
  </Step>

  <Step title="Study zoning codes">
    Research relevant ordinances and development requirements
  </Step>

  <Step title="Create a plan">
    Develop a detailed search strategy tailored to your criteria
  </Step>
</Steps>

### Phase 2: Execution

Once you approve the plan, the agent will:

<Steps>
  <Step title="Follow the plan">
    Systematically work through each step of the search strategy
  </Step>

  <Step title="Create checkpoints">
    Save intermediate results for complex multi-step queries
  </Step>

  <Step title="Validate findings">
    Cross-reference properties against your criteria
  </Step>

  <Step title="Report results">
    Present matching properties with supporting documentation
  </Step>
</Steps>

## When to Use

<CardGroup cols={2}>
  <Card title="Use Property Search Agent when:" icon="check">
    * You have specific criteria for properties you're looking for
    * You want a systematic, thorough search
    * You need to find sites within a defined market area
    * Accuracy is more important than speed
  </Card>

  <Card title="Consider a different agent when:" icon="xmark">
    * You're just exploring without specific criteria
    * You need to work across multiple disconnected areas
    * You want more control over the research direction
  </Card>
</CardGroup>

## Example Workflow

```
You: "I need to find sites for a 10,000 SF retail development"

Agent: "I'll help you find suitable sites. Let me ask a few questions:
        - What's your minimum lot size requirement?
        - Do you have parking ratio requirements?
        - Are there any zoning types you want to exclude?"

You: "At least 1 acre, need 4 spaces per 1000 SF, no industrial zones"

Agent: "I've analyzed the jurisdictions in your boundary. Here's my plan:
        1. Research zoning codes for [City A] and [City B]
        2. Identify zones allowing retail with sufficient density
        3. Filter parcels by size (≥1 acre)
        4. Verify parking can be accommodated
        5. Compile results with zoning documentation

        Should I proceed with this plan?"

You: "Yes, go ahead"

Agent: [Executes plan, creates checkpoints, returns matching properties]
```

## Key Features

### Checkpoint System

The agent saves intermediate results as checkpoints, allowing for:

* Complex multi-step queries that build on previous results
* Memory of previous findings across the search
* Efficient refinement without re-running work

### Municipality Research

Before searching, the agent:

* Identifies all jurisdictions in your boundary
* Researches their specific zoning codes
* Documents ordinance requirements with citations

### Structured Output

Results include:

* List of matching properties with key details
* Zoning documentation for each property
* Map visualization of findings
* Supporting research documents

## Tips for Best Results

<Steps>
  <Step title="Define clear criteria">
    The more specific your requirements, the better the results. Include lot size, zoning preferences, use case, and any deal-breakers.
  </Step>

  <Step title="Draw a focused boundary">
    Smaller boundaries enable faster, more accurate searches. Focus on your target market area.
  </Step>

  <Step title="Review the plan">
    Make sure the agent's plan aligns with your needs before execution. Ask for changes if needed.
  </Step>

  <Step title="Provide feedback">
    If results aren't quite right, refine your criteria. The agent learns from your feedback within the session.
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Boundary Restrictions" icon="bullseye" href="/agents/restricted-vs-unrestricted">
    Learn more about how boundaries work
  </Card>

  <Card title="General Agent" icon="compass" href="/agents/general-agent">
    Explore the flexible General Agent
  </Card>
</CardGroup>