Apify (versão prévia)

O Apify executa scrapers da Web e agentes de IA, gerencia atores e tarefas, agenda e monitora execuções, recupera conjuntos de dados e resultados e dispara fluxos de webhooks. Ele habilita a coleta, o enriquecimento e a automação de dados de ponta a ponta em fluxos de trabalho.

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

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - 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 (GCC)
     – 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 Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Apify support
URL https://apify.com/contact
Email support@apify.com
Metadados do conector
Publicador Aplicar
Encontre mais informações sobre o Apify. https://docs.apify.com
Site https://apify.com
Política de privacidade https://apify.com/privacy-policy
Categories Dados; IA

Aplicar

O Apify é o maior marketplace de ferramentas para IA. O conector do Apify para Power Automate permite executar agentes de IA e de arquivos da Web (chamados de Atores), executar tarefas pré-configuradas, recuperar dados estruturados de conjuntos de dados e repositórios de chave-valor e disparar fluxos de trabalho automatizados quando os trabalhos forem concluídos. Mais de 30.000 atores prontos estão disponíveis no Apify Store para casos comuns de uso de sucata e automação.

Publicador

Apify Technologies s.r.o.

Pré-requisitos

  • Uma conta do Apify – inscreva-se gratuitamente no apify.com. Uma camada gratuita com créditos mensais da plataforma está incluída.
  • Autorização do OAuth 2.0 – o conector é autenticado por meio do fluxo OAuth do Apify. Nenhum token de API ou configuração de credencial manual é necessário dos usuários finais.

Como obter credenciais

O conector usa autenticação OAuth 2.0. Ao adicionar o conector do Apify a um fluxo e criar uma nova conexão, você será redirecionado automaticamente ao Console do Apify para autorizar o acesso. Siga estas etapas:

  1. Em seu fluxo de Power Automate, adicione qualquer ação ou gatilho apify.
  2. Quando solicitado a criar uma conexão, clique em Entrar.
  3. Você será redirecionado para a página de autorização do Console do Apify em console.apify.com.
  4. Se você não estiver conectado ao Apify, insira o email e a senha da sua conta do Apify (ou use a entrada do Google/GitHub).
  5. Examine as permissões solicitadas:
    • perfil – acesso às informações do perfil do usuário
    • full_api_access - acesso completo à API do Apify em seu nome
  6. Clique em Autorizar para conceder acesso ao conector.
  7. Você será redirecionado de volta para Power Automate com uma conexão ativa.

Nenhuma entrada manual de tokens de API, IDs de cliente ou segredos é necessária dos usuários finais. O conector manipula a atualização de token automaticamente.

Para a equipe de revisão de certificação do Microsoft

Para testar o conector, você precisará de uma conta apify. Você pode criar um gratuitamente em apify.com - nenhum cartão de crédito é necessário. A camada gratuita inclui créditos de plataforma suficientes para executar atores de teste e verificar todas as operações do conector. Depois de criar uma conta, siga as etapas 1 a 7 acima para autorizar o conector.

Operações com suporte

Ações

Operação Descrição
Executar Ator Executa um Apify Actor com a entrada especificada. Você pode selecionar entre atores usados recentemente ou procurar o Apify Store. Opcionalmente, aguarde até 60 segundos para que a execução seja concluída. Retorna metadados de execução, incluindo status, ID do conjunto de dados e ID do repositório chave-valor.
Executar tarefa Executa uma tarefa de Ator pré-configurada. As tarefas armazenam configurações de entrada padrão para que você possa executá-las sem especificar a entrada a cada vez. Opcionalmente, substitua a entrada padrão com valores personalizados.
Raspar URL única Raspa uma única página da Web usando o Apify Web Scraper Actor. Escolha entre os modos de rastreamento adaptáveis (recomendados), do Firefox sem cabeça ou do Cheerio (HTTP bruto). Retorna os metadados de execução para acompanhamento.
Obter itens de conjunto de dados Recupera itens de um conjunto de dados apify. Os conjuntos de dados armazenam resultados estruturados de execuções de Ator. Dá suporte à paginação com parâmetros de limite e deslocamento. O esquema de resposta é dinamicamente inferido do conteúdo do conjunto de dados.
Obter o registro do repositório chave-valor Recupera um registro de um repositório de chave-valor do Apify por sua chave. Os repositórios de chave-valor contêm arquivos, configurações e estado de execução. O esquema de resposta é dinamicamente inferido do conteúdo do registro.

Triggers

