Apify (előzetes verzió)

Az Apify webes kaparókat és AI-ügynököket futtat, kezeli az aktorokat és feladatokat, ütemezi és figyeli a futtatásokat, lekéri az adathalmazokat és az eredményeket, és elindítja a webhookokból származó folyamatokat. Lehetővé teszi a munkafolyamatokban a végpontok közötti adatgyűjtést, bővítést és automatizálást.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service Class Regions
Copilot Studio prémium Az összes Power Automate-régió, kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások Standard Az összes Logic Apps-régió , kivéve a következőket:
     - Azure Government-régiók
     - Azure China-régiók
     - Amerikai Védelmi Minisztérium (DoD)
Power Apps prémium Az összes Power Apps-régió , kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Power Automate prémium Az összes Power Automate-régió, kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Kapcsolat
Név Támogatás apify
URL https://apify.com/contact
Email support@apify.com
Összekötő metaadatai
Kiadó Apify
További információ az Apify-ról. https://docs.apify.com
Webhely https://apify.com
Adatvédelmi irányelvek https://apify.com/privacy-policy
Categories Adat; AI

Apify

Az Apify az AI-eszközök legnagyobb piactere. A Power Automate Apify-összekötője lehetővé teszi webes kaparók és AI-ügynökök (más néven Actors) futtatását, előre konfigurált feladatok végrehajtását, strukturált adatok lekérését adatkészletekből és kulcs-érték tárolókból, valamint automatizált munkafolyamatok aktiválását a feladatok befejezésekor. Az Apify Store-ban több mint 30 000 kész aktor érhető el a gyakori kaparási és automatizálási használati esetekhez.

Kiadó

Apify Technologies s.r.o.

Prerequisites

  • Apify-fiók – ingyenesen regisztrálhat a apify.com. A csomag tartalmazza a havi platform kreditekkel rendelkező ingyenes szintet.
  • OAuth 2.0-hitelesítés – az összekötő az Apify OAuth-folyamatán keresztül hitelesít. A végfelhasználók nem igényelnek API-jogkivonatokat vagy manuális hitelesítő adatokat.

Hitelesítő adatok lekérése

Az összekötő OAuth 2.0-hitelesítést használ. Amikor hozzáadja az Apify-összekötőt egy folyamathoz, és új kapcsolatot hoz létre, a rendszer automatikusan átirányítja az Apify-konzolra a hozzáférés engedélyezéséhez. Kövesse az alábbi lépéseket:

  1. A Power Automate folyamatba vegyen fel bármilyen Apify-műveletet vagy eseményindítót.
  2. Amikor a rendszer kéri, hogy hozzon létre egy kapcsolatot, kattintson a Bejelentkezés gombra.
  3. A rendszer átirányítja az Apify Konzol engedélyezési oldalára a következő helyen console.apify.com: .
  4. Ha nincs bejelentkezve az Apify szolgáltatásba, adja meg apify-fiókjának e-mail-címét és jelszavát (vagy használja a Google/GitHub bejelentkezést).
  5. Tekintse át a kért engedélyeket:
    • profil – hozzáférés a felhasználói profil adataihoz
    • full_api_access – teljes hozzáférés az Apify API-hoz az Ön nevében
  6. Kattintson az Engedélyezés gombra az összekötő hozzáférésének megadásához.
  7. A rendszer visszairányítja az aktív kapcsolattal rendelkező Power Automate.

A végfelhasználóknak nincs szükség az API-jogkivonatok, ügyfélazonosítók vagy titkos kódok manuális bevitelére. Az összekötő automatikusan kezeli a jogkivonatok frissítését.

A Microsoft minősítés-felülvizsgálati csapat számára

Az összekötő teszteléséhez apify-fiókra lesz szüksége. A apify.com ingyenesen létrehozhat egyet – nincs szükség hitelkártyára. Az ingyenes szint elegendő platform kreditet tartalmaz a tesztaktorok futtatásához és az összes összekötőművelet ellenőrzéséhez. A fiók létrehozása után kövesse a fenti 1–7. lépést az összekötő engedélyezéséhez.

