644e72d289
Issue #518 - Subscription not updating after checkout: - Fix stale closure in SubscriptionContext checkout polling (use subscriptionRef) - Move checkout success polling from InitialRouteHandler into SubscriptionContext - Remove redundant polling code from InitialRouteHandler - Fix plan label: 'Free' instead of 'No Plan', proper capitalization - Add plan refresh button in UserBadge - Add 'View Costing Details' to UserBadge dropdown - Rename 'ALwrity Podcast Maker' to 'Podcast Creator' across UI - Clean subscription=success URL param after verification Blog Writer WYSIWYG Editor enhancements: - Per-section preview toggle (view/edit icons) - Enhanced hover-based toolbar - Circular SVG progress stats bar with detailed tooltip - Research tool chips in stats bar footer - Per-section TTS with useTextToSpeech hook (browser native) - Full blog preview modal with print/PDF support - PlayAllTTSButton: sequential playback with progress bar - OnThisPageNav: floating sidebar with scroll tracking - Section data attributes for scroll anchoring GSC Brainstorm Topics feature: - Backend: gsc_brainstorm_service.py (rule-based + LLM recommendations) - Backend: POST /gsc/brainstorm endpoint with 3-word minimum validation - Frontend: gscBrainstorm.ts API client - Frontend: useGSCBrainstormConnection hook (popup OAuth, no /onboarding redirect) - Frontend: useGSCBrainstorm hook (connect check + brainstorm call) - Frontend: GSCBrainstormModal (3-tab results: Opportunities, Gaps, AI Recs) - Frontend: BrainstormButton (visible at 3+ words, GSC connect overlay) - Wire BrainstormButton into ManualResearchForm and ResearchAction - Add blog_writer to gsc_auth router features for ALWRITY_ENABLED_FEATURES
286 lines
7.6 KiB
Markdown
286 lines
7.6 KiB
Markdown
# AI Copilot Assistant Guide
|
|
|
|
## 🤖 Overview
|
|
|
|
The ALwrity AI Copilot is a conversational AI assistant powered by CopilotKit and Google Gemini LLM. It provides intelligent, context-aware SEO recommendations using natural language interaction.
|
|
|
|
## Key Features
|
|
|
|
### Conversational Interface
|
|
- **Natural Language**: Ask questions in plain English
|
|
- **Context Aware**: Understands your SEO data and goals
|
|
- **Multi-Turn**: Continuous conversation for detailed guidance
|
|
- **Smart Suggestions**: Recommendations based on your analysis
|
|
|
|
### Capabilities
|
|
|
|
#### Analysis Interpretation
|
|
Ask the Copilot to explain your analysis results:
|
|
- "What does my health score of 75 mean?"
|
|
- "Why is my mobile speed score low?"
|
|
- "Which critical issues should I focus on first?"
|
|
|
|
#### Actionable Recommendations
|
|
Get specific guidance:
|
|
- "How can I improve my Core Web Vitals?"
|
|
- "What's the best strategy to increase rankings?"
|
|
- "Should I focus on content or technical SEO?"
|
|
|
|
#### Tool Guidance
|
|
Get help using the right tools:
|
|
- "Which tool should I use for my product pages?"
|
|
- "How do I set up competitor analysis?"
|
|
- "What's the best way to optimize my images?"
|
|
|
|
#### Strategic Planning
|
|
Get strategic insights:
|
|
- "What's my content strategy should be?"
|
|
- "How do I compare to my competitors?"
|
|
- "What content opportunities am I missing?"
|
|
|
|
---
|
|
|
|
## How to Use the AI Copilot
|
|
|
|
### Starting a Conversation
|
|
|
|
1. **Open the Copilot Panel** - Click the AI Copilot icon in your dashboard
|
|
2. **Ask Your Question** - Type in natural language
|
|
3. **Provide Context** - Mention your URL or industry if relevant
|
|
4. **Wait for Response** - Copilot analyzes your data and responds
|
|
|
|
### Example Conversations
|
|
|
|
#### Example 1: Improving Performance
|
|
```
|
|
You: "My PageSpeed score is 65. How do I improve it?"
|
|
Copilot: "A score of 65 indicates moderate performance issues.
|
|
Here are the priority actions:
|
|
1. Optimize images (biggest impact)
|
|
2. Enable compression
|
|
3. Reduce JavaScript
|
|
I recommend using our PageSpeed Analyzer tool to get specific recommendations."
|
|
```
|
|
|
|
#### Example 2: Content Strategy
|
|
```
|
|
You: "I want to improve my content strategy. Where should I start?"
|
|
Copilot: "Based on your domain analysis, I recommend:
|
|
1. Run Content Strategy Analyzer to find gaps
|
|
2. Analyze competitors with Sitemap Analyzer
|
|
3. Focus on topics with high search volume and low competition
|
|
4. Create content clusters around your main topics
|
|
Your current gap is around long-tail keywords - that's an opportunity!"
|
|
```
|
|
|
|
#### Example 3: Technical Issues
|
|
```
|
|
You: "I have crawl errors. What should I do?"
|
|
Copilot: "Crawl errors need immediate attention. Use the Technical SEO Analyzer to:
|
|
1. Identify the specific errors
|
|
2. Prioritize by severity
|
|
3. Fix 4xx errors (broken pages)
|
|
4. Then address 5xx errors
|
|
Let me show you how to set it up."
|
|
```
|
|
|
|
---
|
|
|
|
## Copilot Quick Commands
|
|
|
|
### Analysis Help
|
|
- "Explain my health score"
|
|
- "What are my biggest SEO issues?"
|
|
- "How do I read this analysis?"
|
|
- "What's my score breakdown?"
|
|
|
|
### Tool Recommendations
|
|
- "Which tool should I use for X?"
|
|
- "How do I set up Y?"
|
|
- "What's the difference between X and Y?"
|
|
- "Is my analysis complete?"
|
|
|
|
### Strategic Guidance
|
|
- "What should I focus on?"
|
|
- "How do I beat my competitors?"
|
|
- "Should I prioritize content or technical SEO?"
|
|
- "What's my content strategy?"
|
|
|
|
### Performance Tracking
|
|
- "How have I improved?"
|
|
- "What's my trend?"
|
|
- "Am I on track to my goals?"
|
|
- "Where am I vs competitors?"
|
|
|
|
---
|
|
|
|
## Best Practices
|
|
|
|
### Ask Specific Questions
|
|
❌ "My SEO is bad"
|
|
✅ "My health score is 62. What are the most important improvements?"
|
|
|
|
### Provide Context
|
|
❌ "How do I improve?"
|
|
✅ "I'm an e-commerce site selling shoes. How should I improve my SEO?"
|
|
|
|
### Use in Combination
|
|
- Ask Copilot for guidance
|
|
- Run the recommended tool
|
|
- Return to Copilot with results for next steps
|
|
|
|
### Regular Check-ins
|
|
- Weekly: Ask about your progress
|
|
- Monthly: Ask for strategic planning
|
|
- Quarterly: Ask about competitive positioning
|
|
|
|
---
|
|
|
|
## Copilot Context
|
|
|
|
The Copilot has access to:
|
|
- ✅ Your SEO analysis data
|
|
- ✅ Your health score and metrics
|
|
- ✅ Your platform integrations (GSC, GA4, Bing)
|
|
- ✅ Your competitor analysis
|
|
- ✅ Your content strategy
|
|
- ✅ Your historical data and trends
|
|
|
|
### What Copilot Can Do
|
|
- Explain your SEO data
|
|
- Recommend tools and strategies
|
|
- Prioritize actions
|
|
- Guide you through processes
|
|
- Suggest competitive opportunities
|
|
- Help interpret results
|
|
|
|
### What Copilot Cannot Do
|
|
- Directly modify your website
|
|
- Access external websites (use analysis tools)
|
|
- Execute fixes automatically
|
|
- Guarantee specific ranking improvements
|
|
- Replace professional SEO consulting
|
|
|
|
---
|
|
|
|
## Advanced Use Cases
|
|
|
|
### For Content Creators
|
|
"I'm writing a blog post about digital marketing. How should I optimize it for SEO?"
|
|
|
|
Copilot will recommend:
|
|
- Target keywords to use
|
|
- Optimal content length
|
|
- Structure recommendations
|
|
- Meta tags to create
|
|
- Image optimization tips
|
|
|
|
### For Digital Marketers
|
|
"How should I structure my content strategy for the next quarter?"
|
|
|
|
Copilot will analyze:
|
|
- Current content gaps
|
|
- Competitor opportunities
|
|
- Keyword opportunities
|
|
- Content distribution
|
|
- Publishing calendar recommendations
|
|
|
|
### For SEO Professionals
|
|
"I need to improve rankings for high-value keywords. What's my strategy?"
|
|
|
|
Copilot will recommend:
|
|
- On-page optimization priorities
|
|
- Technical SEO improvements
|
|
- Link building opportunities
|
|
- Content expansion ideas
|
|
- Competitive positioning tactics
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### Copilot Seems Inaccurate
|
|
- Ensure you've run recent analysis
|
|
- Provide more specific context
|
|
- Try rephrasing your question
|
|
- Run a tool to get more data
|
|
|
|
### Not Getting Useful Recommendations
|
|
- Provide your URL or industry
|
|
- Mention your goals
|
|
- Ask follow-up questions
|
|
- Check the recommended tool for more details
|
|
|
|
### Copilot Isn't Responding
|
|
- Check your internet connection
|
|
- Try refreshing the dashboard
|
|
- Start a new conversation
|
|
- Clear your browser cache
|
|
|
|
---
|
|
|
|
## Tips for Best Results
|
|
|
|
1. **Be Specific**: Include URLs, metrics, or goals
|
|
2. **Ask Follow-ups**: "Tell me more about..." or "How do I...?"
|
|
3. **Provide Context**: Mention your industry or goals
|
|
4. **Use Tool Names**: "Use the PageSpeed Analyzer to..."
|
|
5. **Ask for Priorities**: "What should I focus on first?"
|
|
|
|
---
|
|
|
|
## Integration with Other Tools
|
|
|
|
The Copilot works seamlessly with:
|
|
- **Health Score**: "Explain my score"
|
|
- **Analysis Tools**: "Use the Technical SEO tool"
|
|
- **Competitive Analysis**: "How do I compare?"
|
|
- **Content Strategy**: "Plan my content"
|
|
- **Blog Writer**: "Optimize this page"
|
|
|
|
---
|
|
|
|
## Example Workflows
|
|
|
|
### Weekly SEO Review
|
|
```
|
|
1. Ask: "What's my latest health score?"
|
|
2. Ask: "Should I run any new analysis?"
|
|
3. Ask: "What are my top priorities this week?"
|
|
4. Use recommended tools
|
|
5. Ask: "How did I improve?"
|
|
```
|
|
|
|
### Content Planning
|
|
```
|
|
1. Ask: "What content opportunities do I have?"
|
|
2. Use Content Strategy Analyzer (recommended)
|
|
3. Ask: "Which topics should I prioritize?"
|
|
4. Ask: "What keywords should I target?"
|
|
5. Get recommendations for each piece of content
|
|
```
|
|
|
|
### Competitive Analysis
|
|
```
|
|
1. Ask: "How do I compare to competitors?"
|
|
2. Use Competitive Analysis tool
|
|
3. Ask: "What's my competitive advantage?"
|
|
4. Ask: "Where am I behind?"
|
|
5. Get actionable improvement strategies
|
|
```
|
|
|
|
---
|
|
|
|
## Getting Help
|
|
|
|
The AI Copilot is always ready to help with:
|
|
- **How-to questions** - "How do I...?"
|
|
- **Explanation requests** - "Explain my..."
|
|
- **Recommendations** - "What should I...?"
|
|
- **Prioritization** - "What's most important?"
|
|
- **Guidance** - "Guide me through..."
|
|
|
|
---
|
|
|
|
**Pro Tip**: The more specific you are with your questions and the more context you provide, the better and more actionable the Copilot's recommendations will be!
|