Troubleshooting

Common Issues

Issue: "Feature disabled" error

Cause: Feature flag is not enabled

Solution:

BACKEND_FEATURE_ESSENTIALS_DEEP_RESEARCH_ENABLED=true
BACKEND_FEATURE_COMPREHENSIVE_DEEP_RESEARCH_ENABLED=true

Issue: Comprehensive profile falls back to Essentials

Cause: Parallel AI quota exceeded (HTTP 402/429)

Solution:

• Check Parallel AI quota usage

• Increase quota or use Essentials for routine queries

• Monitor cdr_to_edr events in logs

Issue: Internal profile fails with "invalid_grant"

Cause: Google refresh token expired or revoked

Solution:

• User must re-authenticate via Google OAuth

• Generate new refresh token

• Update OPENAI_DEEP_RESEARCH_GOOGLE_REFRESH_TOKEN environment variable