Támogatott műveletek

Műveletek

Operation Leírás
Az aktor futtatása Egy Apify-szereplőt futtat a megadott bemenettel. Választhat a legutóbb használt aktorok közül, vagy tallózhat az Apify Store-ban. Igény szerint akár 60 másodpercet is várjon, amíg a futtatás befejeződik. Futtatott metaadatokat ad vissza, beleértve az állapotot, az adatkészlet azonosítóját és a kulcs-érték tároló azonosítóját.
Feladat futtatása Előre konfigurált Aktor-feladatot futtat. A feladatok az alapértelmezett bemeneti konfigurációkat tárolják, így minden alkalommal anélkül hajthatja végre őket, hogy minden alkalommal megadnál bemenetet. Igény szerint felülbírálhatja az alapértelmezett bemenetet egyéni értékekkel.
Egyetlen URL-cím lekaparése Egyetlen weblapot kapar az Apify Web Scraper Actor használatával. Válasszon az adaptív (ajánlott), a Firefox fej nélküli böngésző vagy a Cheerio (nyers HTTP) bejárási módok közül. A nyomkövetéshez használt futtatási metaadatokat adja vissza.
Adathalmazelemek lekérése Elemeket kér le egy Apify-adatkészletből. Az adatkészletek az Actor-futtatások strukturált eredményeit tárolják. Támogatja a lapozást korlát- és eltolási paraméterekkel. A válaszséma dinamikusan következtet az adathalmaz tartalmára.
Kulcs-érték tároló rekord lekérése Lekéri a rekordot egy Apify kulcs-érték tárolóból a kulcsával. A kulcs-érték tárolók fájlokat, konfigurációkat és futtatási állapotot tárolnak. A válaszséma dinamikusan következtet a rekord tartalmára.

Triggers

Operation Leírás
A színész futtatása befejeződött A kijelölt Aktor futásának befejezésekor aktiválódik. Feliratkozás adott befejezési állapotokra: sikeres, sikertelen, időtúllépés vagy megszakítás. Alapértelmezés szerint minden állapot engedélyezve van. Az eseményindító hasznos adatai teljes körű futtatási adatokat és metaadatokat tartalmaznak.
A színészi tevékenység befejeződött A kijelölt Aktor tevékenységfuttatásának befejeződésekor aktiválódik. Ugyanazok az állapotszűrési beállítások, mint az Aktor futtatása befejeződött eseményindítóval. Az ütemezett vagy ismétlődő feladatvégrehajtások figyeléséhez hasznos.

Kezdő lépések

Alapszintű munkafolyamat: Aktor futtatása és eredmények lekérése

  1. Adja hozzá a Run Actor műveletet a folyamathoz.
  2. Válasszon egy színészt a legutóbb használt Actors vagy az Apify Store áruházból.
  3. Adja meg az Aktor által igényelt bemeneti JSON-t.
  4. Adja hozzá az Adathalmazelemek lekérése műveletet.
  5. Az Adathalmaz paraméterként használja a Futtató szereplő lépés alapértelmezett adathalmaz-azonosító kimenetét.
  6. A visszaadott elemek feldolgozása a következő folyamatlépésekben.

Eseményvezérelt munkafolyamat: Reagálás a befejezett futtatásokra

  1. Adja hozzá az Actor run finished triggert a folyamat eseményindítójaként.
  2. Válassza ki a figyelni kívánt színészt.
  3. Válassza ki, hogy mely befejezési állapotok aktiválják a folyamatot (alapértelmezés szerint mindegyik engedélyezve van).
  4. A következő lépésekben használja az eseményindító hasznos adatait a futtatási adatok eléréséhez és az eredmények lekéréséhez.

Gyors kaparás munkafolyamat

  1. Adja hozzá a Kaparás egyetlen URL-műveletet .
  2. Adja meg a kaparni kívánt URL-címet.
  3. Válasszon bejárótípust (a legtöbb webhely esetében az Adaptive használata ajánlott).
  4. Az eredmények lekéréséhez használja az Aktor futása befejezett eseményindítót vagy a befejezési lekérdezést.

