PostHog AI docs (#13614)

* scaffolding

* scaffold two

* posthog ai ascii diagram

* start here

* allow access

* allow access and add memory

* content update

* Fix typos

* typos

* conflict

* tweak

* suggestions

* memory details

* remove deep research and session summaries

* create_experiment tool

* pricing

* pricing

* shorten

* Annika pricing update

Co-authored-by: Annika 🦔 <[email protected]>

* Update contents/docs/posthog-ai/pricing.mdx

Co-authored-by: Annika 🦔 <[email protected]>

---------

Co-authored-by: PostHog <[email protected]>
Co-authored-by: Annika 🦔 <[email protected]>

Author: 3 people

contents/docs/posthog-ai/allow-access.mdx

@@ -0,0 +1,50 @@
+---
+title: Allow PostHog AI access
+---
+
+You can pop PostHog AI open wherever you are in PostHog. Click on the [PostHog AI](https://app.posthog.com/#panel=max) icon in the right-hand sidebar of the app to open the chat.
+
+<ProductScreenshot
+    imageLight="https://res.cloudinary.com/dmukukwp6/image/upload/q_auto,f_auto/posthog_ai_light_99336d67b6.png"
+    imageDark="https://res.cloudinary.com/dmukukwp6/image/upload/q_auto,f_auto/posthog_ai_dark_b4abc2083a.png"
+    alt="Open PostHog AI in the right-hand sidebar"
+    classes="rounded max-h-[480px]"
+/>
+
+<Caption>
+PostHog AI chat is always available in the sidebar
+</Caption>
+
+## Allow access 
+
+In order to use PostHog AI, you need to grant access to your project. This action requires [admin permissions](/docs/settings/access-control) for your organization.
+
+Because PostHog AI features use third-party LLM providers, we require organizations to opt in with admin approval. In most cases, this is just a formality, but we've made it explicit as we take data governance seriously.
+
+There are two ways to grant PostHog AI access to your project as an organization admin.
+
+### Option 1: PostHog AI chat
+
+The very first time you enter a prompt in the chat, PostHog AI will ask you to grant it access to your project. As an admin, you can enable it directly within the chat. 
+
+<ProductVideo
+  videoLight= "https://res.cloudinary.com/dmukukwp6/video/upload/allow_posthog_ai_a148e2f744.mp4" 
+  alt="Allow PostHog AI access" 
+  classes="rounded"
+  autoPlay={true}
+/>
+
+### Option 2: Organization settings
+
+Alternatively, you can enable PostHog AI in your [organization settings](https://app.posthog.com/settings/organization-details#organization-ai-consent).
+
+1. Go to **Settings** > **Organization** > **General**
+2. Find the **PostHog AI data analysis** section
+3. Toggle the switch to "on"
+
+<ProductScreenshot
+    imageLight="https://res.cloudinary.com/dmukukwp6/image/upload/q_auto,f_auto/SCR_20251107_nmhv_aafc81cdbb.png"
+    imageDark="https://res.cloudinary.com/dmukukwp6/image/upload/q_auto,f_auto/SCR_20251107_nmkd_ad9d7dbe15.png"
+    alt="PostHog AI settings"
+    classes="rounded"
+/>

contents/docs/posthog-ai/context-and-commands.mdx

@@ -0,0 +1,36 @@
+---
+title: PostHog AI context and commands
+---
+
+## Adding context
+
+PostHog AI automatically detects the active tab or page you're on to infer context. But you can also manually add other data points from your project for PostHog AI to reference as context.
+
+Click the **@ Add context** button in the chat to include:
+
+- Insights like trends, funnels, retention, etc.
+- Events and actions from your data model
+- Dashboards with insights
+
+<ProductVideo
+  videoLight= "https://res.cloudinary.com/dmukukwp6/video/upload/add_context_81218e0b5d.mp4" 
+  alt="Add context" 
+  classes="rounded"
+  autoPlay={true}
+/>
+
+<Caption>
+  Select data points to include as context
+</Caption>
+
+When you add context, PostHog AI can reference the specific queries, filters, or data from those items when answering your questions.
+
+## Chat commands
+
+PostHog AI supports the following slash `/` commands in the chat. 
+
+| Command | Description |
+| ---     | ----        |
+| `/init`   | PostHog AI collects information about your product and company to save to memory. |
+| `/remember` | Saves your text input to memory. |
+| `/usage` | Displays a breakdown of your [AI credit](/docs/posthog-ai/pricing) usage. |

contents/docs/posthog-ai/edit-memory.mdx

@@ -0,0 +1,31 @@
+---
+title: Edit and save memory to PostHog AI
+---
+
+import {IconGear} from '@posthog/icons'
+
+You can use PostHog AI memory to save context or instructions that persist between conversations. This helps PostHog AI to remember important details about your product, company, or preferred ways of working. 
+
+PostHog AI uses this memory to deliver results that better match your preferences.
+
+<ProductScreenshot
+  imageLight="https://res.cloudinary.com/dmukukwp6/image/upload/q_auto,f_auto/SCR_20251107_ngbw_8c59ce9ef9.png"
+  imageDark="https://res.cloudinary.com/dmukukwp6/image/upload/q_auto,f_auto/SCR_20251107_ngeu_1f6af494ee.png"
+  alt="PostHog AI memory"
+  classes="rounded"
+/>
+
+## Run /init command
+
+To get started, we recommend running the [`/init`](https://app.posthog.com/#panel=max:/init) command in the PostHog AI chat. 
+
+1. If you have a client or mobile SDK installed, PostHog AI will retrieve the URL or app bundle and search the web for more information about your product and then save it to memory.
+2. If little or no data is available, PostHog AI will ask you a few baseline questions to learn more and then save it to memory. 
+
+## Edit memory
+
+You can also access PostHog AI's memory to make direct changes. You can access and edit its memory in three ways: 
+
+1. Click the **gear icon** <span className="inline-block"><IconGear className="w-4 h-4" /></span> in the chat 
+2. Navigate to project **Settings** > **AI**
+3. Run the `/remember` command in the chat to add new information to memory

contents/docs/posthog-ai/example-prompts.mdx

@@ -0,0 +1,81 @@
+---
+title: PostHog AI example prompts
+---
+
+import {IconGraph, IconPieChart,IconRewindPlay, IconDatabase, IconToggle, IconFlask, IconWarning, IconMessage, IconPlug, IconLogomark, IconBook, IconPiggyBank, IconLlmAnalytics} from '@posthog/icons'
+import { CalloutBox } from 'components/Docs/CalloutBox'
+
+PostHog AI can be used in many ways. Because it works directly with your project's data, its responses and actions are unique to your setup. There is no single "correct" way of using PostHog AI.
+
+As a starting point, here are some example chat prompts you can use to explore what's possible with PostHog AI.
+
+<CalloutBox icon="IconInfo" title="LLMs" type="fyi">
+  PostHog AI's responses and findings highly depend on the product data, context, and prompts you provide it. As with all LLM-based systems, its non-deterministic nature means the same prompt can potentially produce different outputs.
+</CalloutBox>
+
+## <span className="inline-block"><IconGraph className="w-6 h-6 -mb-1 text-blue" /></span> Product analytics
+
+- [`Create an insight showing daily active users for the past week`](https://app.posthog.com/#panel=max:!Create%20an%20insight%20showing%20daily%20active%20users%20for%20the%20past%20week)
+- [`Build a dashboard for onboarding retention`](https://app.posthog.com/#panel=max:!Build%20a%20dashboard%20for%20onboarding%20retention)
+- [`What changed across my product this week?`](https://app.posthog.com/#panel=max:!What%20changed%20across%20my%20product%20this%20week?)
+
+## <span className="inline-block"><IconPieChart className="w-6 h-6 -mb-1 text-green-2" /></span> Web analytics
+
+- [`Create a dashboard showing web traffic by source and campaign`](https://app.posthog.com/#panel=max:!Create%20a%20dashboard%20showing%20web%20traffic%20by%20source%20and%20campaign)
+- [`Which landing pages have the highest bounce rate this week?`](https://app.posthog.com/#panel=max:!Which%20landing%20pages%20have%20the%20highest%20bounce%20rate%20this%20week?)
+- [`Find the most common paths users take after visiting the blog`](https://app.posthog.com/#panel=max:!Find%20the%20most%20common%20paths%20users%20take%20after%20visiting%20the%20blog)
+
+## <span className="inline-block"><IconRewindPlay className="w-6 h-6 -mb-1 text-yellow" /></span> Session replay
+
+- [`Find sessions where users dropped off during checkout`](https://app.posthog.com/#panel=max:!Find%20sessions%20where%20users%20dropped%20off%20during%20checkout)
+- [`Summarize session replays where users got stuck`](https://app.posthog.com/#panel=max:!Summarize%20session%20replays%20where%20users%20got%20stuck)
+- [`Show recordings for users who triggered the rage click event`](https://app.posthog.com/#panel=max:!Show%20recordings%20for%20users%20who%20triggered%20the%20rage%20click%20event)
+
+## <span className="inline-block"><IconDatabase className="w-6 h-6 -mb-1 text-lilac" /></span> Data warehouse
+
+- [`List all available tables and their columns`](https://app.posthog.com/#panel=max:!List%20all%20available%20tables%20and%20their%20columns)
+- [`Write a query to join event data with user properties`](https://app.posthog.com/#panel=max:!Write%20a%20query%20to%20join%20event%20data%20with%20user%20properties)
+- [`Fix the syntax for the query I have open in the SQL editor`](https://app.posthog.com/#panel=max:!Fix%20the%20syntax%20for%20the%20query%20I%20have%20open%20in%20the%20SQL%20editor)
+
+## <span className="inline-block"><IconToggle className="w-6 h-6 -mb-1 text-seagreen" /></span> Feature flags
+
+- [`Create a new multivariate feature flag for dark mode`](https://app.posthog.com/#panel=max:!Create%20a%20new%20multivariate%20feature%20flag%20for%20dark%20mode)
+- [`Show me which flags are currently active in production`](https://app.posthog.com/#panel=max:!Show%20me%20which%20flags%20are%20currently%20active%20in%20production)
+
+## <span className="inline-block"><IconFlask className="w-6 h-6 -mb-1 text-purple" /></span> Experiments
+
+- [`Set up an A/B test with a 70/30 split for a new red button on the homepage`](https://app.posthog.com/#panel=max:!Set%20up%20an%20A/B%20test%20with%20a%2070/30%20split%20for%20a%20new%20red%20button%20on%20the%20homepage)
+- [`Summarize experiment results for my latest feature rollout`](https://app.posthog.com/#panel=max:!Summarize%20experiment%20results%20for%20my%20latest%20feature%20rollout)
+
+## <span className="inline-block"><IconWarning className="w-6 h-6 -mb-1 text-yellow" /></span> Error tracking
+
+- [`Find the most common frontend errors this week`](https://app.posthog.com/#panel=max:!Find%20the%20most%20common%20frontend%20errors%20this%20week)
+- [`Which errors impact user sign-ups the most?`](https://app.posthog.com/#panel=max:!Which%20errors%20impact%20user%20sign-ups%20the%20most?)
+- [`Summarize new issues introduced after the latest release`](https://app.posthog.com/#panel=max:!Summarize%20new%20issues%20introduced%20after%20the%20latest%20release)
+
+## <span className="inline-block"><IconPlug className="w-6 h-6 -mb-1 text-seagreen" /></span> Data pipelines
+
+- [`Create a Hog function that filters out internal traffic`](https://app.posthog.com/#panel=max:!Create%20a%20Hog%20function%20that%20filters%20out%20internal%20traffic)
+- [`Parse event timestamps into day, week, and month properties`](https://app.posthog.com/#panel=max:!Parse%20event%20timestamps%20into%20day,%20week,%20and%20month%20properties)
+- [`Drop events where test_mode = true or the environment is staging`](https://app.posthog.com/#panel=max:!Drop%20events%20where%20test_mode%20=%20true%20or%20the%20environment%20is%20staging)
+
+## <span className="inline-block"><IconLlmAnalytics className="w-6 h-6 -mb-1 text-fuchsia-dark" /></span> LLM analytics
+
+- [`Analyze LLM token usage over the past 7 days`](https://app.posthog.com/#panel=max:!Analyze%20LLM%20token%20usage%20over%20the%20past%207%20days)
+- [`Summarize traces for the latest model deployment`](https://app.posthog.com/#panel=max:!Summarize%20traces%20for%20the%20latest%20model%20deployment)
+
+## <span className="inline-block"><IconPiggyBank className="w-6 h-6 -mb-1 text-green-2" /></span> Revenue analytics
+
+- [`Show my revenue for the past year`](https://app.posthog.com/#panel=max:!Show%20my%20revenue%20for%20the%20past%20year)
+- [`Create a dashboard that breaks down revenue by product or feature`](https://app.posthog.com/#panel=max:!Create%20a%20dashboard%20that%20breaks%20down%20revenue%20by%20product%20or%20feature)
+
+## <span className="inline-block"><IconMessage className="w-6 h-6 -mb-1 text-red" /></span> Surveys
+
+- [`Create a new survey to collect feedback on pricing`](https://app.posthog.com/#panel=max:!Create%20a%20new%20survey%20to%20collect%20feedback%20on%20pricing)
+- [`Analyze responses from the latest NPS survey`](https://app.posthog.com/#panel=max:!Analyze%20responses%20from%20the%20latest%20NPS%20survey)
+
+## <span className="inline-block"><IconBook className="w-6 h-6 -mb-1 text-blue" /></span> Docs
+
+- [`Explain how feature flags work in PostHog`](https://app.posthog.com/#panel=max:!Explain%20how%20feature%20flags%20work%20in%20PostHog)
+- [`Find setup instructions for Next.js SDK`](https://app.posthog.com/#panel=max:!Find%20setup%20instructions%20for%20Next.js%20SDK)
+- [`Summarize the differences between trends and funnels`](https://app.posthog.com/#panel=max:!Summarize%20the%20differences%20between%20trends%20and%20funnels)

contents/docs/posthog-ai/faq.mdx

@@ -0,0 +1,49 @@
+---
+title: PostHog AI FAQ
+---
+
+## What access does PostHog AI have to my data?
+
+While working with PostHog AI, you will certainly share some information with it. Data analysis is a core feature. When doing research, PostHog AI can read the following data in your project:
+
+- Events, persons, sessions, groups
+- Actions and cohorts
+- Event and property definitions
+- Data warehouse schema
+
+Based on that context, PostHog AI comes up with queries, runs them, and summarizes the results. Those results can be as high-level as a single number, or as detailed as a list of users with all their properties.
+
+## Is my data shared with third parties?
+
+We use third-party providers to power PostHog AI, so messages and all data accessed by PostHog AI (see list above) are passed through them.
+
+Our list of data subprocessors includes:
+
+- OpenAI and Anthropic – responsible for the core of PostHog AI's functionality, have access to user messages and all data types.
+- Azure – responsible for semantic search across PostHog, has access to actions and cohorts (including their filters)
+
+Other providers that are not data subprocessors:
+
+- Perplexity – responsible for providing context about your product and/or company, has access to domain name (for websites) or application bundle ID (for mobile applications). We do not send any of your data.
+
+## How can I disable PostHog AI?
+
+With [admin permissions](/docs/settings/access-control) for your organization, you can disable PostHog AI and all AI data analysis in your [organization settings](https://app.posthog.com/settings/organization-details#organization-ai-consent).
+
+1. Go to **Settings** > **Organization** > **General**
+2. Find the **PostHog AI data analysis** section
+3. Toggle the switch to "off"
+
+When disabled, PostHog AI won't be available and no data will be shared with AI providers. This can be reversed at any time.
+
+## Can I hide PostHog AI?
+
+There currently isn't a toggle to _hide_ AI features altogether. However, in any case, only org admins can approve AI features in the organization – so there's no risk of data being sent to any AI provider without explicit consent.
+
+## Is my chat history retained if I disable and re-enable PostHog AI? 
+
+Yes, PostHog AI retains your chat history.
+
+## Can I self-host PostHog AI and use my own models?
+
+No, PostHog AI is only available in the cloud-hosted [PostHog app](https://app.posthog.com), which uses third-party LLM providers. PostHog automatically selects the most efficient model for each AI feature. 

contents/docs/posthog-ai/investigate-web-traffic.mdx

@@ -0,0 +1,41 @@
+---
+title: Investigate web traffic with PostHog AI
+---
+
+import WistiaEmbed from 'components/WistiaEmbed'
+
+This guide shows you how the PostHog team uses PostHog AI to investigate web traffic. It includes a video demo and the prompts used to create insights, build dashboards, and analyze data from [web analytics](/docs/web-analytics) and [session replays](/docs/session-replay).
+
+This demo example uses our own internal PostHog project. The results will differ based on your project's specific setup and the data that's available to PostHog AI.
+
+## Video demo
+
+<WistiaEmbed mediaId="tgws1dixc0" className="mb-5" />
+
+<Caption>
+How PostHog uses PostHog AI to investigate web traffic
+</Caption>
+
+## Conversation with PostHog AI
+
+Here's the full conversation with PostHog AI.
+
+**Prompt #1**
+
+> Add a graph series for unique users.
+
+**Prompt #2**
+
+> There’s an odd traffic spike happening around September 29th. Create a dashboard of insights with traffic breakdowns by referral, country, user agent, and operating system to further investigate what the root cause is.
+
+**Prompt #3**
+
+> Create a new insight with traffic breakdown by IP address. Any suspicious traffic behavior here?
+
+**Prompt #4**
+
+> Find the session replays for that specific IP address over the last 60 days.
+
+**Prompt #5**
+
+> Summarize these session recordings in a report for me and provide key findings.

contents/docs/posthog-ai/index.mdx renamed to contents/docs/posthog-ai/overview.mdx

@@ -1,5 +1,5 @@
 ---
-title: PostHog AI
+title: PostHog AI overview
 sidebar: Docs
 showTitle: true
 ---
@@ -10,7 +10,7 @@ import { CalloutBox } from 'components/Docs/CalloutBox'
 
 - **Research answers** to product questions by querying the data.
 - **Get things done** quickly in the PostHog UI for you like update filters, create insights, write SQL, find session replays, make surveys, and more.
-- **Explain PostHog** features and how to use them (based on our docs).
+- **Explain PostHog** features and how to use them based on our docs.
 - **Chit-chat** about anything PostHog-related really.
 
 ## How do I access PostHog AI?

contents/docs/posthog-ai/platform-and-chat-ui.mdx

@@ -0,0 +1,71 @@
+---
+title: 'PostHog AI: platform and chat UI'
+---
+
+import { IconSparkles } from '@posthog/icons'
+
+PostHog AI powers all AI features within the [PostHog app](https://app.posthog.com). It is an AI agent that sits on top of the PostHog platform. As a result, there are multiple ways of working with PostHog AI.
+
+Here's an overview of the different UIs for interacting with PostHog AI.
+
+## In-app chat
+
+The primary dedicated interface is an in-app <a href="https://app.posthog.com/#panel=max">AI chat</a> for conventional prompting and conversation-based flows.
+
+When logged in, the PostHog AI chat is always available in the right-hand sidebar of the PostHog app. You can open it at any time by clicking the PostHog AI icon.
+
+<ProductVideo
+    videoLight="https://res.cloudinary.com/dmukukwp6/video/upload/posthog_ai_sidebar_4k_compressed_75af4f4370.mp4" 
+    alt="PostHog AI chat" 
+    classes="rounded"
+    autoPlay={true}
+/>
+
+<Caption>
+The PostHog AI chat is always available in the sidebar
+</Caption>
+
+The in-app chat supports conversation history and features like [context, commands, and memory](/docs/posthog-ai/context-and-commands).
+
+## Platform UI
+
+PostHog AI shows up throughout the PostHog platform as inline or ambient UI elements, typically labelled with the <span className="inline-block"><IconSparkles className="h-4 w-4" /> </span> icon, and embedded within other features.
+
+These entrypoints or shortcuts enable you to trigger PostHog AI directly from the PostHog UI.
+
+<ProductVideo
+    videoLight="https://res.cloudinary.com/dmukukwp6/video/upload/posthog_ai_platform_compressed_a7d9048b08.mp4" 
+    alt="PostHog AI platform UI" 
+    classes="rounded"
+    autoPlay={true}
+/>
+
+<Caption>
+PostHog AI can be accessed throughout the platform UI
+</Caption>
+
+## Website chat
+
+PostHog AI is also accessible when logged out of the app and on the website, [posthog.com](/). However, in this mode, it's limited to searching and answering questions about PostHog's documentation.
+
+<ProductVideo
+    videoLight="https://res.cloudinary.com/dmukukwp6/video/upload/website_posthog_ai_compressed_78452d5325.mp4" 
+    alt="PostHog AI website chat" 
+    classes="rounded"
+    autoPlay={true}
+/>
+
+<Caption>
+You can chat with PostHog AI about documentation when logged out 
+</Caption>
+
+## Future interfaces
+
+We are working on adding more form factors to expand PostHog AI's capabilities. These may include: 
+
+- Notebooks for deep research and reports
+- Background tasks and workflows
+- API calls 
+- MCP tool calls
+
+If you have any feedback or ideas, feel free to reach out to us on [GitHub](https://github.com/posthog/posthog/issues) and open a feature request.