Apify (Pré-visualização)

O Apify executa web scrapers e agentes de IA, gere Atores e tarefas, agenda e monitoriza execuções, recupera conjuntos de dados e resultados, e desencadeia fluxos a partir de webhooks. Permite a recolha, enriquecimento e automação de dados de ponta a ponta nos fluxos de trabalho.

Este conector está disponível nos seguintes produtos e regiões:

Service Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Entrar em contato
Designação Suporte Apify
URL https://apify.com/contact
Email support@apify.com
Metadados do conector
Editor Apify
Encontre mais informações sobre o Apify. https://docs.apify.com
Sítio Web https://apify.com
Política de privacidade https://apify.com/privacy-policy
Categorias Dados; IA

Apify

A Apify é o maior mercado de ferramentas para IA. O conector Apify para Power Automate permite-lhe executar web scrapers e agentes de IA (chamados Atores), executar tarefas pré-configuradas, recuperar dados estruturados de conjuntos de dados e armazenamentos-chave-valor, e ativar fluxos de trabalho automatizados quando os trabalhos terminam. Mais de 30.000 Actors prontos a usar estão disponíveis na Apify Store para casos comuns de scraping e automação.

Editor

Apify Technologies s.r.o.

Pré-requisitos

  • Uma conta Apify – inscreva-se gratuitamente no apify.com. Inclui um nível gratuito com créditos mensais na plataforma.
  • Autorização OAuth 2.0 - o conector autentica-se através do fluxo OAuth do Apify. Não são necessários tokens API nem configuração manual de credenciais por parte dos utilizadores finais.

Como obter credenciais

O conector utiliza autenticação OAuth 2.0. Quando adiciona o conector Apify a um fluxo e cria uma nova ligação, é automaticamente redirecionado para a Consola Apify para autorizar o acesso. Siga estes passos:

  1. No teu fluxo do Power Automate, adiciona qualquer ação ou gatilho do Apify.
  2. Quando solicitado para criar uma ligação, clique em Iniciar sessão.
  3. Será redirecionado para a página de autorização da Consola Apify em console.apify.com.
  4. Se não estiver ligado ao Apify, introduza o email e a palavra-passe da sua conta Apify (ou use o login do Google/GitHub).
  5. Revise as permissões solicitadas:
    • Perfil - Acesso à informação do seu perfil de utilizador
    • full_api_access - acesso total à API Apify em seu nome
  6. Clique em Autorizar para conceder acesso ao conector.
  7. Será redirecionado de volta para o Power Automate com uma ligação ativa.

Não é necessário inserir manualmente tokens de API, IDs de cliente ou segredos por parte dos utilizadores finais. O conector gere automaticamente a atualização dos tokens.

Para a equipa de revisão de certificação da Microsoft

Para testar o conector, vai precisar de uma conta Apify. Pode criar um gratuitamente no apify.com - não é necessário cartão de crédito. O nível gratuito inclui créditos de plataforma suficientes para executar Atores de teste e verificar todas as operações dos conectores. Depois de criar uma conta, siga os passos 1 a 7 acima para autorizar o conector.

Operações suportadas

Ações

Operation Descrição
Run Actor Executa um Ator Apify com a entrada especificada. Pode escolher entre os Actors recentemente usados ou navegar pela Apify Store. Opcionalmente, espere até 60 segundos para a corrida terminar. Os retornos executam metadados incluindo estado, ID do conjunto de dados e ID de armazenamento chave-valor.
Executar tarefa Executa uma tarefa Actor pré-configurada. As tarefas armazenam configurações de entrada por defeito para que possas executá-las sem especificar a entrada de cada vez. Opcionalmente, substitua a entrada padrão por valores personalizados.
Raspar URL única Extrai uma única página web usando o Ator do Scraper Web do Apify. Escolha entre modos adaptativos (recomendado), navegador sem interface Firefox ou Cheerio (raw HTTP). Devolve os metadados da corrida para acompanhamento.
Obtenha itens do conjunto de dados Recupera itens de um conjunto de dados Apify. Os conjuntos de dados armazenam resultados estruturados das execuções do Actor. Suporta paginação com parâmetros de limite e deslocamento. O esquema de resposta é inferido dinamicamente a partir do conteúdo do conjunto de dados.
Obtenha registo de loja key-value Recupera um registo de um armazenamento chave-valor Apify pela sua chave. Os armazenamentos de chave-valor armazenam ficheiros, configurações e estado da execução. O esquema de resposta é inferido dinamicamente a partir do conteúdo do registo.

Triggers

Operation Descrição
Corrida de ator terminada Dispara quando uma sequência de Ator selecionado termina. Subscreva os estados específicos de conclusão: sucesso, falhado, expirado ou abortado. Todos os estados estão ativados por defeito. A carga útil do gatilho inclui detalhes completos da execução e metadados.
Tarefa de ator concluída Dispara quando termina uma tarefa de Ator selecionada. As mesmas opções de filtragem de estado que o gatilho do Actor executa e termina. Útil para monitorizar execuções de tarefas agendadas ou recorrentes.

