Etapas de Instalação do SDK Node.js da Perplexity

A Perplexity fornece um SDK Node.js para integrar seus recursos de busca e resposta com IA em suas aplicações. Sem a configuração adequada do SDK, você precisa escrever requisições HTTP brutas e lidar com a autenticação manualmente. Este artigo explica como instalar o SDK Node.js da Perplexity, configurá-lo com sua chave de API e executar uma consulta básica. Você concluirá toda a instalação em menos de cinco minutos.

O que o SDK Node.js da Perplexity Faz

O SDK Node.js da Perplexity é uma biblioteca cliente oficial que encapsula a API da Perplexity. Ele lida com autenticação, formatação de requisições e análise de respostas para que você possa se concentrar em criar funcionalidades. Antes de instalar, você precisa de um runtime Node.js versão 18 ou superior e uma chave de API da Perplexity obtida no painel do desenvolvedor. O SDK funciona tanto com projetos CommonJS quanto com ES Modules.

Passos para Instalar e Configurar o SDK Node.js da Perplexity

1. Crie ou abra seu projeto Node.js
   Navegue até a pasta do seu projeto no terminal. Se você não tiver um projeto, execute npm init -y para gerar um arquivo package.json.
2. Instale o pacote SDK da Perplexity
   Execute o comando npm install @perplexity/sdk no terminal. Isso baixa o SDK e suas dependências para a pasta node_modules.
3. Crie uma variável de ambiente para sua chave de API
   Copie sua chave de API do painel do desenvolvedor da Perplexity. Crie um arquivo chamado .env na raiz do projeto e adicione a linha PERPLEXITY_API_KEY=sua_chave_aqui. Substitua sua_chave_aqui pela chave real.
4. Instale o dotenv para carregar variáveis de ambiente
   Execute npm install dotenv. Este pacote lê o arquivo .env e disponibiliza as variáveis em process.env.
5. Escreva um script básico para testar o SDK
   Crie um arquivo chamado index.js e adicione o seguinte código:
   require('dotenv').config();
const { Perplexity } = require('@perplexity/sdk');
const client = new Perplexity({ apiKey: process.env.PERPLEXITY_API_KEY });
async function main() {
const response = await client.query({ query: 'Qual é a capital da França?' });
console.log(response.answer);
}
main();
6. Execute o script
   Digite node index.js no terminal. Se a configuração estiver correta, você verá a resposta impressa no console.

Problemas Comuns Durante a Instalação do SDK

npm install falha com erro de permissão

Isso geralmente acontece quando você executa o npm sem permissões de arquivo suficientes. Use sudo npm install @perplexity/sdk no macOS ou Linux. No Windows, abra o terminal como Administrador.

Não é possível encontrar o módulo @perplexity/sdk

O pacote SDK pode não ter sido instalado corretamente. Exclua a pasta node_modules e o arquivo package-lock.json. Execute npm install novamente para regenerá-los.

Chave de API está indefinida

O arquivo .env pode estar faltando ou não foi carregado. Certifique-se de que o dotenv seja importado no início do seu script. Verifique se o arquivo .env está no mesmo diretório do seu script e contém o nome exato da variável PERPLEXITY_API_KEY.

TypeError: client.query não é uma função

Isso indica que você está usando uma versão desatualizada do SDK. Execute npm update @perplexity/sdk para obter a versão mais recente. Consulte a documentação oficial para quaisquer mudanças nos nomes dos métodos da API.

Métodos de Instalação do SDK da Perplexity: npm vs Yarn vs pnpm

Item	npm	Yarn
Comando	npm install @perplexity/sdk	yarn add @perplexity/sdk
Arquivo de bloqueio	package-lock.json	yarn.lock
Velocidade de instalação	Moderada	Mais rápida com cache
Uso de disco	node_modules maior	Menor com estrutura plana

Todos os três gerenciadores de pacotes produzem a mesma funcionalidade do SDK. Escolha aquele que seu projeto já utiliza. Se você está começando do zero, o npm é o padrão e não requer configuração adicional.

Agora você tem o SDK Node.js da Perplexity instalado e configurado. Experimente o método streamQuery para streaming de respostas em tempo real, em vez de esperar pela resposta completa. Para aplicações em produção, armazene a chave de API em um gerenciador de segredos como AWS Secrets Manager ou Azure Key Vault, em vez de um arquivo .env.