Apify (anteprima)

Apify esegue gli scraper Web e gli agenti di intelligenza artificiale, gestisce attori e attività, pianificazioni e monitoraggi, recupera set di dati e risultati e attiva i flussi dai webhook. Consente la raccolta, l'arricchimento e l'automazione dei dati end-to-end nei flussi di lavoro.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Service Class Regioni
Copilot Studio Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica Standard Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - Aree di Azure per enti pubblici
     - Aree di Azure Cina
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps Di alta qualità Tutte le aree di Power Apps , ad eccezione dei seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Contatto
Nome Supporto di Apify
URL https://apify.com/contact
Email support@apify.com
Metadati del connettore
Server di pubblicazione Apify
Altre informazioni su Apify. https://docs.apify.com
Sito web https://apify.com
Informativa sulla privacy https://apify.com/privacy-policy
Categorie Dati; Intelligenza artificiale

Apify

Apify è il più grande marketplace di strumenti per l'intelligenza artificiale. Il connettore Apify per Power Automate consente di eseguire gli scraper Web e gli agenti di intelligenza artificiale (denominati Attori), eseguire attività preconfigurate, recuperare dati strutturati da set di dati e archivi chiave-valore e attivare flussi di lavoro automatizzati al termine dei processi. Oltre 30.000 attori pronti sono disponibili in Apify Store per casi d'uso comuni di raschiatura e automazione.

Server di pubblicazione

Apify Technologies s.r.o.

Prerequisiti

  • Un account Apify : iscriversi gratuitamente al apify.com. È incluso un livello gratuito con crediti mensili della piattaforma.
  • Autorizzazione OAuth 2.0 : il connettore esegue l'autenticazione tramite il flusso OAuth di Apify. Agli utenti finali non sono necessari token API o configurazione manuale delle credenziali.

Come ottenere le credenziali

