Frequently Asked Questions

Common questions and answers about using PromptCompose

Frequently Asked Questions

Find answers to the most commonly asked questions about PromptCompose.

Getting Started

What is PromptCompose?

PromptCompose is a comprehensive platform for managing AI prompts, templates, and A/B testing. It provides both a web application for prompt management and an SDK for seamless integration into your applications.

Do I need technical knowledge to use PromptCompose?

No! PromptCompose is designed for both technical and non-technical users:

  • Platform users can manage prompts through our intuitive web interface
  • Developers can integrate using our SDK and APIs
  • Teams can collaborate regardless of technical background

How do I get started?

  1. Sign up for a PromptCompose account
  2. Create your first project through the web interface
  3. Build and test prompts in the platform
  4. Integrate with your application using our SDK (optional)

Is there a free plan?

Yes! We offer a free plan that includes:

  • Up to 1,000 API calls per month
  • 5 prompts and templates
  • Basic A/B testing
  • Community support

Account and Billing

How do I upgrade my plan?

  1. Go to Settings → Billing
  2. Click Upgrade Plan
  3. Choose your desired plan
  4. Complete payment setup

Your upgrade takes effect immediately.

Can I change plans at any time?

Yes, you can upgrade or downgrade at any time. Changes are prorated and reflected in your next billing cycle.

What payment methods do you accept?

We accept:

  • Major credit cards (Visa, MasterCard, American Express)
  • PayPal
  • Bank transfers (Enterprise plans only)

How does billing work?

  • Monthly plans: Billed monthly in advance
  • Annual plans: Billed annually with 20% discount
  • Usage overages: Billed at the end of each month
  • Prorated changes: Plan changes are prorated

Platform Features

What’s the difference between prompts and templates?

Prompts are specific, versioned AI instructions that you deploy and use:

  • Have versions and deployment history
  • Can be A/B tested
  • Are accessed via API

Templates are reusable structures for creating prompts:

  • Contain common patterns and variables
  • Can be shared across teams
  • Speed up prompt creation

How does versioning work?

Every time you deploy a prompt, a new version is created:

  • Version history is maintained automatically
  • Rollback to any previous version instantly
  • Compare versions to see changes
  • API integration can specify exact versions

Can I collaborate with my team?

Yes! PromptCompose supports team collaboration:

  • Invite team members with different permission levels
  • Share prompts and templates across the team
  • Comment on prompts for discussion
  • Track changes with activity logs

How do variable groups work?

Variable groups are collections of reusable variables:

  • Define once, use everywhere - avoid repetition
  • Type validation ensures data quality
  • Default values reduce configuration
  • Team sharing maintains consistency

A/B Testing

How does A/B testing work?

A/B testing lets you compare different prompt versions:

  1. Create variants of your prompt
  2. Configure traffic distribution (weighted, sequential, or manual)
  3. Users automatically see different variants
  4. Track conversions to measure success
  5. Statistical analysis shows winning variants

What rollout strategies are available?

  • Weighted: Random distribution based on percentages (e.g., 50/50 split)
  • Sequential: Rotate through variants in order
  • Manual: Explicitly control which users see which variants

How long should I run A/B tests?

Run tests until you achieve statistical significance, typically:

  • Minimum 1 week to account for weekly patterns
  • At least 100 conversions per variant for reliability
  • 95% confidence level for statistical significance

The platform will alert you when significance is reached.

Can I run multiple A/B tests simultaneously?

Yes, but be careful about:

  • Overlapping prompts that might interfere with each other
  • Statistical power - more tests need more traffic
  • User experience - too many tests can be confusing

SDK Integration

Which programming languages do you support?

Currently, we officially support:

  • JavaScript/TypeScript (Node.js and browsers)
  • Python support coming soon
  • Other languages can use our REST API directly

How do I integrate the SDK?

  1. Install the SDK: npm install @promptcompose/sdk
  2. Get API credentials from the platform
  3. Initialize the SDK in your code
  4. Start resolving prompts in your application

See our SDK Getting Started Guide for details.

Can I use PromptCompose without the SDK?

Yes! You can use our REST API directly:

  • HTTP endpoints for all functionality
  • OpenAPI specification available
  • Webhooks for real-time notifications
  • Any programming language that supports HTTP

How do I handle API failures?

Implement proper error handling:

  • Fallback content for when APIs fail
  • Retry logic with exponential backoff
  • Circuit breakers for resilience
  • Monitoring to detect issues quickly

Performance and Limits

What are the API rate limits?

Rate limits vary by plan:

  • Free: 100 requests/hour
  • Pro: 1,000 requests/hour
  • Enterprise: 10,000+ requests/hour (custom)

How fast is the API?

Typical response times:

  • 95th percentile: Under 200ms
  • 99th percentile: Under 500ms
  • Global CDN for reduced latency worldwide

Should I cache responses?

Yes, caching improves performance:

  • Cache for 5-15 minutes depending on content
  • Invalidate on deployments for fresh content
  • User-specific caching for A/B test consistency
  • Respect cache headers from our API

Can I use PromptCompose for high-traffic applications?

Absolutely! We support:

  • Millions of requests per day
  • Auto-scaling infrastructure
  • 99.9% uptime SLA (Enterprise plans)
  • Global edge locations for performance