Ismert problémák és korlátozások

  • A Várakozás befejezésre paraméter legfeljebb 60 másodpercet vehet igénybe. Hosszú ideig futó Actors esetén a várakozás helyett használja az Aktor futtatása kész eseményindítót.
  • Az adathalmaz sémái dinamikusan következtetnek egy mintaelemből. Előfordulhat, hogy nem rögzítik az összes lehetséges mezőt, ha az adathalmaz különböző szerkezetű elemeket tartalmaz.
  • A kulcs-érték tároló rekordsémái a rekord tartalmából következtetnek. A bináris rekordok (képek, PDF-fájlok) sémakövetkeztetés nélkül as-is lesznek visszaadva.
  • A Kaparás egyetlen URL-művelet rögzített aktort (Web Scraper) használ. Speciális kaparási forgatókönyvek esetén használja a Run Actort egy speciális aktorral az Apify Store-ból.
  • A memóriafoglalási lehetőségek 128 MB és 32 GB között mozognak. Kezdje az alapértelmezett beállításokkal a költségek optimalizálásához.

Gyakori hibák és jogorvoslatok

Hiba Orvoslat
Nem lehet hitelesíteni Győződjön meg arról, hogy rendelkezik aktív Apify-fiókkal. Próbálja meg eltávolítani a kapcsolatot, és hozzon létre egy újat.
Az aktor futása SIKERTELEN állapotot ad vissza A részletes hibaüzenetekért tekintse meg az Aktor futtatási naplóit az Apify Console-ban. Ellenőrizze, hogy a bemenet megfelel-e az Aktor várt formátumának.
Az adatkészlet a futtatás befejezése után üres Győződjön meg arról, hogy az Aktor futtatása sikeresen befejeződött. Előfordulhat, hogy a célweboldal struktúrája megváltozott.
A folyamat időtúllépése az Aktorra várva Állítsa a "Várakozás a befejezésre" értéket 0 értékre, és használja a "Actor run finished" eseményindítót a hosszan futó Actors aszinkron kezeléséhez.
A Webhook-eseményindító nem aktiválódik Ellenőrizze, hogy az Aktor vagy a tevékenységazonosító helyes-e. Ellenőrizze, hogy legalább egy esemény állapota engedélyezve van-e.

GYIK

Mennyibe kerül az Apify? Maga az összekötő ingyenes. A platformhasználat díjainak apififify based based compute time and resources consumeed. Minden fiókhoz tartozik egy ingyenes, havi kreditekkel rendelkező szint. Részletekért lásd a apify.com/pricing .

Mik azok az Actors? A szereplők kiszolgáló nélküli felhőprogramok, amelyek az Apify platformon futnak. Webkaparást, adatkinyerést, AI-automatizálást és egyebeket is végrehajthatnak. Böngésszen több mint 30 000 kész színész között a apify.com/store.

Mik azok a tevékenységek? A feladatok az Actors-hez mentett konfigurációk. Ezek az alapértelmezett bemeneti értékeket tárolják, így előre beállított paraméterekkel futtathatók az aktorok anélkül, hogy minden alkalommal újra beírták őket.

Műveletek

Adathalmazelemek lekérése

Az Egyik Apify-adatkészlet elemeit kéri le opcionális lapozási paraméterekkel.

Az aktor futtatása

Futtat egy színészt, és azonnal visszatér anélkül, hogy várnia kell a futtatás befejezésére. A futtatás befejezéséhez használja a waitForFinish lekérdezési paramétert.

Egyetlen URL-cím lekaparése

Egyetlen URL-cím lekaparása a Web Scraper Actor használatával. Ez a művelet aszinkron kaparást indít el, és azonnal visszaadja a futtatás részleteit. Az Aktor futása kész eseményindítóval feldolgozhatja az eredményeket, ha a kaparás befejeződött.

Feladat futtatása

Egy Aktor-feladatot futtat, és azonnal visszatér anélkül, hogy megvárja a futtatás befejezését. A futtatás befejezéséhez használja a waitForFinish lekérdezési paramétert.