Il connettore usa l'autenticazione OAuth 2.0. Quando si aggiunge il connettore Apify a un flusso e si crea una nuova connessione, si viene reindirizzati automaticamente a Apify Console per autorizzare l'accesso. Segui questi passaggi:

  1. Nel flusso di Power Automate aggiungere qualsiasi azione o trigger apify.
  2. Quando viene richiesto di creare una connessione, fare clic su Accedi.
  3. Si verrà reindirizzati alla pagina di autorizzazione di Apify Console all'indirizzo console.apify.com.
  4. Se non si è connessi ad Apify, immettere l'indirizzo di posta elettronica e la password dell'account Apify (o usare Google/GitHub l'accesso).
  5. Esaminare le autorizzazioni richieste:
    • profile : accesso alle informazioni del profilo utente
    • full_api_access : accesso completo all'API Apify per conto dell'utente
  6. Fare clic su Autorizza per concedere l'accesso al connettore.
  7. Si verrà reindirizzati di nuovo a Power Automate con una connessione attiva.

Agli utenti finali non è richiesta alcuna voce manuale di token API, ID client o segreti. Il connettore gestisce automaticamente l'aggiornamento del token.

Per il team di revisione della certificazione Microsoft

Per testare il connettore, è necessario un account Apify. È possibile crearne uno gratuitamente in apify.com : non è necessaria alcuna carta di credito. Il livello gratuito include crediti della piattaforma sufficienti per eseguire gli attori di test e verificare tutte le operazioni del connettore. Dopo aver creato un account, seguire i passaggi da 1 a 7 precedenti per autorizzare il connettore.

Operazioni supportate

Azioni

Operation Descrizione
Esegui attore Esegue un attore Apify con l'input specificato. È possibile selezionare gli attori usati di recente o sfogliare Apify Store. Facoltativamente, attendere fino a 60 secondi per il completamento dell'esecuzione. Restituisce i metadati di esecuzione, inclusi lo stato, l'ID del set di dati e l'ID archivio chiave-valore.
Eseguire l'attività Esegue un'attività Actor preconfigurato. Le attività archiviano le configurazioni di input predefinite in modo da poterle eseguire senza specificare l'input ogni volta. Facoltativamente, eseguire l'override dell'input predefinito con valori personalizzati.
Url singolo scrape Elimina una singola pagina Web usando Apify Web Scraper Actor. Scegliere tra modalità di ricerca per indicizzazione adattive (consigliate), browser headless di Firefox o Cheerio (HTTP non elaborato). Restituisce i metadati di esecuzione per il rilevamento.
Ottenere gli elementi del set di dati Recupera gli elementi da un set di dati Apify. I set di dati archiviano i risultati strutturati dalle esecuzioni actor. Supporta la paginazione con parametri limit e offset. Lo schema di risposta viene dedotto dinamicamente dal contenuto del set di dati.
Ottenere il record dell'archivio chiave-valore Recupera un record da un archivio chiave-valore apify in base alla relativa chiave. Key-value archivia i file, le configurazioni e lo stato di esecuzione. Lo schema di risposta viene dedotto dinamicamente dal contenuto del record.

Trigger

Operation Descrizione
Esecuzione dell'attore completata Viene generato al termine dell'esecuzione di un attore selezionato. Sottoscrivere stati di completamento specifici: operazione riuscita, non riuscita, timeout o interruzione. Tutti gli stati sono abilitati per impostazione predefinita. Il payload del trigger include i dettagli e i metadati completi dell'esecuzione.
Attività attore completata Viene generato al termine dell'esecuzione di un'attività Actor selezionata. Le stesse opzioni di filtro dello stato dell'esecuzione dell'attore hanno terminato il trigger. Utile per il monitoraggio delle esecuzioni di attività pianificate o ricorrenti.

Come iniziare

Flusso di lavoro di base: eseguire un attore e ottenere risultati

  1. Aggiungere l'azione Esegui attore al flusso.
  2. Selezionare un attore dagli attori usati di recente o da Apify Store.
  3. Specificare il codice JSON di input richiesto dall'attore.
  4. Aggiungere l'azione Recupera elementi del set di dati .
  5. Usare l'output dell'ID set di dati predefinito del passaggio Esegui attore come parametro Dataset.
  6. Elaborare gli elementi restituiti nei passaggi successivi del flusso.

Flusso di lavoro basato su eventi: React per le esecuzioni completate

  1. Aggiungere il trigger Actor run finished come trigger del flusso.
  2. Selezionare l'attore da monitorare.
  3. Scegliere quali stati di completamento devono attivare il flusso (tutti abilitati per impostazione predefinita).
  4. Nei passaggi successivi usare il payload del trigger per accedere ai dettagli dell'esecuzione e recuperare i risultati.

Flusso di lavoro di scrape rapido

  1. Aggiungere l'azione Url singolo Scrape .
  2. Immettere l'URL da eliminare.
  3. Selezionare un tipo di crawler (è consigliabile usare adaptive per la maggior parte dei siti).
  4. Usare il trigger o il polling dell'esecuzione dell'attore per ottenere i risultati.

Problemi noti e limitazioni

  • Il parametro Wait for Finish ha un massimo di 60 secondi. Per gli attori a esecuzione prolungata, usare il trigger Actor run finished anziché attendere.
  • Gli schemi del set di dati vengono dedotti dinamicamente da un elemento di esempio. Potrebbero non acquisire tutti i campi possibili se il set di dati contiene elementi con strutture variabili.
  • Gli schemi dei record dell'archivio chiave-valore vengono dedotti dal contenuto del record. I record binari (immagini, PDF) vengono restituiti as-is senza inferenza dello schema.
  • L'azione Scrape single URL usa un attore fisso (Web Scraper). Per scenari avanzati di scraping, usare Run Actor with a specialized Actor from Apify Store (Esegui attore con un attore specializzato da Apify Store).
  • Le opzioni di allocazione della memoria vanno da 128 MB a 32 GB. Iniziare con le impostazioni predefinite per ottimizzare i costi.

Errori e rimedi comuni

Error Rimedio
Impossibile eseguire l'autenticazione Assicurarsi di avere un account Apify attivo. Provare a rimuovere la connessione e crearne una nuova.
L'esecuzione dell'attore restituisce lo stato FAILED Controllare i log di esecuzione dell'attore in Apify Console per i messaggi di errore dettagliati. Verificare che l'input corrisponda al formato previsto dell'attore.
Il set di dati è vuoto al termine dell'esecuzione Verificare che l'esecuzione dell'attore sia stata completata con lo stato SUCCEEDED. La struttura del sito Web di destinazione potrebbe essere cambiata.
Timeout del flusso in attesa dell'attore Impostare "Wait for Finish" (Attendi fine) su 0 e usare il trigger "Actor run finished" (Esecuzione dell'attore completata) per gestire in modo asincrono Gli attori con esecuzione prolungata.
Trigger webhook non attivato Verificare che l'ID dell'attore o dell'attività sia corretto. Verificare che almeno uno stato dell'evento sia abilitato.