Data and Security

Where is my data stored?

  • Primary data centers: US (with EU options available)
  • Encrypted in transit and at rest
  • Regular backups with disaster recovery
  • GDPR compliant data handling

How secure is PromptCompose?

Security measures include:

  • SOC 2 Type II compliance
  • End-to-end encryption
  • Role-based access control
  • Regular security audits
  • 24/7 monitoring

Can I export my data?

Yes! You can export:

  • All prompts and templates in JSON format
  • Analytics and test results in CSV
  • Team and project data for backup
  • API for automated backups

Do you offer on-premise deployment?

Enterprise customers can access:

  • Private cloud deployments
  • On-premise installations
  • Hybrid configurations
  • Custom security requirements

Troubleshooting

My prompts aren’t resolving correctly

Check these common issues:

  1. Variable names match exactly (case-sensitive)
  2. Required variables are provided
  3. API credentials are correct and active
  4. Prompt is deployed and not archived

A/B tests aren’t showing variants

Verify:

  1. Test is active and within date range
  2. Variants are properly configured
  3. Session IDs are consistent for users
  4. Traffic allocation adds up to 100%

API calls are failing

Common causes:

  1. Rate limits exceeded - implement backoff
  2. Invalid API key or expired credentials
  3. Network connectivity issues
  4. Malformed requests - check parameter format

Variables aren’t being replaced

Ensure:

  1. Correct syntax: Use {{variable_name}}
  2. Exact spelling matches variable definitions
  3. Variable types match expected format
  4. Required variables are provided

Best Practices

How should I organize my prompts?

  • Use descriptive names that explain the purpose
  • Add relevant tags for easy searching
  • Group by feature or user journey
  • Document prompt purposes and usage

What’s the best way to manage variables?

  • Use variable groups for consistency
  • Provide default values when possible
  • Validate input types to prevent errors
  • Document variable purposes clearly

How do I ensure good A/B testing?

  • Test one thing at a time for clear results
  • Run tests long enough for significance
  • Have clear hypotheses about what you’re testing
  • Document learnings for future reference

Should I version my prompts aggressively?

Balance between updates and stability:

  • Version for meaningful changes only
  • Test changes before deploying to production
  • Use staging environments for validation
  • Communicate changes to your team

Pricing and Plans

How is pricing calculated?

Pricing is based on:

  • API calls per month - each prompt resolution counts
  • Number of prompts you can create and store
  • Team members included in your plan
  • Advanced features like priority support

What counts as an API call?

  • Each prompt resolution via SDK or API
  • A/B test variant serving
  • Conversion event reporting

Administrative actions (creating prompts, viewing analytics) don’t count.

Can I get a discount?

Discounts available for:

  • Annual billing - 20% off monthly rates
  • Nonprofits - contact us for special pricing
  • Startups - early-stage company discounts
  • Students - educational pricing available

What happens if I exceed my limits?

  • API calls: Overage charges apply, or calls may be throttled
  • Prompts: You’ll need to upgrade or archive old prompts
  • Team members: Additional seats will be charged
  • No data loss - everything remains accessible

Support and Community

How do I get help?

Multiple support channels:

  • Documentation - comprehensive guides and references
  • Community forum - peer support and discussions
  • Email support - direct help from our team
  • Enterprise support - dedicated success managers

What’s included in support?

Support varies by plan:

  • Free: Community forum and documentation
  • Pro: Email support with 24-hour response
  • Enterprise: Priority support with 4-hour response

Do you offer training or onboarding?

Yes! We provide:

  • Documentation and guides for self-service
  • Webinars for group learning
  • Custom training for Enterprise customers
  • Migration assistance from other platforms

How do I request new features?

We love feedback! You can:

  • Submit requests through our feedback portal
  • Join community discussions about upcoming features
  • Contact support with specific needs
  • Enterprise customers get priority consideration

Is there a community?

Join our growing community:

  • Discord server for real-time chat
  • Community forum for discussions
  • GitHub for SDK contributions
  • Regular webinars and events

Migration and Integration

Can I migrate from another platform?

Yes! We support migration from:

  • Custom prompt management systems
  • Other prompt management platforms
  • Spreadsheets and documents
  • Version control systems

Contact support for migration assistance.

How do I integrate with my existing tools?

PromptCompose integrates with:

  • Analytics platforms (Google Analytics, Mixpanel)
  • Communication tools (Slack, Microsoft Teams)
  • Development tools (GitHub, CI/CD pipelines)
  • Custom integrations via webhooks and API

Can I use PromptCompose with multiple applications?

Absolutely! Common patterns:

  • Multiple API keys for different applications
  • Shared prompts across applications
  • Environment separation (dev/staging/prod)
  • Cross-application A/B testing

What about compliance requirements?

We support various compliance needs:

  • GDPR compliance for EU users
  • HIPAA compliance (Enterprise plans)
  • SOC 2 certification
  • Custom compliance requirements available

Still have questions?

If you can’t find what you’re looking for:

  • Check our documentation for detailed guides
  • Search our community forum for similar questions
  • Contact support for personalized help
  • Schedule a demo to see PromptCompose in action

We’re here to help you succeed with PromptCompose!