Kulcs-érték tároló rekord lekérése

Lekéri a kulcs-érték tárolóban tárolt értéket egy adott kulcs alatt.

Adathalmazelemek lekérése

Az Egyik Apify-adatkészlet elemeit kéri le opcionális lapozási paraméterekkel.

Paraméterek

Név Kulcs Kötelező Típus Description
Dataset
datasetId True string

Válassza ki azt az adatkészletet, amelyből elemeket szeretne lekérni.

Limit
limit integer

A visszaadandó elemek maximális száma.

Offset
offset integer

A lista elejéről kihagyandó elemek száma.

Válaszok

Ennek a műveletnek a kimenetei dinamikusak.

Az aktor futtatása

Futtat egy színészt, és azonnal visszatér anélkül, hogy várnia kell a futtatás befejezésére. A futtatás befejezéséhez használja a waitForFinish lekérdezési paramétert.

Paraméterek

Név Kulcs Kötelező Típus Description
Az Aktor kiválasztása innen:
actorScope True string

Válassza ki a forrást az Actorsben való kereséshez.

Actor
actorId True string

A futtatandó aktorazonosító. Adja meg az aktor azonosítóját.

Várakozás a befejezésre (0-60 másodperc)
waitForFinish integer

Várjon, amíg a futtatás másodpercben befejeződik (0-60).

Időtúllépés (másodperc)
timeout integer

A futtatás időtúllépése másodpercben.

Build
build string

Az aktor buildelése futtatható (címke vagy buildszám). Általában ez a "legújabb".

Memória (MB)
memory integer

Memóriakorlát MB-ban (teljesítmény: 2, min 128).

object

A nyers JSON-objektum bemenetként lett átadva az Aktornak.

Egyetlen URL-cím lekaparése

Egyetlen URL-cím lekaparása a Web Scraper Actor használatával. Ez a művelet aszinkron kaparást indít el, és azonnal visszaadja a futtatás részleteit. Az Aktor futása kész eseményindítóval feldolgozhatja az eredményeket, ha a kaparás befejeződött.

Paraméterek

Név Kulcs Kötelező Típus Description
A kaparás URL-címe
url True string

A lekaparni kívánt oldal teljes URL-címe. Érvényes URL-formátumnak kell lennie.

Bejáró típusa
crawler_type True string

Válassza ki az oldal kaparásához használni kívánt bejárási motort.

Feladat futtatása

Egy Aktor-feladatot futtat, és azonnal visszatér anélkül, hogy megvárja a futtatás befejezését. A futtatás befejezéséhez használja a waitForFinish lekérdezési paramétert.

Paraméterek

Név Kulcs Kötelező Típus Description
Task
taskId True string

Futtatandó feladatazonosító.

Várakozás a befejezésre (0-60 másodperc)
waitForFinish integer

Várjon, amíg a futtatás másodpercben befejeződik (0-60).

Időtúllépés (másodperc)
timeout integer

A futtatás időtúllépése másodpercben.

Build
build string

Az aktor buildelése futtatható (címke vagy buildszám). Általában ez a "legújabb".

Memória (MB)
memory integer

Memóriakorlát MB-ban (teljesítmény: 2, min 128).

object

Egy nyers JSON-objektum, amely felülbírálja a tevékenység alapértelmezett bemenetét.

Kulcs-érték tároló rekord lekérése

Lekéri a kulcs-érték tárolóban tárolt értéket egy adott kulcs alatt.

Paraméterek

Név Kulcs Kötelező Típus Description
Store
storeId True string

Válassza ki azt a kulcs-érték tárolót, amelyből le szeretné kérni a rekordot.

Kulcs
recordKey True string

Válassza ki azt a kulcsot, amelyből le szeretné kérni a rekordot.

Válaszok

Ennek a műveletnek a kimenetei dinamikusak.

Triggerek

A színész futtatása befejeződött

Létrehoz egy webhookot, amely feliratkozik az Aktor-futtatási eseményekre. Eseményindítók, amikor a kijelölt Aktor-futtatás egy adott állapottal fejeződik be. Alapértelmezés szerint minden állapot engedélyezve van; csak a kifejezetten hamisra beállított állapotok lesznek kizárva. Legalább egy állapotnak engedélyezve kell maradnia.

