Prompts

Overview

Every time AIEO fires a prompt against an AI engine, the complete response is stored — not just a parsed summary. The Prompts explorer gives your team full transparency into the raw data behind every visibility score, attribution result, and monitor alert.

This is where you go when you need to understand why a metric changed, not just that it changed.

---

Prompt History

The prompt history view lists every prompt run, sorted by most recent. Each row shows:

Click any row to open the full response detail view, which shows the complete raw AI response text and all extracted metadata.

---

Searching and Filtering

Use the search bar and filter panel to narrow the history:

• Search — full-text search across prompt text and response content
• Engine filter — show only runs from a specific AI engine
• Date range — restrict to a time window
• Brand mention — show only runs where your brand was cited, or only where it wasn't
• Prompt cluster — filter by topic cluster or intent tag
• Run ID — jump directly to a specific audit run

Filters combine with AND logic. Saved filter presets can be named and reused.

---

Response Diffs

To compare two runs of the same prompt:

1. Select a prompt from the history list.
2. In the detail view, click Compare runs.
3. Choose two run dates to compare.

The diff view highlights:

• Text added or removed between runs
• Brand mentions that appeared or disappeared
• Citation URLs that changed
• Sentiment classification changes

Diffs are useful for root-cause analysis: when a visibility metric drops, find the exact prompt and response where the change occurred, and see precisely what the AI said differently.

---

Prompt Corpus Management

Manage your tracked prompt set from Prompts → Corpus:

• Add prompts — manually enter new queries or import from CSV
• Edit prompts — update query text without losing historical run data
• Archive prompts — remove prompts from future runs while preserving history
• Tag prompts — apply intent tags (informational, commercial, navigational) and funnel stage labels
• Cluster view — see how prompts are grouped by topic for AEO Audit analysis

Changes to the corpus take effect on the next scheduled or manual run.

---

Exporting Data

From the Prompts explorer:

• CSV export — download the full prompt history (or a filtered subset) as a flat file with all metadata columns
• API access — query prompt history programmatically via the AIEO REST API; see Settings → API for your key and endpoint docs
• Shared views — generate a read-only shareable link to a filtered prompt view for teammates or clients who don't have an AIEO login

Exports include: prompt text, engine, run timestamp, full response text, brand mention status, competitor mentions, and extracted citation URLs.

---

Data Retention

Prompt responses are retained for:

---

Related

• AI Visibility — the aggregate metrics built from prompt run data
• AEO Audit — prompt attribution matrix derived from this history
• Monitors — alerts that reference specific prompt change events