Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form below and we will reply as soon as possible.

  • Integration Hub
  • Contact Us
  • Docs home
  • Getting Started

Best Practices for Using Captain AI

Ask questions, troubleshoot experiences, and pull analytics from one chat interface

Updated at June 5th, 2026

Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form with the details about the help content you'd like to see.

  • Home

  • Getting Started

    • Installation & Developers

      • Web Experiences

        • Mobile Experiences

          • Workflows

            • Analytics & Data

              • Account Management

                • Integrations

                  Table of Contents

                  Start a conversation Set up account context Write better prompts Rate responses and manage memory Prompt ideas Engagement strategy Troubleshooting Targeting and segmentation Analytics What Captain AI can do Coaching and guidance Review experiences and account data Targeting and segmentation Analytics and reporting User profiles Experience delivery troubleshooting Experience management Build experiences

                  Captain AI is your in-app co-pilot for coaching, analytics, troubleshooting, and experience management. Ask it questions in plain language and get answers grounded in your Appcues account data.

                  Start a conversation

                  Click Captain AI in the left sidebar. Type a question in the chat window and press Enter.

                  To pick up where you left off, open a previous session from the conversation list.

                  Reference a specific experience by typing @ in the chat — Captain AI autocompletes the experience name so you can ask about it directly.

                  Set up account context

                  Give Captain AI background about your product so it generates more relevant answers.

                  1. Go to Settings > AI Assistant.
                  2. Add business context: product type, audience, goals, or industry details.
                  3. Add preferences: language (e.g., "respond in French") or tone of voice.

                  Captain AI applies this context to every conversation across your team.

                  Write better prompts

                  Specific prompts get better answers. Compare these two approaches:

                  • Vague: "How do I improve engagement?"
                  • Specific: "How do I improve checklist completion for trial users in their first week?"

                  Include the experience type, user segment, timeframe, or metric you care about.

                  Rate responses and manage memory

                  Click 👍 or 👎 after any answer to help improve Captain AI's quality over time.

                  Captain AI retains some memories from your conversations to provide faster, more relevant answers in future sessions. To manage this, type:

                  • "Show me your memory" to see what Captain AI remembers.
                  • "Clear your memory" to reset stored context.

                  Memories are saved on Appcues infrastructure alongside your conversation history — they are not stored in or used to train any AI model.


                  Prompt ideas

                  Use these as starting points for your own questions.

                  Engagement strategy

                  • "What's the best way to onboard new users who signed up but haven't completed setup?"
                  • "How should I announce a new feature to power users without interrupting their workflow?"
                  • "What Appcues patterns work best for reducing churn during a free trial?"
                  • "Should I use a Modal, Slideout, or Tooltip to promote our new integration?"
                  • "How can I re-engage users who haven't logged in for 30 days?"
                  • "What's the right timing and frequency for in-app messages during onboarding?"

                  Troubleshooting

                  • "Before I publish, can you verify my targeting rules will reach the right users?"
                  • "Describe the changes between the draft and published version of this Flow."
                  • "Why is my Tooltip pointing to the wrong element on the page?"
                  • "Users are seeing the same announcement multiple times — how do I fix this?"
                  • "My NPS survey isn't appearing even though I published it. What should I check?"
                  • "The Flow works in preview but not in production — what could be different?"

                  Targeting and segmentation

                  • "I want to target users who completed onboarding but haven't used feature X yet."
                  • "How do I create a segment for trial users in their last 3 days?"
                  • "Build targeting rules for enterprise customers who haven't seen our new dashboard."
                  • "Do I have any experiences using this specific CSS selector? I'm changing my app's code and want to avoid breaking published experiences."
                  • "Which of my published experiences are triggered by a particular event?"

                  Analytics

                  • "Which Flow tagged 'Onboarding' has the best completion rate this month?"
                  • "Show me a funnel analysis: users who started this Flow and then completed event X in the last 30 days."
                  • "Give me a CSV of users that dropped off after my Flow's second step."
                  • "Compare the performance of my two feature announcement variants."
                  • "What percentage of users who saw the upgrade prompt actually converted?"
                  • "Show me NPS score trends over the last quarter."

                  What Captain AI can do

                  Coaching and guidance

                  • Get best-practice advice on adoption, activation, onboarding, and engagement.
                  • Ask for feedback on experiences you've built.
                  • Get help with any Appcues feature.

                  Review experiences and account data

                  • Find and list experiences by name, type, creator, or status. Use @ to mention a specific experience.
                  • View experience details including steps, content, and configuration.
                  • Look up a segment's targeting conditions, a Goal's completion criteria, or tracked events and properties.
                  • View sample property values to understand data formats.

                  Targeting and segmentation

                  Describe who you want to target, and Captain AI identifies the right conditions, calculates how many users currently match, and drafts a segment for you to review and activate.

                  For any experience you mention with @, Captain AI can configure:

                  • Audience — conditions using user/account properties and events.
                  • Page targeting (web) — URL patterns and domain restrictions.
                  • Screen targeting (mobile) — screen name patterns.
                  • Version targeting (mobile) — app version requirements.
                  • Trigger events — custom events that launch the experience.
                  • Frequency — show once or every time conditions are met.

                  Analytics and reporting

                  Data sharing notice: Analytics queries send some end-user data to OpenAI, which may include User IDs or PII depending on the question. Your data is not used to train any AI model. Captain AI analytics queries are unavailable for HIPAA customers.

                  To opt out, have your Appcues admin disable this in Settings > AI Assistant, or email support@appcues.com. For details, see the Appcues Trust Center FAQ on AI.

                  Account-level reporting:

                  • Monthly active users (MAU) and experiences seen.
                  • Flow performance summaries.
                  • Funnel metrics across events, experience steps, and more.

                  Experience-level metrics:

                  • Total users who saw, completed, skipped, or dismissed an experience within a timeframe.
                  • Daily breakdowns over a date range.

                  Some experience types include additional metrics:

                  • Launchpads — opens, impressions, activity breakdown.
                  • NPS Surveys — score, promoter/neutral/detractor counts, individual responses with feedback, and sentiment analysis.
                  • Checklists — per-item started/completed counts.
                  • Goals — completion counts (total or daily) and lists of users who reached a Goal within a timeframe.
                  • Events — trigger counts, unique users per event, and lists of users who triggered a specific event.
                  • Page and screen views — most viewed pages/screens, view counts, unique visitors, and individual view details with timestamps.
                  • Group/account analytics — group engagement metrics (DAU, stickiness) and group property listings.

                  Output options

                  Captain AI can return results as formatted text, graphs, or CSV for export.

                  User profiles

                  • Look up profiles by User ID or other identifier properties.
                  • View specific properties or all available data for a user.
                  • See user activity history including events and page views.

                  Experience delivery troubleshooting

                  Captain AI can diagnose common delivery issues:

                  • Installation status — check whether the web or mobile SDK is installed and view configured domains.
                  • Experience errors — view recent errors with messages, URLs, and timestamps to identify targeting or content issues.

                  Experience management

                  • Publish and unpublish experiences directly from Captain AI, including bulk publish based on rules you specify.
                  • Compare draft vs. published content to review what changed before publishing.

                  Build experiences

                  Captain AI can directly build mobile Flows — describe the purpose, content, and imagery, and a Flow is generated automatically. Edit it afterward in the builder.

                  For non-mobile experiences, Captain AI provides step-by-step guidance for you to build them in Appcues.

                  ai captain ai ai assistant ai coach

                  Was this article helpful?

                  Yes
                  No
                  Give feedback about this article

                  Related Articles

                  • Create a Flow
                  • Best Practices for Building Flows with Appcues
                  • Set up Goals
                  Appcues logo

                  Product

                  Why Appcues How it works Integrations Security Pricing What's new

                  Use cases

                  Appcues Integration Hub User Onboarding Software Feature Adoption Software NPS & Surveys Announcements Insights Mobile Adoption

                  Company

                  About
                  Careers

                  Support

                  Developer Docs Contact

                  Resources

                  The Appcues Blog Product Adoption Academy GoodUX Case studies Webinar Series Made with Appcues

                  Follow us

                  Facebook icon Twitter icon grey Linkedin icon Instagram icon
                  © 2022 Appcues. All rights reserved.
                  Security Terms of Service Privacy Policy

                  Knowledge Base Software powered by Helpjuice

                  Expand