FAQ

Quanto costa Apify? Il connettore stesso è gratuito. Apify addebiti per l'utilizzo della piattaforma in base al tempo di calcolo e alle risorse utilizzate. Un livello gratuito con crediti mensili è incluso in ogni account. Per informazioni dettagliate, vedere apify.com/pricing.

Che cosa sono gli attori? Gli attori sono programmi cloud serverless eseguiti nella piattaforma Apify. Possono eseguire lo scraping Web, l'estrazione dei dati, l'automazione dell'intelligenza artificiale e altro ancora. Esplora più di 30.000 attori pronti all'apify.com/store.

Che cosa sono le attività? Le attività vengono salvate per Gli attori. Archiviano i valori di input predefiniti in modo da poter eseguire un attore con parametri preimpostati senza immetterli di nuovo ogni volta.

Azioni

Esegui attore

Esegue un attore e restituisce immediatamente senza attendere il completamento dell'esecuzione. Per attendere il completamento dell'esecuzione, usare il parametro di query waitForFinish.

Eseguire attività

Esegue un'attività Actor e restituisce immediatamente senza attendere il completamento dell'esecuzione. Per attendere il completamento dell'esecuzione, usare il parametro di query waitForFinish.

Ottenere gli elementi del set di dati

Recupera gli elementi da uno dei set di dati Apify con parametri di paginazione facoltativi.

Ottenere il record dell'archivio chiave-valore

Ottiene un valore archiviato nell'archivio chiave-valore in una chiave specifica.

Url singolo scrape

Elimina un singolo URL usando Web Scraper Actor. Questa azione avvia uno scarto asincrono e restituisce immediatamente i dettagli dell'esecuzione. Usare il trigger Actor run finished per elaborare i risultati al termine dello scrape.

Esegui attore

Esegue un attore e restituisce immediatamente senza attendere il completamento dell'esecuzione. Per attendere il completamento dell'esecuzione, usare il parametro di query waitForFinish.

Parametri

Nome Chiave Necessario Tipo Descrizione
Selezionare Attore da
actorScope True string

Selezionare l'origine da cui cercare Actors.

Attore/Attrice
actorId True string

Identificatore dell'attore da eseguire. Specificare l'ID attore.

Attendere fine (0-60 secondi)
waitForFinish integer

Attendere il completamento dell'esecuzione in secondi (0-60).

Timeout (secondi)
timeout integer

Timeout per l'esecuzione in secondi.

Costruire
build string

Compilazione dell'attore da eseguire (tag o numero di build). In genere è la più recente.

Memoria (MB)
memory integer

Limite di memoria in MB (potenza di 2, min 128).

object

Oggetto JSON non elaborato passato come INPUT all'attore.

Eseguire attività

Esegue un'attività Actor e restituisce immediatamente senza attendere il completamento dell'esecuzione. Per attendere il completamento dell'esecuzione, usare il parametro di query waitForFinish.

Parametri

Nome Chiave Necessario Tipo Descrizione
Task
taskId True string

Identificatore dell'attività da eseguire.

Attendere fine (0-60 secondi)
waitForFinish integer

Attendere il completamento dell'esecuzione in secondi (0-60).

Timeout (secondi)
timeout integer

Timeout per l'esecuzione in secondi.

Costruire
build string

Compilazione dell'attore da eseguire (tag o numero di build). In genere è la più recente.

Memoria (MB)
memory integer

Limite di memoria in MB (potenza di 2, min 128).

object

Oggetto JSON non elaborato per eseguire l'override dell'input predefinito dell'attività.

Ottenere gli elementi del set di dati

Recupera gli elementi da uno dei set di dati Apify con parametri di paginazione facoltativi.

Parametri

Nome Chiave Necessario Tipo Descrizione
Dataset
datasetId True string

Selezionare il set di dati da cui recuperare gli elementi.

Limit
limit integer

Numero massimo di elementi da restituire.

Offset
offset integer

Numero di elementi da ignorare dall'inizio dell'elenco.

Valori restituiti

Gli output di questa operazione sono dinamici.

Ottenere il record dell'archivio chiave-valore

Ottiene un valore archiviato nell'archivio chiave-valore in una chiave specifica.

