Apresentamos a Monitor API da Perplexity

Acompanhe desdobramentos na web e mudanças em páginas com a Monitor API da Perplexity. Receba atualizações relevantes por meio de um webhook.

Monitor API illustration with orange light beams and dotted patterns on a dark background.

A web muda a cada segundo. Aplicativos ou agentes que consultam informações da web precisam saber quando e como elas mudaram. Um agente de vendas precisa saber quando uma conta anuncia uma captação de recursos. Um agente de programação precisa de um alerta quando uma API lança uma mudança incompatível. Uma equipe de produto precisa acompanhar as mudanças na página de preços de um concorrente.

A maioria das equipes faz esse monitoramento executando pesquisas programadas e mantendo código personalizado para remover duplicatas e identificar mudanças. Isso funciona para algumas consultas, mas fica mais difícil de manter quando se trata de centenas de temas e páginas.

Hoje, estamos lançando a Monitor API para monitorar a web em grande escala. O Monitor pode observar a web como um todo em busca de novos desdobramentos sobre um tema ou acompanhar mudanças em uma página específica. Ele faz verificações programadas e envia um webhook quando encontra uma atualização relevante.

Monitoramento em diversos casos de uso e setores

Os desenvolvedores podem definir e criar um Monitor em linguagem simples. Cada monitor tem uma consulta de pesquisa ou uma lista de páginas, além de um objetivo opcional que pode ser especificado em linguagem simples. O exemplo abaixo mostra como detectar novas rodadas de investimento no setor de infraestrutura de IA, com o objetivo de identificar empresas que captaram rodadas Série A ou B.

O Monitor oferece suporte tanto ao monitoramento de temas amplos quanto a verificações em páginas específicas. O modo depende de o aplicativo precisar descobrir novas informações na web ou acompanhar uma fonte conhecida:

  • Monitorar a web: Acompanhe novos desdobramentos sobre um tema, uma empresa ou uma pergunta. O Monitor executa a consulta pelo Perplexity Search em resultados da web e de notícias.
  • Monitorar páginas: Acompanhe mudanças em até 10 páginas especificadas, como uma página de preços, um changelog ou uma página de política. A verificação inicial salva uma referência. As execuções seguintes retornam um diff de texto do que mudou.

O Perplexity Decider verifica cada resultado em relação a um objetivo definido. Os resultados do Web Monitor devem passar pelas quatro verificações a seguir: relevância, legitimidade da fonte, informação nova e atualidade. Para mudanças do Page Monitor, o Decider verifica se a mudança é significativa para o objetivo.

Uma atualização só é enviada se todas as verificações atingirem seus limites, e cada atualização inclui uma pontuação de confiança. Os limites podem ser ajustados por verificação. Os desenvolvedores também podem atualizar o objetivo sem recriar o monitor. Os desenvolvedores podem mudar o que conta como relevante a qualquer momento atualizando o objetivo, sem recriar o monitor.

Agendamento e entrega flexíveis

Os monitores são executados em um intervalo fixo, como a cada 15 minutos, de hora em hora, diariamente ou semanalmente, ou em um agendamento cron personalizado. Cada execução continua de onde a anterior parou, e o Monitor cuida da eliminação de resultados duplicados entre as execuções.

As atualizações relevantes são entregues por webhooks assinados, com novas tentativas automáticas em caso de falhas temporárias de entrega. Esses webhooks podem acionar fluxos de trabalho de agentes, como pesquisar uma conta após um anúncio de captação de recursos ou recomendar mudanças de preços após uma atualização de um concorrente. Os monitores também podem notificar você quando forem pausados automaticamente.

Pause, retome ou execute monitores sob demanda, pela API ou pelo API Console.

Mais resultados recentes e relevantes

Testamos o Monitor em comparação com provedores de Search API em 60 temas extraídos de consultas reais à Search API, incluindo notícias de empresas, lançamentos de tecnologia e regulamentação. Cada monitor acompanhou novas informações sobre seu tema durante oito horas. Em seguida, um modelo separado avaliou os resultados quanto à relevância e ao momento da publicação.

Nesta avaliação, a Perplexity entregou o maior número de resultados recentes e relevantes na mais ampla variedade de temas. Muitos dos resultados não foram retornados por nenhum outro provedor.

O Monitor funciona em diferentes setores

O Monitor ajuda as equipes a criar aplicativos e agentes que agem com base em novas informações. Alguns casos de uso em produção incluem:

  • Engenharia de GTM: Monitore anúncios de captação de recursos, contratações de executivos e lançamentos de produtos para acionar pesquisas de contas, atualizações no CRM e contatos no momento certo por meio de fluxos de trabalho de agentes conectados.
  • Análise de ações: Acompanhe divulgações de resultados, mudanças de projeções, anúncios de aquisições e notícias negativas para resumir os desdobramentos e sinalizar possíveis implicações para a tese de investimento de um analista.
  • Inteligência competitiva: Acompanhe de perto a atividade dos concorrentes em preços, lançamentos de produtos e changelogs para sinalizar mudanças e atualizar os resumos competitivos.
  • Monitoramento regulatório: Observe os anúncios e as páginas de orientações dos órgãos reguladores para que os agentes possam resumir as mudanças e encaminhá-las às equipes de compliance para análise.

Preços e disponibilidade

Os monitores web custam US$ 1 a cada 1.000 execuções bem-sucedidas. Os monitores de página custam US$ 1 a cada 1.000 URLs buscadas, já que uma única execução pode buscar várias páginas. Uma execução é uma verificação programada ou sob demanda.

A Monitor API já está disponível pela API e pelo API Console, usando a mesma chave de API da Search, da Context e da Agent API.

Primeiros passos

Shell
text
curl --request POST https://api.perplexity.ai/v1/monitors \ --header "Authorization: Bearer $PERPLEXITY_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "name": "AI infra funding", "targets": [ {"type": "search", "query": "AI infrastructure funding rounds"} ], "goal": "New Series A or B announcements", "schedule": {"type": "interval", "interval": "1d"}, "webhook": {"url": "https://agent.example.com/hooks"} }'

Cada execução que encontra atualizações relevantes as envia para seu webhook: novos resultados com título, trecho e pontuação de confiança, ou um diff de texto para mudanças em páginas. Adicione metadados para direcionar cada atualização de volta ao usuário, ao espaço de trabalho ou ao agente certo.

Leia a documentação da Monitor API ou crie um monitor no API Console.