Como Começar

Fluxo de trabalho básico: Executa um Ator e obtém resultados

  1. Adiciona a ação Executar Ator ao teu fluxo.
  2. Selecione um Ator dos seus Actors recentemente usados ou da Apify Store.
  3. Forneça o input JSON exigido pelo Ator.
  4. Adicionar a ação Obter itens do conjunto de dados .
  5. Use a saída do ID do conjunto de dados predefinido do passo Executar o Ator como parâmetro do Conjunto de Dados.
  6. Processe os itens devolvidos nos passos seguintes do fluxo.

Fluxo de trabalho orientado a eventos: Reagir às execuções concluídas

  1. Adicione o gatilho final de execução do Ator como o gatilho do fluxo.
  2. Selecione o Ator que quer monitorizar.
  3. Escolhe quais os estados de conclusão que devem desencadear o fluxo (todos ativados por defeito).
  4. Nos passos seguintes, utilize a carga útil do gatilho para aceder aos detalhes da corrida e obter resultados.

Fluxo de trabalho rápido de raspagem

  1. Adicionar a ação Scrape de URL única .
  2. Introduza o URL que quer extrair.
  3. Selecione um tipo de crawler (Adaptive é recomendado para a maioria dos sites).
  4. Usa o gatilho final do Actor run ou o poll para completar para obter resultados.

Problemas e limitações conhecidos

  • O parâmetro Esperar pelo Fim tem um máximo de 60 segundos. Para Atores de longa duração, usa o gatilho de execução final do Ator em vez de esperar.
  • Os esquemas de conjunto de dados são inferidos dinamicamente a partir de um item de amostra. Podem não captar todos os campos possíveis se o conjunto de dados contiver itens com estruturas variadas.
  • Os esquemas de registo de armazenamento chave-valor são inferidos a partir do conteúdo do registo. Os registos binários (imagens, PDFs) são devolvidos as-is sem inferência de esquema.
  • A ação Scrape de URL única usa um Ator fixo (Web Scraper). Para cenários avançados de scraping, use o Run Actor com um Ator especializado da Apify Store.
  • As opções de alocação de memória variam entre 128 MB e 32 GB. Comece pelas definições padrão para otimizar custos.

Erros e soluções comuns

Erro Solução
Impossível autenticar Certifique-se de que tem uma conta Apify ativa. Tenta remover a ligação e criar uma nova.
A corrida do ator devolve o estado FALHADO Verifique os registos de execução do Ator na Consola Apify para mensagens de erro detalhadas. Verifica se a entrada corresponde ao formato esperado pelo Ator.
O conjunto de dados fica vazio após a execução concluir Confirma que a sequência de Ator terminou com o estatuto SUCEDIDO. A estrutura do site-alvo pode ter mudado.
Tempo de fluxo à espera do Actor Defina "Esperar por Terminar" em 0 e use o gatilho "Ator run termined" para tratar atores de longa duração de forma assíncrona.
O gatilho do gancho não dispara Verifique se o Actor ou ID da tarefa está correto. Verifica se pelo menos um estado de evento está ativado.

FAQ

Quanto custa o Apify? O conector em si é gratuito. O Apify cobra pelo uso da plataforma com base no tempo de computação e nos recursos consumidos. Um nível gratuito com créditos mensais está incluído em todas as contas. Veja apify.com/pricing para mais detalhes.

O que são atores? Os Actors são programas serverless na cloud que correm na plataforma Apify. Podem realizar web scraping, extração de dados, automação de IA e muito mais. Consulte mais de 30.000 atores prontos a fazer na apify.com/store.

O que são tarefas? As tarefas são configurações guardadas para os Atores. Eles armazenam valores de entrada predefinidos para que possas executar um Ator com parâmetros pré-definidos sem teres de os reintroduzir cada vez.

Ações

Executar tarefa

Executa uma tarefa de Ator e regressa imediatamente sem esperar que a run termine. Para esperar que a execução termine, use o parâmetro de consulta waitForFinish.

Obtenha itens do conjunto de dados

Recupera itens de um dos teus conjuntos de dados Apify com parâmetros opcionais de paginação.

Obtenha registo de loja key-value

Obtém um valor armazenado no armazenamento chave-valor sob uma chave específica.

Raspar URL única

Extrai uma única URL usando o Web Scraper Actor. Esta ação inicia uma raspagem assíncrona e devolve imediatamente os detalhes da corrida. Use o gatilho final de execução do Ator para processar os resultados assim que a raspagem estiver concluída.

Run Actor

