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 |
| 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:
- No teu fluxo do Power Automate, adiciona qualquer ação ou gatilho do Apify.
- Quando solicitado para criar uma ligação, clique em Iniciar sessão.
- Será redirecionado para a página de autorização da Consola Apify em
console.apify.com. - 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).
- Revise as permissões solicitadas:
- Perfil - Acesso à informação do seu perfil de utilizador
- full_api_access - acesso total à API Apify em seu nome
- Clique em Autorizar para conceder acesso ao conector.
- 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
- Adiciona a ação Executar Ator ao teu fluxo.
- Selecione um Ator dos seus Actors recentemente usados ou da Apify Store.
- Forneça o input JSON exigido pelo Ator.
- Adicionar a ação Obter itens do conjunto de dados .
- Use a saída do ID do conjunto de dados predefinido do passo Executar o Ator como parâmetro do Conjunto de Dados.
- Processe os itens devolvidos nos passos seguintes do fluxo.
Fluxo de trabalho orientado a eventos: Reagir às execuções concluídas
- Adicione o gatilho final de execução do Ator como o gatilho do fluxo.
- Selecione o Ator que quer monitorizar.
- Escolhe quais os estados de conclusão que devem desencadear o fluxo (todos ativados por defeito).
- 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
- Adicionar a ação Scrape de URL única .
- Introduza o URL que quer extrair.
- Selecione um tipo de crawler (Adaptive é recomendado para a maioria dos sites).
- 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.
Ligações úteis
- Documentação do Apify
- Referência API do Apify
- Loja Apify - navegue por Actors
- Preços Apify
- Apoio e contacto
- Fórum comunitário
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
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
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. |