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 |
| 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:
- Em seu fluxo de Power Automate, adicione qualquer ação ou gatilho apify.
- Quando solicitado a criar uma conexão, clique em Entrar.
- Você será redirecionado para a página de autorização do Console do Apify em
console.apify.com. - 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).
- 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
- Clique em Autorizar para conceder acesso ao conector.
- 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
- Adicione a ação Executar Ator ao seu fluxo.
- Selecione um Ator em seus Atores usados recentemente ou no Apify Store.
- Forneça o JSON de entrada exigido pelo Ator.
- Adicione a ação Obter itens do conjunto de dados .
- Use a saída da ID do conjunto de dados padrão da etapa Executar Ator como o parâmetro do conjunto de dados.
- Processe os itens retornados nas etapas de fluxo subsequentes.
Fluxo de trabalho controlado por eventos: Reagir a execuções concluídas
- Adicione o gatilho concluído da execução do Ator como gatilho do fluxo.
- Selecione o Ator que você deseja monitorar.
- Escolha quais status de conclusão devem disparar o fluxo (todos habilitados por padrão).
- 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
- Adicione a ação de URL única do Scrape .
- Insira a URL que você deseja raspar.
- Selecione um tipo de rastreador (adaptável é recomendado para a maioria dos sites).
- 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.
Links úteis
- Documentação do Apify
- Referência da API apify
- Apify Store – procurar atores
- Preços de apify
- Suporte e contato
- Fórum da comunidade
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
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
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. |