A színészi tevékenység befejeződött

Létrehoz egy webhookot, amely feliratkozik az Actor tevékenységfuttatási eseményeire. Eseményindítók, amikor a kijelölt Aktor tevékenység futtatása egy adott állapottal fejeződik be. Alapértelmezés szerint minden állapot engedélyezve van; csak a kifejezetten hamisra beállított állapotok lesznek kizárva. Legalább egy állapotnak engedélyezve kell maradnia.

A színész futtatása befejeződött

Létrehoz egy webhookot, amely feliratkozik az Aktor-futtatási eseményekre. Eseményindítók, amikor a kijelölt Aktor-futtatás egy adott állapottal fejeződik be. Alapértelmezés szerint minden állapot engedélyezve van; csak a kifejezetten hamisra beállított állapotok lesznek kizárva. Legalább egy állapotnak engedélyezve kell maradnia.

Paraméterek

Név Kulcs Kötelező Típus Description
Az Aktor kiválasztása innen:
actorScope True string

Válassza ki a forrást az Actorsben való kereséshez.

Állapotok
eventTypes array of string

Az aktor futási állapotai aktiválhatók.

Actor
actorId True string

Figyelendő aktorazonosító. Adja meg az aktor azonosítóját.

A futtatáskor aktivált eseményindító sikeres
onRunSucceeded boolean

Eseményindító, ha egy színész futtatása sikeres. Alapértelmezés szerint igaz, ha nincs beállítva.

A futtatáskor futó eseményindító sikertelen
onRunFailed boolean

Eseményindító, ha egy színész futtatása meghiúsul. Alapértelmezés szerint igaz, ha nincs beállítva.

Eseményindító futás közben – időtúllépés
onRunTimedOut boolean

Eseményindító, ha egy színész elfogy. Alapértelmezés szerint igaz, ha nincs beállítva.

Eseményindító megszakítva a futtatáskor
onRunAborted boolean

Eseményindító, ha egy Aktor futtatása megszakadt. Alapértelmezés szerint igaz, ha nincs beállítva.

Válaszok

A webhook által küldött esemény hasznos adatai, amikor egy Aktor futása befejeződik.

Webhook betöltött adatai
WebhookPayloadSchema

A színészi tevékenység befejeződött

Létrehoz egy webhookot, amely feliratkozik az Actor tevékenységfuttatási eseményeire. Eseményindítók, amikor a kijelölt Aktor tevékenység futtatása egy adott állapottal fejeződik be. Alapértelmezés szerint minden állapot engedélyezve van; csak a kifejezetten hamisra beállított állapotok lesznek kizárva. Legalább egy állapotnak engedélyezve kell maradnia.

Paraméterek

Név Kulcs Kötelező Típus Description
Állapotok
eventTypes array of string

Az aktor futási állapotai aktiválhatók.

Task
actorTaskId True string

Válassza ki az események figyeléséhez szükséges Aktor feladatot.

A futtatáskor aktivált eseményindító sikeres
onRunSucceeded boolean

Eseményindító, ha egy színész futtatása sikeres. Alapértelmezés szerint igaz, ha nincs beállítva.

A futtatáskor futó eseményindító sikertelen
onRunFailed boolean

Eseményindító, ha egy színész futtatása meghiúsul. Alapértelmezés szerint igaz, ha nincs beállítva.

Eseményindító futás közben – időtúllépés
onRunTimedOut boolean

Eseményindító, ha egy színész elfogy. Alapértelmezés szerint igaz, ha nincs beállítva.

Eseményindító megszakítva a futtatáskor
onRunAborted boolean

Eseményindító, ha egy Aktor futtatása megszakadt. Alapértelmezés szerint igaz, ha nincs beállítva.

Válaszok

A webhook által küldött esemény hasznos adatai, amikor egy Aktor futása befejeződik.

Webhook betöltött adatai
WebhookPayloadSchema

Definíciók

ActorRunResponseSchema

