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.
Principais Pontos: Instalação do SDK Node.js da Perplexity
- npm install @perplexity/sdk: Adiciona o pacote SDK da Perplexity ao seu projeto Node.js.
- process.env.PERPLEXITY_API_KEY: Armazena sua chave de API como uma variável de ambiente para acesso seguro.
- new Perplexity({ apiKey }): Cria uma instância do cliente SDK para enviar consultas e receber respostas.
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
- Crie ou abra seu projeto Node.js
Navegue até a pasta do seu projeto no terminal. Se você não tiver um projeto, executenpm init -ypara gerar um arquivo package.json. - Instale o pacote SDK da Perplexity
Execute o comandonpm install @perplexity/sdkno terminal. Isso baixa o SDK e suas dependências para a pasta node_modules. - 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 linhaPERPLEXITY_API_KEY=sua_chave_aqui. Substituasua_chave_aquipela chave real. - Instale o dotenv para carregar variáveis de ambiente
Executenpm install dotenv. Este pacote lê o arquivo .env e disponibiliza as variáveis em process.env. - 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(); - Execute o script
Digitenode index.jsno 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.
Que bom que ajudou. Faça uma pausa com um jogo:
Que pena. Busque pela mensagem de erro exata ou procure uma ferramenta que verifique o seu aparelho: