# Autoplay SDK

> Powering real-time, context-aware onboarding and adoption agents

## Docs

- [Overview](https://developers.autoplay.ai/who-we-are/overview.md): The future of customer support agents isn't reactive. It's Autoplay.
- [Our Story](https://developers.autoplay.ai/who-we-are/our-story.md): Why we built Autoplay — to surface the right guidance at the right time
- [Use cases](https://developers.autoplay.ai/who-we-are/use-cases.md): Common Autoplay integration patterns across support, retention, and product-led growth.
- [Pricing](https://developers.autoplay.ai/who-we-are/pricing.md): Plans priced by how many end users receive proactive, personalized assistance from Autoplay.
- [Proactive onboarding with Autoplay](https://developers.autoplay.ai/sdk/proactive-onboarding-agent.md): Help users reach value, recover from stalled workflows, and continue learning your product without replacing the tools already in your stack.
- [Step 1: Connect live user activity](https://developers.autoplay.ai/sdk/proactive-onboarding-agent/step-1-connect-live-user-activity.md): Help the onboarding agent understand what a user has and has not tried so it can guide them to the right next step.
- [Step 2: Define the onboarding objective](https://developers.autoplay.ai/sdk/proactive-onboarding-agent/step-2-define-onboarding-objective.md): Define what each user segment should learn, what successful and unsuccessful progress look like, and how you will measure the result.
- [Step 3: Add the proactive framework](https://developers.autoplay.ai/sdk/proactive-onboarding-agent/step-3-add-proactive-framework.md): Configure when Autoplay may offer help, how frequently it can intervene, and what happens after the user accepts.
- [Step 4: Build the agent self-improvement loop](https://developers.autoplay.ai/sdk/proactive-onboarding-agent/step-4-agent-self-improvement-loop.md): Use workflow outcomes to improve onboarding and extend guidance into continual product adoption.
- [🚀 Quickstart](https://developers.autoplay.ai/quickstart.md): Stream real-time user events into your support AI agents in a couple lines of code.
- [PostHog — How to setup](https://developers.autoplay.ai/recipes/posthog/how-to-setup.md): Learn how to connect existing PostHog live user activity to your support AI agent using the Autoplay SDK.
- [Amplitude — How to setup](https://developers.autoplay.ai/recipes/amplitude/how-to-setup.md): Learn how to stream live user activity from Amplitude into Autoplay to give your support AI agent real-time context on what every user is doing.
- [FullStory — How to setup](https://developers.autoplay.ai/recipes/fullstory/how-to-setup.md): Learn how to set up live user activity from FullStory to feed as context to your support AI agent using the Autoplay SDK.
- [Datadog — How to setup](https://developers.autoplay.ai/recipes/datadog/how-to-setup.md): Learn how to set up live user activity from Datadog to feed as context to your support AI agent using the Autoplay SDK.
- [Pendo — How to setup](https://developers.autoplay.ai/recipes/pendo/how-to-setup.md): Trigger a Pendo tour from the Autoplay event stream.
- [Connect real-time events](https://developers.autoplay.ai/recipes/intercom-tutorial/step-1-connect-real-time-events.md): Connect Intercom Fin to a user's recent in-app activity via the Autoplay MCP server — one MCP connection, one tool, with Messenger JWT identity verification.
- [Maven + Autoplay](https://developers.autoplay.ai/recipes/maven/index.md): Give Maven live activity context and guided tours through the Autoplay MCP server.
- [Connect real-time events](https://developers.autoplay.ai/recipes/maven/step-1-connect-real-time-events.md): Connect Maven to a user's recent in-app activity via the Autoplay MCP server, with verified user identity.
- [Step 2 — Add proactive layer](https://developers.autoplay.ai/recipes/maven/step-2-define-proactive-triggers.md): Use Autoplay.js, a tour provider, and Maven MCP tools to offer and launch guided onboarding tours from Maven.
- [Connect real-time events](https://developers.autoplay.ai/recipes/dify-tutorial/step-1-connect-real-time-events.md): Give your Dify Agent live awareness of what each user is doing — the agent pulls it on demand via the Autoplay MCP server.
- [Connect real-time events](https://developers.autoplay.ai/recipes/crisp-ai/step-1-connect-real-time-events.md): Give Hugo live awareness of what each user is doing in your app — Hugo pulls it on demand via the Autoplay MCP server.
- [Rasa tutorial](https://developers.autoplay.ai/recipes/rasa/index.md): Give your Rasa support AI agent live awareness of what users are doing in your web app — using Autoplay's open SDK, fully self-hosted.
- [Connect real-time events](https://developers.autoplay.ai/recipes/rasa/step-1-connect-real-time-events.md): Pull a user's live actions on demand into a Rasa-aware bridge using the Autoplay SDK, expose them to Rasa over HTTP, and wire the chat widget.
- [Inkeep tutorial](https://developers.autoplay.ai/recipes/inkeep/index.md): Give Inkeep's AI chat live awareness of what users are doing — so it can explain blockers, surface missing steps, and guide the next action in context.
- [Connect real-time events](https://developers.autoplay.ai/recipes/inkeep/step-1-connect-real-time-events.md): Pull a user's live activity from Autoplay on demand, expose it over a simple HTTP endpoint, and wire InkeepEmbeddedChat with a pre-loaded intro message.
- [Connect real-time events](https://developers.autoplay.ai/recipes/plain-tutorial/step-1-connect-real-time-events.md): Attach a user's last 10 in-app actions to every Plain support thread automatically — one Machine User credential, one API route, one widget callback.
- [Connect real-time events](https://developers.autoplay.ai/recipes/tidio/step-1-connect-real-time-events.md): Give Lyro live awareness of what each user is doing — Lyro pulls it on demand via an Action that calls the Autoplay MCP server.
- [Botpress tutorial](https://developers.autoplay.ai/recipes/botpress/index.md): Capture live website interactions with the Autoplay SDK and pull them into a Botpress agent on demand for real-time context.
- [Connect real-time events](https://developers.autoplay.ai/recipes/botpress/step-1-connect-real-time-events.md): Pull a user's live activity on demand from the Autoplay connector and wire an Autonomous Agent to answer with real-time context.
- [Landbot tutorial](https://developers.autoplay.ai/recipes/landbot/index.md): Connect live user data from the Autoplay SDK straight into your Landbot agent for real-time context-aware conversations.
- [Connect real-time events](https://developers.autoplay.ai/recipes/landbot/step-1-connect-real-time-events.md): Set up the Landbot workflow, wire a lightweight backend server, and embed the support AI agent in your frontend app.
- [Ada tutorial](https://developers.autoplay.ai/recipes/ada/index.md): Pull live user activity with the Autoplay SDK and surface it to an Ada agent on demand for real-time context.
- [Connect real-time events](https://developers.autoplay.ai/recipes/ada/step-1-connect-real-time-events.md): Pull a user's live activity from Autoplay on demand and inject it into Ada's AI Agent via metaFields.
- [How to trigger a User Tour](https://developers.autoplay.ai/recipes/user-tour/overview.md): Learn how to trigger any user tour provider from your backend using the Autoplay event stream.
- [Appcues — How to setup](https://developers.autoplay.ai/recipes/appcues/how-to-setup.md): Trigger an Appcues tour from the Autoplay event stream.
- [Userpilot — How to setup](https://developers.autoplay.ai/recipes/userpilot/how-to-setup.md): Trigger a Userpilot tour from the Autoplay event stream.
- [Chameleon — How to setup](https://developers.autoplay.ai/recipes/chameleon/how-to-setup.md): Trigger a Chameleon tour from the Autoplay event stream.
- [Userflow — How to setup](https://developers.autoplay.ai/recipes/userflow/how-to-setup.md): Trigger a Userflow tour from the Autoplay event stream.
- [Usertour — How to setup](https://developers.autoplay.ai/recipes/usertour/how-to-setup.md): Trigger a Usertour tour from the Autoplay event stream.
- [UserGuiding — How to setup](https://developers.autoplay.ai/recipes/userguiding/how-to-setup.md): Trigger a UserGuiding tour from the Autoplay event stream.
- [Told — How to setup](https://developers.autoplay.ai/recipes/told/how-to-setup.md): Trigger a Told tour from the Autoplay event stream.
- [Typed payloads](https://developers.autoplay.ai/sdk/typed-payloads.md): ActionsPayload, SummaryPayload, and SlimAction — the typed models your callbacks receive.
- [ConnectorClient](https://developers.autoplay.ai/sdk/sync-client.md): Sync SSE client. Callbacks run on a dedicated worker thread — blocking I/O is safe.
- [AsyncConnectorClient](https://developers.autoplay.ai/sdk/async-client.md): Async SSE client for asyncio pipelines. Callbacks are async def coroutines.
- [EventBuffer](https://developers.autoplay.ai/sdk/event-buffer.md): Pull-based event access — collect real-time events and read them whenever you need.
- [WebhookReceiver](https://developers.autoplay.ai/sdk/webhook-receiver.md): Typed push webhook receiver — HMAC verification and typed payload parsing for push-mode integrations.
- [MCP server](https://developers.autoplay.ai/mcp/server.md): The recommended way for any AI agent to pull a user's live in-app activity on demand — one MCP endpoint, agent-agnostic, Bearer-authenticated.
- [Connect an AI agent](https://developers.autoplay.ai/activity/connect-an-agent.md): Wire any AI support agent to pull a user's live in-app activity — pick a door, satisfy identity, follow the per-agent recipe.
- [Identity](https://developers.autoplay.ai/activity/identity.md): The one rule that makes live activity work for any AI agent and any activity source: the user_id the agent sends must equal the id activity was stored under.
- [REST API (optional)](https://developers.autoplay.ai/activity/overview.md): The optional REST fallback for pulling a user's recent in-app activity — for agents that can't speak MCP. Same data as the MCP tool.
- [RagPipeline](https://developers.autoplay.ai/sdk/rag-pipeline.md): Plug-and-play boilerplate that wires real-time events to any embedding model and any vector store.
- [Support AI agent context assembly](https://developers.autoplay.ai/sdk/support-agent-context-assembly.md): Combine user queries, real-time product events, conversation history, and an optional knowledge base into one LLM-ready context with assemble_rag_chat_context (autoplay_sdk.rag_query).
- [Agent session states](https://developers.autoplay.ai/sdk/agent-states.md): SessionState v2 FSM for reactive chat, proactive offers, cooldown gating, and session-owned conversation routing state.
- [User adoption state](https://developers.autoplay.ai/sdk/user-adoption-state.md): Per-user adoption model (journey + mastery + onboarding) with an explore-first gate, onboarding plans, and a reusable query to tour matcher.
- [State storage & session capture](https://developers.autoplay.ai/sdk/storage.md): Persist UserAdoptionState across sessions and freeze per-session snapshots behind a pluggable storage adapter, with built-in Redis / in-memory adapters, write-only analytics sinks, and session lifecycle helpers.
- [Proactive triggers](https://developers.autoplay.ai/sdk/proactive-triggers.md): Detect the right moment to surface proactive assistance — without coupling to any chat vendor or UI layer.
- [Authoring proactive triggers](https://developers.autoplay.ai/sdk/proactive-triggers-authoring.md): Build your first proactive trigger from scratch — context, predicates, registry, timings, and delivery.
- [Built-in proactive triggers](https://developers.autoplay.ai/sdk/proactive-triggers-builtins.md): Complete reference for every trigger shipped in the SDK catalog — when it fires, what it detects, how to tune it, and how to enable it from JSON config.
- [SessionSummarizer](https://developers.autoplay.ai/sdk/summarizer.md): Client-side context-window management — accumulate actions per session and summarise them with your own LLM when a threshold is reached.
- [AgentContextWriter](https://developers.autoplay.ai/sdk/agent-context.md): Push real-time event context to any agent destination and keep the context window bounded with LLM-compressed summaries.
- [BaseChatbotWriter](https://developers.autoplay.ai/sdk/support-agent-writer.md): Base class for delivering session events to any support AI agent platform — handles pre-link buffering, at-link flush, and post-link debouncing so you only implement the API call.
- [UserSessionIndex](https://developers.autoplay.ai/sdk/user-session-index.md): User-keyed session stitching for mapping one user to recent product sessions and reading cross-session activity safely.
- [compose_chat_pipeline(...)](https://developers.autoplay.ai/sdk/compose-chat-pipeline.md): Compose chat ingestion primitives in the safe default order so action writes, summarization, and callback fan-out stay consistent.
- [build_copilot_app(...)](https://developers.autoplay.ai/sdk/build-support-agent-app.md): FastAPI factory for a minimal user-keyed support AI agent bridge with health, context, reply, and admin reset endpoints.
- [RAG pipeline](https://developers.autoplay.ai/sdk/rag-example.md): Embed real-time session events into a vector store for retrieval-augmented generation.
- [Intercom](https://developers.autoplay.ai/integrations/intercom.md): Intercom-specific SDK helpers in autoplay_sdk.integrations.intercom and how they map to the event connector.
- [Zendesk](https://developers.autoplay.ai/integrations/zendesk.md): Zendesk-specific SDK helpers in autoplay_sdk.integrations.zendesk and how they map to the event connector.
- [Dify](https://developers.autoplay.ai/integrations/diffy.md): Dedicated Diffy integration helpers are coming soon. Stream events to your connector and support AI agent today.
- [Botpress](https://developers.autoplay.ai/integrations/botpress.md): Dedicated Botpress integration helpers are coming soon. Stream events to your connector and support AI agent today.
- [HubSpot Chat](https://developers.autoplay.ai/integrations/hubspot-chat.md): Dedicated HubSpot Chat integration helpers are coming soon. Stream events to your connector and support AI agent today.
- [Help Scout](https://developers.autoplay.ai/integrations/help-scout.md): Dedicated Help Scout integration helpers are coming soon. Stream events to your connector and support AI agent today.
- [Knowledge base](https://developers.autoplay.ai/sdk/knowledge-base.md): Query your product's golden paths from Autoplay's vector database to give your support AI agent structured adoption context.
- [User Memory](https://developers.autoplay.ai/sdk/user-memory.md): Historical per-user context so your onboarding agent skips mastered flows and focuses on real gaps.
- [Changelog](https://developers.autoplay.ai/changelog.md): Version history and release notes for the autoplay-sdk Python package.
- [Migration 0.7.4](https://developers.autoplay.ai/sdk/migration-0.7.4.md): Update deprecated autoplay_sdk import paths before 1.0.0.
- [Logging](https://developers.autoplay.ai/sdk/logging.md): Structured logging conventions when building on autoplay-sdk — module loggers, exception tracebacks, and safe extra fields.
- [Payload schema](https://developers.autoplay.ai/sdk/payload-schema.md): Full JSON wire format for actions and summary events from the SSE stream.

## OpenAPI Specs

- [openapi](https://developers.autoplay.ai/api-reference/openapi.json)