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 |
| 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:
- Nel flusso di Power Automate aggiungere qualsiasi azione o trigger apify.
- Quando viene richiesto di creare una connessione, fare clic su Accedi.
- Si verrà reindirizzati alla pagina di autorizzazione di Apify Console all'indirizzo
console.apify.com. - Se non si è connessi ad Apify, immettere l'indirizzo di posta elettronica e la password dell'account Apify (o usare Google/GitHub l'accesso).
- Esaminare le autorizzazioni richieste:
- profile : accesso alle informazioni del profilo utente
- full_api_access : accesso completo all'API Apify per conto dell'utente
- Fare clic su Autorizza per concedere l'accesso al connettore.
- 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
- Aggiungere l'azione Esegui attore al flusso.
- Selezionare un attore dagli attori usati di recente o da Apify Store.
- Specificare il codice JSON di input richiesto dall'attore.
- Aggiungere l'azione Recupera elementi del set di dati .
- Usare l'output dell'ID set di dati predefinito del passaggio Esegui attore come parametro Dataset.
- Elaborare gli elementi restituiti nei passaggi successivi del flusso.
Flusso di lavoro basato su eventi: React per le esecuzioni completate
- Aggiungere il trigger Actor run finished come trigger del flusso.
- Selezionare l'attore da monitorare.
- Scegliere quali stati di completamento devono attivare il flusso (tutti abilitati per impostazione predefinita).
- Nei passaggi successivi usare il payload del trigger per accedere ai dettagli dell'esecuzione e recuperare i risultati.
Flusso di lavoro di scrape rapido
- Aggiungere l'azione Url singolo Scrape .
- Immettere l'URL da eliminare.
- Selezionare un tipo di crawler (è consigliabile usare adaptive per la maggior parte dei siti).
- 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.
Collegamenti utili
- Documentazione di Apify
- Informazioni di riferimento sulle API Apify
- Apify Store - Esplora attori
- Prezzi di Apify
- Supporto e contatto
- Forum della community
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
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
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. |