Executa um Actor e regressa imediatamente sem esperar que a série acabe. Para esperar que a execução termine, use o parâmetro de consulta waitForFinish.

Executar tarefa

Executa uma tarefa de Ator e regressa imediatamente sem esperar que a run termine. Para esperar que a execução termine, use o parâmetro de consulta waitForFinish.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Task
taskId True string

Identificador de tarefa a executar.

Espera pelo Fim (0-60 segundos)
waitForFinish integer

Espera que a corrida termine em segundos (0-60).

Tempo limite (segundos)
timeout integer

Pausa para a corrida em segundos.

Build
build string

Build do ator para executar (tag ou número de build). Normalmente é a 'mais recente'.

Memória (MB)
memory integer

Limite de memória em MB (potência de 2, min 128).

object

Um objeto JSON bruto para sobrepor a entrada padrão da tarefa.

Obtenha itens do conjunto de dados

Recupera itens de um dos teus conjuntos de dados Apify com parâmetros opcionais de paginação.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Dataset
datasetId True string

Selecione o conjunto de dados de onde recolher os itens.

Limit
limit integer

Número máximo de itens a devolver.

Offset
offset integer

Número de itens a saltar desde o início da lista.

Devoluções

As saídas desta operação são dinâmicas.

Obtenha registo de loja key-value

Obtém um valor armazenado no armazenamento chave-valor sob uma chave específica.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Store
storeId True string

Selecione a memória chave-valor de onde se deve recuperar o registo.

Key
recordKey True string

Selecione a chave a partir da qual recuperar o registo.

Devoluções

As saídas desta operação são dinâmicas.

Raspar URL única

Extrai uma única URL usando o Web Scraper Actor. Esta ação inicia uma raspagem assíncrona e devolve imediatamente os detalhes da corrida. Use o gatilho final de execução do Ator para processar os resultados assim que a raspagem estiver concluída.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
URL para Scrape
url True string

O URL completo da única página a ser extraído. Tem de ser um formato de URL válido.

Tipo de Crawler
crawler_type True string

Selecione o motor de rastreamento a usar para extrair a página.

Run Actor

Executa um Actor e regressa imediatamente sem esperar que a série acabe. Para esperar que a execução termine, use o parâmetro de consulta waitForFinish.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Selecionado Ator de
actorScope True string

Por favor, selecione a fonte para pesquisar atores.

Ator
actorId True string

Identificador de ator a executar. ID de Ator de Substituição.

Espera pelo Fim (0-60 segundos)
waitForFinish integer

Espera que a corrida termine em segundos (0-60).

Tempo limite (segundos)
timeout integer

Pausa para a corrida em segundos.

Build
build string

Build do ator para executar (tag ou número de build). Normalmente é a 'mais recente'.

Memória (MB)
memory integer

Limite de memória em MB (potência de 2, min 128).

object

Objeto JSON bruto passado como INPUT para o Ator.

Acionadores

Corrida de ator terminada

Cria um webhook para subscrever eventos organizados pelo ator. Ativa-se quando a corrida de Ator selecionada termina com um estado específico. Todos os estados estão ativados por defeito; apenas os estados explicitamente definidos como false são excluídos. Pelo menos um estado deve permanecer ativado.

Tarefa de ator concluída

Cria um webhook para subscrever eventos de execução de tarefas do Actor. É ativado quando a execução de tarefa selecionada do Ator termina com um estado específico. Todos os estados estão ativados por defeito; apenas os estados explicitamente definidos como false são excluídos. Pelo menos um estado deve permanecer ativado.

Corrida de ator terminada

Cria um webhook para subscrever eventos organizados pelo ator. Ativa-se quando a corrida de Ator selecionada termina com um estado específico. Todos os estados estão ativados por defeito; apenas os estados explicitamente definidos como false são excluídos. Pelo menos um estado deve permanecer ativado.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Selecionado Ator de
actorScope True string

Por favor, selecione a fonte para pesquisar atores.

Estados
eventTypes array of string

Os atores executam estados para ativar.

Ator
actorId True string

Identificador de ator para o monitor. ID de Ator de Substituição.

Trigger On Run Conseguido
onRunSucceeded boolean

Ativa-se quando uma corrida de Ator tem sucesso. O padrão é true se não estiver definido.

Gatilho ao Correr Falhou
onRunFailed boolean

Ativar quando uma jogada de Actor falhar. O padrão é true se não estiver definido.

Gatilho na Execução Esgotado
onRunTimedOut boolean

Ativa-se quando um Ator executa o tempo de expiração. Por defeito é verdadeiro se não estiver definido.

Trigger On Run abortado
onRunAborted boolean

Ativa-se quando uma execução de Ator é abortada. O padrão é true se não estiver definido.

Devoluções

Payload de evento enviado por webhook quando uma execução de Actor termina.

