perplexity-prod-checklist

•

1.9k2663 months ago

Execute Perplexity production deployment checklist and rollback procedures. Use when deploying Perplexity integrations to production, preparing for launch, or implementing go-live procedures. Trigger with phrases like "perplexity production", "deploy perplexity", "perplexity go-live", "perplexity launch checklist".

Quick Install

npxskills add jeremylongshore/claude-code-plugins-plus-skills--skill perplexity-prod-checklist

Instructions

Perplexity Production Checklist

Overview

Complete checklist for deploying Perplexity Sonar API integrations to production. Perplexity-specific concerns: every API call performs a live web search (variable latency), citations link to third-party sites (must validate), and costs scale per-request plus per-token.

Prerequisites

Staging environment tested
Production API key generated (separate from dev/staging)
Monitoring configured
Cost budget defined

Production Readiness Checklist

API Configuration

Production PERPLEXITY_API_KEY in secret manager (not env file)
Key starts with pplx- and has credits loaded
Separate API keys for dev/staging/prod
Base URL is https://api.perplexity.ai (not localhost/proxy)
Model selection configured: sonar for fast, sonar-pro for deep

Loading…

Related Skills

skill-creator

Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.

367,360

skill-creator

Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.

367,309

1password

Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.

365,915

himalaya

CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).

365,885

Tags & Topics

aiautomationclaude-codedevopsmcpai-agents

async function searchWithFallback(query: string) {
  try {
    // Primary: sonar-pro for deep answers
    return await perplexity.chat.completions.create({
      model: "sonar-pro",
      messages: [{ role: "user", content: query }],
      max_tokens: 2048,
    });
  } catch (err: any) {
    if (err.status === 429 || err.status >= 500) {
      // Fallback: sonar for faster, cheaper response
      return await perplexity.chat.completions.create({
        model: "sonar",
        messages: [{ role: "user", content: query }],
        max_tokens: 512,
      });
    }
    throw err;
  }
}

app.get("/health/perplexity", async (req, res) => {
  const start = Date.now();
  try {
    const response = await perplexity.chat.completions.create({
      model: "sonar",
      messages: [{ role: "user", content: "ping" }],
      max_tokens: 5,
    });
    res.json({
      status: "healthy",
      latencyMs: Date.now() - start,
      model: response.model,
    });
  } catch (err: any) {
    res.status(503).json({
      status: "unhealthy",
      error: err.status || err.message,
      latencyMs: Date.now() - start,
    });
  }
});

Alert	Condition	Severity
API Unreachable	Health check fails 3x	P1
High Error Rate	429/5xx > 5% over 5min	P2
High Latency	p95 > 15s for sonar	P2
Budget Exceeded	Monthly cost > 80% cap	P2
Auth Failure	Any 401/402 error	P1

Issue	Cause	Solution
Variable latency	Web search per request	Set appropriate timeouts per model
Broken citations	Source pages changed	Validate citation URLs before displaying
Cost overrun	No model routing	Route simple queries to sonar
Rate limit spikes	Burst traffic	Queue requests with p-queue

perplexity-prod-checklist

Perplexity Production Checklist

Overview

Prerequisites

Production Readiness Checklist

API Configuration

Related Skills

skill-creator

skill-creator

1password

himalaya

Perplexity Production Checklist

Overview

Prerequisites

Production Readiness Checklist

API Configuration

Code Quality

Performance

Monitoring

Cost Controls

Graceful Degradation

Health Check Endpoint

Alerting Rules

Error Handling

Output

Resources

Next Steps

Related Skills

skill-creator

skill-creator

1password

himalaya

Related Skills

skill-creator

skill-creator

1password

himalaya