Operação Descrição
Execução do ator concluída É acionado quando uma execução de Ator selecionada é concluída. Assine os status de conclusão específicos: bem-sucedido, com falha, tempo limite ou anulado. Todos os status são habilitados por padrão. O conteúdo do gatilho inclui detalhes de execução completa e metadados.
Tarefa do ator concluída É acionado quando uma execução de tarefa de Ator selecionada é concluída. Mesmas opções de filtragem de status que o gatilho concluído da execução do Ator. Útil para monitorar execuções de tarefas agendadas ou recorrentes.

Como começar

Fluxo de trabalho básico: executar um Ator e obter resultados

  1. Adicione a ação Executar Ator ao seu fluxo.
  2. Selecione um Ator em seus Atores usados recentemente ou no Apify Store.
  3. Forneça o JSON de entrada exigido pelo Ator.
  4. Adicione a ação Obter itens do conjunto de dados .
  5. Use a saída da ID do conjunto de dados padrão da etapa Executar Ator como o parâmetro do conjunto de dados.
  6. Processe os itens retornados nas etapas de fluxo subsequentes.

Fluxo de trabalho controlado por eventos: Reagir a execuções concluídas

  1. Adicione o gatilho concluído da execução do Ator como gatilho do fluxo.
  2. Selecione o Ator que você deseja monitorar.
  3. Escolha quais status de conclusão devem disparar o fluxo (todos habilitados por padrão).
  4. Nas etapas subsequentes, use o conteúdo do gatilho para acessar os detalhes da execução e recuperar resultados.

Fluxo de trabalho de raspagem rápida

  1. Adicione a ação de URL única do Scrape .
  2. Insira a URL que você deseja raspar.
  3. Selecione um tipo de rastreador (adaptável é recomendado para a maioria dos sites).
  4. Use o gatilho concluído da execução do Ator ou a sondagem para conclusão para obter resultados.

Limitações e problemas conhecidos

  • O parâmetro Wait for Finish tem um máximo de 60 segundos. Para atores de longa duração, use o gatilho concluído de execução de Ator em vez de aguardar.
  • Esquemas de conjunto de dados são dinamicamente inferidos de um item de exemplo. Eles podem não capturar todos os campos possíveis se o conjunto de dados contiver itens com estruturas variadas.
  • Os esquemas de registro do repositório chave-valor são inferidos do conteúdo do registro. Registros binários (imagens, PDFs) são retornados as-is sem inferência de esquema.
  • A ação de URL única do Scrape usa um Ator fixo (Web Scraper). Para cenários avançados de raspagem, use o Run Actor com um ator especializado do Apify Store.
  • As opções de alocação de memória variam de 128 MB a 32 GB. Comece com as configurações padrão para otimizar os custos.

Erros comuns e soluções

Erro Solução
Não é possível autenticar Verifique se você tem uma conta apify ativa. Tente remover a conexão e criar uma nova.
A execução do ator retorna o status FAILED Verifique os logs de execução do Ator no Console do Apify para obter mensagens de erro detalhadas. Verifique se a entrada corresponde ao formato esperado do Ator.
O conjunto de dados está vazio após a conclusão da execução Confirme se a execução de Ator foi concluída com o status SUCCEEDED. A estrutura do site de destino pode ter sido alterada.
Tempo limite de fluxo à espera do Ator Defina "Wait for Finish" como 0 e use o gatilho "Execução de ator concluída" para lidar com atores de longa execução de forma assíncrona.
Gatilho de webhook não disparado Verifique se a ID do ator ou da tarefa está correta. Verifique se pelo menos um status de evento está habilitado.

perguntas frequentes

Quanto custa o Apify? O conector em si é gratuito. Apify encargos para uso da plataforma com base no tempo de computação e recursos consumidos. Uma camada gratuita com créditos mensais é incluída em cada conta. Consulte apify.com/pricing para obter detalhes.

O que são Atores? Os atores são programas de nuvem sem servidor executados na plataforma Apify. Eles podem executar a extração de dados, a extração de dados, a automação de IA e muito mais. Navegue por mais de 30.000 atores prontos em apify.com/store.

O que são tarefas? As tarefas são configurações salvas para atores. Eles armazenam valores de entrada padrão para que você possa executar um Ator com parâmetros pré-definidos sem inseri-los novamente todas as vezes.

Ações

Executar Ator

Executa um Ator e retorna imediatamente sem esperar que a execução seja concluída. Para aguardar a conclusão da execução, use o parâmetro de consulta waitForFinish.

Executar tarefa

Executa uma tarefa ator e retorna imediatamente sem esperar a execução ser concluída. Para aguardar a conclusão da execução, use o parâmetro de consulta waitForFinish.

Obter itens de conjunto de dados

Recupera itens de um de seus conjuntos de dados apify com parâmetros de paginação opcionais.

Obter o registro do repositório chave-valor

Obtém um valor armazenado no repositório chave-valor em uma chave específica.

Raspar URL única

