Configure AI Assistant Settings
This guide will help you set up the AI Assistant features in AeroKites Edu. The app includes powerful AI capabilities powered by OpenAI's GPT models for enhanced user experience.
🤖 AI Features Overview
AeroKites Edu includes the following AI-powered features:
- AI Lesson Plan Generation - Create comprehensive lesson plans with objectives, activities, and assessments
- AI Email Assistant - Generate professional emails for parents, staff, and stakeholders
- AI Homework Creation - Create engaging homework assignments with varying difficulty levels
- AI Usage Analytics - Monitor and track AI feature usage with detailed reports
Step 1: OpenAI Account Registration
To use the AI features, you need an OpenAI account and API access.
A. Visit OpenAI Platform
- Go to https://platform.openai.com
- Click "Sign up" in the top right corner
- You can sign up using:
- Email address
- Google account
- Microsoft account
B. Complete Registration
- Enter your email address and create a password
- Verify your email address (check your inbox for verification email)
- Complete the account setup process
- Add a payment method (required for API usage)
⚠️ Important Notes:
- Payment Required: OpenAI requires a valid payment method for API access
- Free Credits: New accounts receive free credits to start with
- Usage-Based Pricing: You only pay for what you use
- Security: Keep your account credentials secure
Step 2: Generate API Key
Once your account is set up, you need to generate an API key for the app to communicate with OpenAI.
A. Access API Keys Section
- Log in to your OpenAI account
- Navigate to API Keys in the left sidebar
- Click "Create new secret key"
B. Create API Key
- Enter a name for your API key (e.g., "AeroKites Edu AI")
- Select the appropriate permissions (read/write access)
- Click "Create secret key"
- IMPORTANT: Copy the API key immediately - you won't be able to see it again!
🔒 Security Warning:
- Never share your API key publicly or commit it to version control
- Store it securely - treat it like a password
- Rotate keys regularly for better security
- Monitor usage to prevent unauthorized access
Step 3: Get Organization ID
You'll also need your Organization ID for proper API configuration.
A. Find Organization ID
- In your OpenAI dashboard, go to Settings → Organization
- Copy your Organization ID (it starts with "org-")
- Keep this ID handy for the next step
Step 4: Configure AI Settings in the App
Now you need to configure the AI settings within the AeroKites Edu application.
A. Access AI Settings
- Open the AeroKites Edu app
- Log in with your admin account
- Navigate to Settings → AI Settings
B. Enter API Credentials
- API Key: Paste your OpenAI API key
- Organization ID: Enter your OpenAI Organization ID
- Model Selection: Choose your preferred GPT model:
- GPT-4: Most advanced, higher cost
- GPT-3.5-turbo: Good balance of performance and cost
C. Configure AI Features
- Enable/Disable Features: Toggle individual AI features on/off
- Usage Limits: Set daily/monthly usage limits to control costs
- Content Filters: Configure content safety settings
- Language Settings: Set preferred language for AI responses
D. Test AI Configuration
- Click "Test Connection" to verify API connectivity
- Try generating a sample lesson plan or email
- Check that responses are received correctly
- Verify usage is being tracked in the analytics
✅ Configuration Complete!
Once you've completed these steps, all AI features will be available throughout the app.
Step 5: AI Usage Monitoring & Management
Monitor and manage your AI usage to optimize costs and performance.
A. OpenAI Usage Dashboard
- Visit OpenAI Usage Dashboard
- Monitor your API usage and costs
- Set up usage alerts and limits
- View detailed usage analytics
B. App AI Analytics
- Access Settings → AI Analytics in the app
- View feature-wise usage statistics
- Monitor cost trends and patterns
- Export usage reports for analysis
C. Cost Optimization Tips
- Use appropriate models: GPT-3.5-turbo for most tasks, GPT-4 for complex reasoning
- Set usage limits: Prevent unexpected high costs
- Monitor regularly: Check usage at least weekly
- Optimize prompts: Clear, specific prompts use fewer tokens
Step 7: Troubleshooting Common Issues
Resolve common AI configuration and usage issues.
A. API Connection Issues
- Check API Key: Verify the API key is correct and active
- Network Connectivity: Ensure stable internet connection
- Rate Limits: Check if you've exceeded API rate limits
- Account Status: Verify your OpenAI account is active and has credits
B. Response Quality Issues
- Improve Prompts: Make prompts more specific and detailed
- Model Selection: Try different GPT models for better results
- Context Length: Ensure prompts fit within token limits
- Content Filters: Adjust content safety settings if needed
C. Cost Management
- Set Budget Alerts: Configure spending limits and notifications
- Monitor Usage: Regularly check usage patterns
- Optimize Prompts: Reduce token usage with concise prompts
- Feature Limits: Disable unused AI features to save costs
📞 Support Resources:
- OpenAI Documentation: https://platform.openai.com/docs
- OpenAI Community: https://community.openai.com
- AeroKites Support: Contact our support team for app-specific issues