# Growthfactor Agent

The **Growthfactor Agent** is a conversational AI analyst built into the GrowthFactor app. Ask it a question in plain English and it carries out the work using the same tools you'd use yourself — finding sites, scoring locations, pulling demographics, running cannibalization, fetching foot traffic, and assembling trade zones — then surfaces the results back as text, tables, and map layers.

***

## Opening the Agent

{% columns %}
{% column valign="middle" %}
Open the agent from the sidebar in any dashboard view. It opens in a side panel, next to a map of your sites.
{% endcolumn %}

{% column %}

<figure><img src="/files/1nS5ewWQZ1pMIfG6sBL9" alt="" width="280"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

## What you can ask

The agent is best at the kinds of questions you'd otherwise click through several screens to answer. A few starting points:

* **Find sites** — "Find me three candidate sites in Charlotte with strong daytime population and low cannibalization."
* **Score a location** — "Score 1234 Main St, Austin, TX."
* **Pull demographics** — "What's the median household income in a 3-mile ring around 500 5th Ave, NYC?"
* **Run cannibalization** — "If I open at 100 King St, Charleston, which of my existing stores would be cannibalized?"
* **Pull foot traffic** — "What's the weekly foot-traffic trend for the Starbucks at 200 Park Ave?"
* **Compare options** — "Compare the trade-area demographics for these three addresses."

***

## How results show up

* **Text and tables** — answers appear inline in the chat, with tables for multi-row results
* **Map layers** — when the agent runs an analysis that produces geography (trade zones, cannibalization, candidate sites), the resulting layer appears in the **map legend** so you can toggle it alongside your other layers
* **Conversation history** — scroll back through your session to revisit prior turns; a thinking indicator shows between submit and the first response

## Workspace context

The agent reads context from the **active workspace** you're in:

* Site Score lenses and weights
* Default trade-zone definition
* Tracked brands and categories
* Brand-specific model defaults

If you're in a sub-workspace, the agent uses **that** sub-workspace's context, not the root workspace's. To run a question against a different workspace's context, switch workspaces first.

You can also ask the agent to use a **specific trade zone** in your question (e.g., "use a 5-minute drive time"), and it will use that instead of the workspace default for that turn.

***

## Tips for good results

* **Be specific about location** — full addresses or named places work better than vague descriptions
* **Specify the trade zone** if the default isn't what you want
* **Iterate** — the agent has conversation history, so you can refine ("now do the same for these other three addresses") instead of restarting
* **Share feedback** — the agent is new and improving quickly; let us know what worked and what didn't at <analyst@growthfactor.ai>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.growthfactor.ai/analyze-site-intelligence-and-selection/growthfactor-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.