Raspa uma única URL usando o Web Scraper Actor. Essa ação inicia um arranhão assíncrono e retorna os detalhes da execução imediatamente. Use o gatilho concluído de execução do Ator para processar os resultados depois que a raspagem for concluída.

Executar Ator

Executa um Ator e retorna imediatamente sem esperar que a execução seja concluída. Para aguardar a conclusão da execução, use o parâmetro de consulta waitForFinish.

Parâmetros

Nome Chave Obrigatório Tipo Description
Selecionar Ator de
actorScope True string

Selecione a origem da qual pesquisar atores.

Ator
actorId True string

Identificador de ator a ser executado. ID do ator de fornecimento.

Aguarde até concluir (0 a 60 segundos)
waitForFinish integer

Aguarde até que a execução seja concluída em segundos (0-60).

Tempo limite (segundos)
timeout integer

Tempo limite para a execução em segundos.

Build
build string

Compilação de ator a ser executada (marca ou número de build). Normalmente é o "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.

Executar tarefa

Executa uma tarefa ator e retorna imediatamente sem esperar a execução ser concluída. Para aguardar a conclusão da execução, use o parâmetro de consulta waitForFinish.

Parâmetros

Nome Chave Obrigatório Tipo Description
Task
taskId True string

Identificador de tarefa a ser executado.

Aguarde até concluir (0 a 60 segundos)
waitForFinish integer

Aguarde até que a execução seja concluída em segundos (0-60).

Tempo limite (segundos)
timeout integer

Tempo limite para a execução em segundos.

Build
build string

Compilação de ator a ser executada (marca ou número de build). Normalmente é o "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 substituir a entrada padrão da tarefa.

Obter itens de conjunto de dados

Recupera itens de um de seus conjuntos de dados apify com parâmetros de paginação opcionais.

Parâmetros

Nome Chave Obrigatório Tipo Description
Dataset
datasetId True string

Selecione o conjunto de dados do qual recuperar itens.

Limite
limit integer

Número máximo de itens a serem retornados.

Offset
offset integer

Número de itens a serem pulados do início da lista.

Retornos

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

Obter o registro do repositório chave-valor

Obtém um valor armazenado no repositório chave-valor em uma chave específica.

Parâmetros

Nome Chave Obrigatório Tipo Description
Store
storeId True string

Selecione o repositório chave-valor do qual recuperar o registro.

Chave
recordKey True string

Selecione a chave da qual recuperar o registro.

Retornos

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

Raspar URL única

Raspa uma única URL usando o Web Scraper Actor. Essa ação inicia um arranhão assíncrono e retorna os detalhes da execução imediatamente. Use o gatilho concluído de execução do Ator para processar os resultados depois que a raspagem for concluída.

Parâmetros

Nome Chave Obrigatório Tipo Description
URL para Raspar
url True string

A URL completa da página única a ser raspada. Deve ser um formato de URL válido.

Tipo de rastreador
crawler_type True string

Selecione o mecanismo de rastreamento a ser usado para raspar a página.

Gatilhos

Execução do ator concluída

Cria um webhook para assinar eventos de execução de ator. Dispara quando a execução de Ator selecionada é concluída com um status específico. Todos os status são habilitados por padrão; somente os status definidos explicitamente como false são excluídos. Pelo menos um status deve permanecer habilitado.

Tarefa do ator concluída

Cria um webhook para assinar eventos de execução de tarefa de ator. Dispara quando a execução da tarefa Ator selecionada é concluída com um status específico. Todos os status são habilitados por padrão; somente os status definidos explicitamente como false são excluídos. Pelo menos um status deve permanecer habilitado.

Execução do ator concluída

Cria um webhook para assinar eventos de execução de ator. Dispara quando a execução de Ator selecionada é concluída com um status específico. Todos os status são habilitados por padrão; somente os status definidos explicitamente como false são excluídos. Pelo menos um status deve permanecer habilitado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Selecionar Ator de
actorScope True string

Selecione a origem da qual pesquisar atores.

Status
eventTypes array of string

O ator executa status para disparar.

Ator
actorId True string

Identificador de ator a ser monitorado. ID do ator de fornecimento.

Gatilho em execução bem-sucedida
onRunSucceeded boolean

Disparar quando uma execução de Ator for bem-sucedida. O padrão é true se não for definido.

Gatilho em execução com falha
onRunFailed boolean

Disparar quando uma execução de Ator falhar. O padrão é true se não for definido.

Gatilho em tempo limite de execução
onRunTimedOut boolean

Disparar quando um Ator atingir o tempo limite. O padrão é true se não for definido.

Gatilho em execução anulada
onRunAborted boolean

Gatilho quando uma execução de Ator é anulada. O padrão é true se não for definido.

Retornos