Teljes körű információ egy végrehajtott Aktor-futtatásról.

Név Elérési út Típus Description
Aktor futtatási azonosítója
id string

Az Actor run egyedi azonosítója.

Színész azonosítója
actId string

A végrehajtott Aktor egyedi azonosítója.

Felhasználói azonosító
userId string

Az Aktor futtatás tulajdonosának egyedi azonosítója.

Aktor tevékenységazonosítója
actorTaskId string

Az Aktor tevékenység egyedi azonosítója (ha a futtatás egy tevékenységből indult).

Első lépések:
startedAt date-time

Időbélyeg, amikor az Aktor futtatása elindult.

Befejezve:
finishedAt date-time

Időbélyeg, amikor az Aktor futtatása befejeződött.

Status
status string

Az Aktor futásának állapota (pl. SIKERES, SIKERTELEN, FUTTATÁS, MEGSZAKÍTVA).

Állapotüzenet
statusMessage string

Az Aktor futtatásának részletes állapotüzenete, beleértve az összegzés és az eredmények feldolgozását.

Állapotüzenet terminálja
isStatusMessageTerminal boolean

Az állapotüzenet terminál (végleges) vagy a futtatás során változhat.

Metadaták
meta object

Az Aktor futtatásával kapcsolatos további metaadatok, beleértve a forrás- és a felhasználói ügynök adatait.

Díjszabási információk
pricingInfo object

Részletes díjszabási információk, beleértve a díjszabási modellt, az eseményeket és a költséglebontást.

Statisztikák
stats object

Teljesítménystatisztikák, beleértve a futtatókörnyezetet, a memóriahasználatot, a processzorhasználatot és a hálózati forgalmat.

Feltöltött események száma
chargedEventCounts object

Az Aktor futtatása során történt számlázható események száma.

Beállítások
options object

Az Aktor futtatásához használt konfigurációs beállítások (memória, időtúllépés, buildverzió stb.).

Buildazonosító
buildId string

A futtatáshoz használt Actor-build egyedi azonosítója.

Kilépési kód
exitCode number

Az Aktor folyamat által visszaadott kilépési kód (a 0 a sikerességet jelzi).

Kulcs-érték tároló alapértelmezett azonosítója
defaultKeyValueStoreId string

A futtatáshoz társított alapértelmezett kulcs-érték tároló egyedi azonosítója.

Alapértelmezett adathalmaz-azonosító
defaultDatasetId string

Annak az alapértelmezett adatkészletnek az egyedi azonosítója, amelyben az Aktor tárolta az eredményeket.

Alapértelmezett kéréssor-azonosító
defaultRequestQueueId string

Az Aktor által használt alapértelmezett kérelemsor egyedi azonosítója.

Verziószám
buildNumber string

A futtatáshoz használt Aktor verzió buildszáma.

Tároló URL-címe
containerUrl string

Annak a tárolónak az URL-címe, amelyen az Aktor futtatása le lett hajtva.

Készen áll a tárolókiszolgáló?
isContainerServerReady boolean

A tárolókiszolgáló készen áll-e és elérhető-e.

Git-ág neve
gitBranchName string

Az Aktor futtatásához használt Git-ág neve (ha van).

Használat összesen USD
usageTotalUsd number

Az Aktor teljes költsége USD-ben fut.

WebhookPayloadSchema

A webhook által küldött esemény hasznos adatai, amikor egy Aktor futása befejeződik.

Név Elérési út Típus Description
userId
userId string

Az eseményhez társított erőforrás tulajdonosának azonosítója.

createdAt
createdAt date-time

Az esemény bekövetkezésének időbélyege.

eventType
eventType string

A webhookot kiváltó esemény típusa (pl. ACTOR). FUTTATÁS. SIKERES VOLT).

actorId
eventData.actorId string

Az eseményindító aktor azonosítója.

actorRunId
eventData.actorRunId string

Az eseményt kiváltó adott actor-futtatás azonosítója.

Aktor futtatási válasza
resource ActorRunResponseSchema

Teljes körű információ egy végrehajtott Aktor-futtatásról.