​

Troubleshooting Guide

​

Authentication Errors

​

Problem: “Invalid API Key”

AuthenticationError: Invalid API key

1. Check API key is correct:
   Copy

   Ask AI

   echo $QWED_API_KEY
   
2. Verify key is active:
   • Log into dashboard
   • Check API keys page
   • Regenerate if needed
3. Check for whitespace:
   Copy

   Ask AI

   api_key = os.getenv("QWED_API_KEY").strip()
   

​

Verification Failures

​

Problem: Unexpected Verification Failures

result.verified == False  # But should be True

1. Enable verbose mode:
   Copy

   Ask AI

   client = QWEDClient(api_key="...", verbose=True)
   result = client.verify("2+2=4")
   
2. Check trace:
   Copy

   Ask AI

   result = client.verify("2+2=4", return_trace=True)
   print(json.dumps(result.trace, indent=2))
   
3. Verify input format:
   Copy

   Ask AI

   # Ensure input is well-formed
   query = "Calculate 2+2"  # Natural language
   # Not: "2 + 2"  # Might fail
   

​

Performance Issues

​

Problem: Slow Response Times

1. Use batch processing:
   Copy

   Ask AI

   # ❌ Slow
   for q in queries:
       result = client.verify(q)
   
   # ✅ Fast
   results = client.verify_batch([
       BatchItem(query=q) for q in queries
   ])
   
2. Increase timeout:
   Copy

   Ask AI

   client = QWEDClient(api_key="...", timeout=60)
   
3. Check network latency:
   Copy

   Ask AI

   ping api.qwedai.com
   

​

Quota Issues

​

Problem: “Quota Exceeded”

QuotaExceededError: API quota exceeded

1. Check quota status:
   Copy

   Ask AI

   status = client.get_quota_status()
   print(f"Used: {status.used}, Remaining: {status.remaining}")
   
2. Upgrade plan:
   • Visit https://qwedai.com/pricing
   • Contact sales for enterprise
3. Implement rate limiting:
   Copy

   Ask AI

   from time import sleep
   
   for query in queries:
       result = client.verify(query)
       sleep(0.1)  # 10 req/sec max
   

​

Integration Issues

​

Problem: Pages Still Showing 404

1. Use correct URL format:
   Copy

   Ask AI

   ❌ docs.qwedai.com/integration/getting-started
   ✅ docs.qwedai.com/docs/integration/getting-started
   
2. Hard refresh:
   • Windows: Ctrl + Shift + R
   • Mac: Cmd + Shift + R
3. Check deployment:
   • Visit https://github.com/QWED-AI/qwed-enterprise/actions
   • Verify latest deployment succeeded

​

Error Code Reference

​

Getting Help

​

Self-Service:

1. Check logs:
   Copy

   Ask AI

   import logging
   logging.basicConfig(level=logging.DEBUG)
   
2. Run test suite:
   Copy

   Ask AI

   python test_qwed_integration.py
   
3. Search documentation:
   • https://docs.qwedai.com

​

Community Support:

• 💬 GitHub Discussions
• 🐛 Report Bug

​

Enterprise Support:

• 📧 Email: support@qwedai.com
• 💼 Slack Connect (Enterprise customers)
• 📞 Emergency Hotline (Enterprise Pro+)

​

Debug Checklist

• Check error message carefully
• Enable verbose/debug mode
• Review logs
• Test with simple query
• Check network connectivity
• Verify API key
• Check quota status
• Review recent code changes
• Test in isolation
• Search documentation

• Error message
• Code snippet
• Steps to reproduce
• QWED SDK version