Skip to content

docs: document period-over-period comparisons in AI agents#655

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
docs/ai-agents-period-comparisons
Open

docs: document period-over-period comparisons in AI agents#655
mintlify[bot] wants to merge 1 commit into
mainfrom
docs/ai-agents-period-comparisons

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 18, 2026

Summary

Documents the new period-over-period (PoP) comparison capability in the AI agent's query tool, so users know they can ask for "revenue vs last month", "year-over-year users", or similar prompts and get a comparison column alongside the base metric.

Changes

  • Added a Period-over-period comparisons example use case to guides/ai-agents/using-ai-agents.mdx covering:
    • Example prompts users can send to the agent
    • Requirements the agent enforces (time dimension, granularity, offset)
    • Cases that aren't a fit (MTD/YTD totals, percent-change columns)

Context

Upstream change adds a periodComparisons field to the AI runQuery tool, enabling agents to generate PoP shifted columns automatically. Users previously had to build these comparisons manually in the explorer.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 18, 2026

🤖 Documentation Bot

All checks passed! No issues found.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 18, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview May 18, 2026, 3:47 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants