Pesquisa do Perplexity

​

Instalar o plugin

openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​

Obter uma chave de API da Perplexity

1. Crie uma conta da Perplexity em perplexity.ai/settings/api.
2. Gere uma chave de API no painel.
3. Armazene a chave na configuração ou defina PERPLEXITY_API_KEY no ambiente do Gateway.

​

Compatibilidade com o OpenRouter

• plugins.entries.perplexity.config.webSearch.baseUrl
• plugins.entries.perplexity.config.webSearch.model

​

Exemplos de configuração

​

API Perplexity Search nativa

{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: {
            apiKey: "pplx-...",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "perplexity",
      },
    },
  },
}

​

Compatibilidade com OpenRouter / Sonar

{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: {
            apiKey: "<openrouter-api-key>",
            baseUrl: "https://openrouter.ai/api/v1",
            model: "perplexity/sonar-pro",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "perplexity",
      },
    },
  },
}

​

Onde definir a chave

​

Parâmetros da ferramenta

• query, count e freshness são aceitos.
• Nesse fluxo, count existe apenas para compatibilidade; a resposta continua sendo uma única resposta sintetizada com citações, em vez de uma lista com N resultados.
• Os filtros exclusivos da API Search (country, language, date_after, date_before, domain_filter, max_tokens, max_tokens_per_page) retornam erros explícitos.

// Pesquisa específica por país e idioma
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Resultados recentes (última semana)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Pesquisa por intervalo de datas
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

// Filtragem por domínio (lista de permitidos)
await web_search({
  query: "climate research",
  domain_filter: ["nature.com", "science.org", ".edu"],
});

// Filtragem por domínio (lista de bloqueados — prefixe com -)
await web_search({
  query: "product reviews",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

// Extração de mais conteúdo
await web_search({
  query: "detailed AI research",
  max_tokens: 50000,
  max_tokens_per_page: 4096,
});

​

Regras do filtro de domínios

• Máximo de 20 domínios por filtro.
• Não é possível combinar entradas permitidas e bloqueadas na mesma solicitação.
• Use o prefixo - para entradas da lista de bloqueados (por exemplo, ["-reddit.com"]).

​

Observações

• A API Perplexity Search retorna resultados estruturados de pesquisa na web (title, url, snippet).
• O OpenRouter ou a definição explícita de plugins.entries.perplexity.config.webSearch.baseUrl / model faz o Perplexity voltar a usar conclusões de chat do Sonar para fins de compatibilidade.
• A compatibilidade com Sonar/OpenRouter retorna uma única resposta sintetizada com citações, não linhas de resultados estruturados.
• Por padrão, os resultados são armazenados em cache por 15 minutos (configurável por meio de cacheTtlMinutes).

​

Relacionados