Carga útil do Webhook
WebhookPayloadSchema

Tarefa de ator concluída

Cria um webhook para subscrever eventos de execução de tarefas do Actor. É ativado quando a execução de tarefa selecionada do Ator termina com um estado específico. Todos os estados estão ativados por defeito; apenas os estados explicitamente definidos como false são excluídos. Pelo menos um estado deve permanecer ativado.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Estados
eventTypes array of string

Os atores executam estados para ativar.

Task
actorTaskId True string

Por favor, selecione a tarefa Ator para monitorizar eventos.

Trigger On Run Conseguido
onRunSucceeded boolean

Ativa-se quando uma corrida de Ator tem sucesso. O padrão é true se não estiver definido.

Gatilho ao Correr Falhou
onRunFailed boolean

Ativar quando uma jogada de Actor falhar. O padrão é true se não estiver definido.

Gatilho na Execução Esgotado
onRunTimedOut boolean

Ativa-se quando um Ator executa o tempo de expiração. Por defeito é verdadeiro se não estiver definido.

Trigger On Run abortado
onRunAborted boolean

Ativa-se quando uma execução de Ator é abortada. O padrão é true se não estiver definido.

Devoluções

Payload de evento enviado por webhook quando uma execução de Actor termina.

Carga útil do Webhook
WebhookPayloadSchema

Definições

ActorRunResponseSchema

Informação completa sobre uma execução de Actor executada.

Nome Caminho Tipo Descrição
ID run do ator
id string

Identificador único da corrida Actor.

ID do ator
actId string

Identificador único do Ator que foi executado.

ID de utilizador
userId string

Identificador único do utilizador que possui a execução do Ator.

ID da tarefa do ator
actorTaskId string

Identificador único da tarefa Ator (se a execução foi iniciada a partir de uma tarefa).

Começou em
startedAt date-time

Carimbo temporal em que a fase de Ator começou.

Terminado em
finishedAt date-time

Carimbo temporal em que a fase de Ator terminou.

Status
status string

Estado da execução do Ator (por exemplo, SUCCEEDED, FAILED, RUNNING, ABORTED).

Mensagem de estado
statusMessage string

Mensagem de estado detalhada da execução do Ator, incluindo resumo do processamento e resultados.

É terminal de mensagens de estado
isStatusMessageTerminal boolean

Se a mensagem de estado é terminal (final) ou pode mudar durante a execução.

Metadata
meta object

Metadados adicionais sobre a execução do Actor, incluindo informação de origem e agente de utilizador.

Informações sobre preços
pricingInfo object

Informação detalhada sobre preços, incluindo modelo de preços, eventos e distribuição de custos.

Estatísticas
stats object

Estatísticas de desempenho incluindo tempo de execução, uso de memória, uso de CPU e tráfego de rede.

Contagens de eventos cobrados
chargedEventCounts object

Contagem de eventos faturáveis que ocorreram durante a exibição do Actor.

Opções
options object

Opções de configuração usadas para a execução do Ator (memória, timeout, versão de compilação, etc.).

ID de compilação
buildId string

Identificador único da build Actor usada nesta execução.

Código de saída
exitCode number

Código de saída devolvido pelo processo Ator (0 indica sucesso).

ID de armazenamento chave-valor por defeito
defaultKeyValueStoreId string

Identificador único do armazenamento chave-valor por defeito associado a esta execução.

ID padrão do conjunto de dados
defaultDatasetId string

Identificador único do conjunto de dados padrão onde o Ator armazenava os seus resultados.

ID padrão da fila de pedidos
defaultRequestQueueId string

Identificador único da fila de pedidos padrão usada pelo Ator.

Número do build
buildNumber string

Número de compilação da versão Actor usada nesta corrida.

URL do contentor
containerUrl string

URL do contentor onde a execução do Ator foi executada.

Está pronto para servidores de contentores
isContainerServerReady boolean

Se o servidor de contentores está pronto e acessível.

Nome da filial Git
gitBranchName string

Nome do ramo Git usado para esta execução do Ator (se aplicável).

Total de utilização em USD
usageTotalUsd number

O custo total do Actor é em USD.

WebhookPayloadSchema

Payload de evento enviado por webhook quando uma execução de Actor termina.

Nome Caminho Tipo Descrição
userId
userId string

ID do utilizador que possui o recurso associado ao evento.

createdAt
createdAt date-time

A data/hora em que o evento ocorreu.

eventType
eventType string

O tipo de evento que desencadeou o webhook (por exemplo, ACTOR. RUN. SUCCEEDED).

actorId
eventData.actorId string

ID do Ator que disparou.

actorRunId
eventData.actorRunId string

ID da corrida específica de Ator que desencadeou o evento.

Resposta de corrida do ator
resource ActorRunResponseSchema

Informação completa sobre uma execução de Actor executada.