Emanuele Capparelli 001b04a34a fix(ph-ai): clarify prompt about person id join limitation (#41446) ...

## Problem

The current documentation for the `person_id_join_limitation` in HogQL AI generation is unclear and lacks comprehensive guidance on how to properly handle joins involving person_id fields. This leads to agents creating queries that result in ClickHouse errors due to forward references to override tables.

## Changes

Enhanced the `person_id_join_limitation` documentation in both `ee/hogai/graph/sql/prompts.py` and `posthog/hogql/ai.py` to:

## How did you test this code?

Hopefully it solves [https://us.posthog.com/project/2/error_tracking/0199e7eb-4ec0-73b1-8bc5-937a564aa75d?timestamp=2025-11-10T12%3A14%3A39.085000-08%3A00](error), will monitor

2025-11-13 15:14:22 +00:00

..

test

feat: Add new TableNode to support overlapping database names (#40000)

2025-10-28 11:02:14 -03:00

__init__.py

refactor(max): MaxTool mechanism for every product (#30705)

2025-04-10 13:05:04 +00:00

mixins.py

refactor: Replace create_hogql_database with Database.create_for (#40156)

2025-10-28 15:22:36 +00:00

nodes.py

feat(max): agent abstraction (#40539)

2025-11-10 19:24:35 +01:00

prompts.py

fix(ph-ai): clarify prompt about person id join limitation (#41446)

2025-11-13 15:14:22 +00:00

toolkit.py

feat(max): Query planning using reasoning with tools (#33288)

2025-07-16 17:45:12 +01:00