Conteúdo do evento enviado pelo webhook quando uma execução de Ator é concluída.

Carga útil do webhook
WebhookPayloadSchema

Tarefa do ator concluída

Cria um webhook para assinar eventos de execução de tarefa de ator. Dispara quando a execução da tarefa Ator selecionada é concluída com um status específico. Todos os status são habilitados por padrão; somente os status definidos explicitamente como false são excluídos. Pelo menos um status deve permanecer habilitado.

Parâmetros

Nome Chave Obrigatório Tipo Description
Status
eventTypes array of string

O ator executa status para disparar.

Task
actorTaskId True string

Selecione a tarefa Ator a ser monitorada para eventos.

Gatilho em execução bem-sucedida
onRunSucceeded boolean

Disparar quando uma execução de Ator for bem-sucedida. O padrão é true se não for definido.

Gatilho em execução com falha
onRunFailed boolean

Disparar quando uma execução de Ator falhar. O padrão é true se não for definido.

Gatilho em tempo limite de execução
onRunTimedOut boolean

Disparar quando um Ator atingir o tempo limite. O padrão é true se não for definido.

Gatilho em execução anulada
onRunAborted boolean

Gatilho quando uma execução de Ator é anulada. O padrão é true se não for definido.

Retornos

Conteúdo do evento enviado pelo webhook quando uma execução de Ator é concluída.

Carga útil do webhook
WebhookPayloadSchema

Definições

ActorRunResponseSchema

Informações completas sobre uma execução do Ator executada.

Nome Caminho Tipo Description
ID de execução do ator
id string

Identificador exclusivo da execução de Ator.

ID do Ator
actId string

Identificador exclusivo do Ator que foi executado.

ID do usuário
userId string

Identificador exclusivo do usuário que possui a execução de Ator.

ID da tarefa do ator
actorTaskId string

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

Iniciado em
startedAt date-time

Carimbo de data/hora quando a execução do Ator começou.

Concluído em
finishedAt date-time

Carimbo de data/hora quando a execução do Ator terminou.

Status
status string

Status da execução ator (por exemplo, SUCCEEDED, FAILED, RUNNING, ABORTED).

Mensagem de status
statusMessage string

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

É o terminal de mensagens de status
isStatusMessageTerminal boolean

Se a mensagem de status é terminal (final) ou pode ser alterada durante a execução.

Metadata
meta object

Metadados adicionais sobre a execução do Ator, incluindo informações de origem e agente do usuário.

Informações sobre preços
pricingInfo object

Informações detalhadas sobre preços, incluindo modelo de preços, eventos e detalhamento de custos.

Estatísticas
stats object

Estatísticas de desempenho, incluindo runtime, uso de memória, uso da CPU e tráfego de rede.

Contagens de eventos cobrados
chargedEventCounts object

Contagem de eventos faturáveis que ocorreram durante a execução do Ator.

Opções
options object

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

ID de compilação
buildId string

Identificador exclusivo do build de Ator usado para esta execução.

Código de saída
exitCode number

Código de saída retornado pelo processo ator (0 indica êxito).

ID do repositório de chave-valor padrão
defaultKeyValueStoreId string

Identificador exclusivo do repositório chave-valor padrão associado a essa execução.

ID do conjunto de dados padrão
defaultDatasetId string

Identificador exclusivo do conjunto de dados padrão em que o Ator armazenou seus resultados.

ID da fila de solicitação padrão
defaultRequestQueueId string

Identificador exclusivo da fila de solicitação padrão usada pelo Ator.

Número da compilação
buildNumber string

Número de build da versão do Ator usada para esta execução.

URL do contêiner
containerUrl string

URL do contêiner em que a execução do Ator foi executada.

O servidor de contêiner está pronto
isContainerServerReady boolean

Se o servidor de contêiner está pronto e acessível.

Nome do branch do Git
gitBranchName string

Nome do branch git usado para esta execução de Ator (se aplicável).

USD total de uso
usageTotalUsd number

Custo total da execução do Ator em USD.

WebhookPayloadSchema

Conteúdo do evento enviado pelo webhook quando uma execução de Ator é concluída.

Nome Caminho Tipo Description
userId
userId string

ID do usuário que possui o recurso associado ao evento.

createdAt
createdAt date-time

O carimbo de data/hora em que o evento ocorreu.

eventType
eventType string

O tipo do evento que disparou o webhook (por exemplo, ACTOR. EXECUTE. BEM-SUCEDIDO).

actorId
eventData.actorId string

ID do ator que dispara.

actorRunId
eventData.actorRunId string

ID da execução específica do Ator que disparou o evento.

Resposta de execução do ator
resource ActorRunResponseSchema

Informações completas sobre uma execução do Ator executada.