perplexity-advanced-troubleshooting

# Perplexity Advanced Troubleshooting ## Overview Deep debugging for Perplexity Sonar API issues that resist standard fixes. Common hard problems: inconsistent citations between identical queries, intermittent timeouts on sonar-pro, search results not matching recency filter, and response quality degradation. ## Prerequisites - Access to production logs and metrics - `curl` for direct API testing - Understanding of Perplexity's search-augmented generation model ## Diagnostic Tools ### Layer-by-Layer Test ```bash #!/bin/bash set -euo pipefail echo "=== Perplexity Layer Diagnostics ===" # Layer 1: DNS echo -n "1. DNS: " dig +short api.perplexity.ai || echo "FAIL" # Layer 2: TCP connectivity echo -n "2. TCP: " timeout 5 bash -c 'echo > /dev/tcp/api.perplexity.ai/443 && echo "OK"' 2>/dev/null || echo "FAIL" # Layer 3: TLS handshake echo -n "3. TLS: " echo | openssl s_client -connect api.perplexity.ai:443 2>/dev/null | grep -c "Verify return code: 0" | sed 's/1/OK/;s/0/FAIL/' # Layer 4: HTTP with auth echo -n "4. Auth: " curl -s -o /dev/null -w "%{http_code}" \ -H "Authorization: Bearer $PERPLEXITY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"sonar","messages":[{"role":"user","content":"test"}],"max_tokens":5}' \ https://api.perplexity.ai/chat/completions echo "" # Layer 5: Response quality echo "5. Quality check:" RESPONSE=$(curl -s \ -H "Authorization: Bearer $PERPLEXITY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"sona...