Parametri

Nome Chiave Necessario Tipo Descrizione
Store
storeId True string

Selezionare l'archivio chiave-valore da cui recuperare il record.

Chiave
recordKey True string

Selezionare la chiave da cui recuperare il record.

Valori restituiti

Gli output di questa operazione sono dinamici.

Url singolo scrape

Elimina un singolo URL usando Web Scraper Actor. Questa azione avvia uno scarto asincrono e restituisce immediatamente i dettagli dell'esecuzione. Usare il trigger Actor run finished per elaborare i risultati al termine dello scrape.

Parametri

Nome Chiave Necessario Tipo Descrizione
URL di Scrape
url True string

URL completo della singola pagina da smanchiare. Deve essere un formato URL valido.

Tipo di crawler
crawler_type True string

Selezionare il motore di ricerca per indicizzazione da usare per lo smanchiamento della pagina.

Trigger

Attività attore completata

Crea un webhook per sottoscrivere gli eventi di esecuzione dell'attività Actor. Attiva quando l'esecuzione dell'attività Actor selezionata viene completata con uno stato specifico. Tutti gli stati sono abilitati per impostazione predefinita; vengono esclusi solo gli stati impostati in modo esplicito su false. Almeno uno stato deve rimanere abilitato.

Esecuzione dell'attore completata

Crea un webhook per sottoscrivere gli eventi di esecuzione actor. Attiva al termine dell'esecuzione dell'attore selezionato con uno stato specifico. Tutti gli stati sono abilitati per impostazione predefinita; vengono esclusi solo gli stati impostati in modo esplicito su false. Almeno uno stato deve rimanere abilitato.

Attività attore completata

Crea un webhook per sottoscrivere gli eventi di esecuzione dell'attività Actor. Attiva quando l'esecuzione dell'attività Actor selezionata viene completata con uno stato specifico. Tutti gli stati sono abilitati per impostazione predefinita; vengono esclusi solo gli stati impostati in modo esplicito su false. Almeno uno stato deve rimanere abilitato.

Parametri

Nome Chiave Necessario Tipo Descrizione
Stati
eventTypes array of string

Lo stato dell'esecuzione dell'attore viene attivato.

Task
actorTaskId True string

Selezionare l'attività Attore da monitorare per gli eventi.

Trigger all'esecuzione completata
onRunSucceeded boolean

Attivare quando l'esecuzione di un attore ha esito positivo. L'impostazione predefinita è true se non è impostata.

Trigger in esecuzione non riuscita
onRunFailed boolean

Trigger quando l'esecuzione di un attore ha esito negativo. L'impostazione predefinita è true se non è impostata.

Trigger al timeout dell'esecuzione
onRunTimedOut boolean

Attivare quando si verifica il timeout di un attore. L'impostazione predefinita è true se non è impostata.

Trigger in caso di interruzione dell'esecuzione
onRunAborted boolean

Attivare quando viene interrotta un'esecuzione actor. L'impostazione predefinita è true se non è impostata.

Valori restituiti

Payload dell'evento inviato dal webhook al termine dell'esecuzione di un attore.

Vedere il payload del webhook
WebhookPayloadSchema

Esecuzione dell'attore completata

Crea un webhook per sottoscrivere gli eventi di esecuzione actor. Attiva al termine dell'esecuzione dell'attore selezionato con uno stato specifico. Tutti gli stati sono abilitati per impostazione predefinita; vengono esclusi solo gli stati impostati in modo esplicito su false. Almeno uno stato deve rimanere abilitato.

Parametri

Nome Chiave Necessario Tipo Descrizione
Selezionare Attore da
actorScope True string

Selezionare l'origine da cui cercare Actors.

Stati
eventTypes array of string

Lo stato dell'esecuzione dell'attore viene attivato.

Attore/Attrice
actorId True string

Identificatore dell'attore da monitorare. Specificare l'ID attore.

Trigger all'esecuzione completata
onRunSucceeded boolean

Attivare quando l'esecuzione di un attore ha esito positivo. L'impostazione predefinita è true se non è impostata.

Trigger in esecuzione non riuscita
onRunFailed boolean

Trigger quando l'esecuzione di un attore ha esito negativo. L'impostazione predefinita è true se non è impostata.

Trigger al timeout dell'esecuzione
onRunTimedOut boolean

Attivare quando si verifica il timeout di un attore. L'impostazione predefinita è true se non è impostata.

Trigger in caso di interruzione dell'esecuzione
onRunAborted boolean

Attivare quando viene interrotta un'esecuzione actor. L'impostazione predefinita è true se non è impostata.

Valori restituiti

Payload dell'evento inviato dal webhook al termine dell'esecuzione di un attore.

Vedere il payload del webhook
WebhookPayloadSchema

Definizioni

ActorRunResponseSchema

Informazioni complete su un'esecuzione di Actor eseguita.

Nome Percorso Tipo Descrizione
ID esecuzione attore
id string

Identificatore univoco dell'esecuzione dell'attore.

ID attore
actId string

Identificatore univoco dell'attore eseguito.

ID utente
userId string

Identificatore univoco dell'utente proprietario dell'esecuzione actor.

ID attività Attore
actorTaskId string

Identificatore univoco dell'attività Actor (se l'esecuzione è stata avviata da un'attività).

Attività iniziali
startedAt date-time

Timestamp all'avvio dell'esecuzione dell'attore.

Completato all'indirizzo
finishedAt date-time

Timestamp al termine dell'esecuzione dell'attore.

Condizione
status string

Stato dell'esecuzione dell'attore ,ad esempio SUCCEEDED, FAILED, RUNNING, ABORTED.

Messaggio di stato
statusMessage string

Messaggio di stato dettagliato dall'esecuzione dell'attore, inclusi riepilogo dell'elaborazione e risultati.

Terminale messaggi di stato
isStatusMessageTerminal boolean

Indica se il messaggio di stato è terminale (finale) o può cambiare durante l'esecuzione.

Metadati
meta object

Metadati aggiuntivi sull'esecuzione dell'attore, incluse le informazioni sull'origine e sull'agente utente.

Informazioni sui prezzi
pricingInfo object

Informazioni dettagliate sui prezzi, tra cui il modello tariffario, gli eventi e la suddivisione dei costi.

Statistiche
stats object

Statistiche sulle prestazioni, tra cui runtime, utilizzo della memoria, utilizzo della CPU e traffico di rete.

Conteggi degli eventi addebitati
chargedEventCounts object

Conteggio degli eventi fatturabili che si sono verificati durante l'esecuzione dell'attore.

Opzioni
options object

Opzioni di configurazione usate per l'esecuzione dell'attore (memoria, timeout, versione di compilazione e così via).

ID compilazione
buildId string

Identificatore univoco della compilazione Actor usata per questa esecuzione.

Codice di uscita
exitCode number

Codice di uscita restituito dal processo Actor (0 indica l'esito positivo).

ID archivio chiave-valore predefinito
defaultKeyValueStoreId string

Identificatore univoco dell'archivio chiave-valore predefinito associato a questa esecuzione.

ID set di dati predefinito
defaultDatasetId string

Identificatore univoco del set di dati predefinito in cui l'attore ha archiviato i risultati.

ID coda richiesta predefinito
defaultRequestQueueId string

Identificatore univoco della coda di richieste predefinita usata dall'attore.

Numero di build
buildNumber string

Numero di build della versione actor usata per questa esecuzione.

URL del contenitore
containerUrl string

URL del contenitore in cui è stata eseguita l'esecuzione dell'attore.

Server contenitore pronto
isContainerServerReady boolean

Indica se il server contenitore è pronto e accessibile.

Nome del ramo Git
gitBranchName string

Nome del ramo Git usato per l'esecuzione dell'attore (se applicabile).

Totale utilizzo USD
usageTotalUsd number

Costo totale dell'attore eseguito in USD.

WebhookPayloadSchema

Payload dell'evento inviato dal webhook al termine dell'esecuzione di un attore.

Nome Percorso Tipo Descrizione
ID utente
userId string

ID dell'utente proprietario della risorsa associata all'evento.

createdAt
createdAt date-time

Timestamp in cui si è verificato l'evento.

eventType
eventType string

Tipo dell'evento che ha attivato il webhook, ad esempio ACTOR. ESEGUIRE. OPERAZIONE COMPLETATA).

actorId
eventData.actorId string

ID dell'attore che attiva.

actorRunId
eventData.actorRunId string

ID dell'esecuzione dell'attore specifica che ha attivato l'evento.

Risposta dell'esecuzione dell'attore
resource ActorRunResponseSchema

Informazioni complete su un'esecuzione di Actor eseguita.