Integrasi Apify

Oleh Ai Flowi · Diterbitkan 2026-10-11

Sumber rasmi: dokumentasi Apify

Integrasi Apify menggunakan Apify Actors untuk mendapatkan data dalam aliran AI Flowi Workflow atau menyediakan Actor sebagai alat ejen. Masukkan kelayakan Apify anda sendiri, pilih pengecam Actor dan sediakan input untuk Actor tersebut. Periksa output JSON sebelum menukar item yang dikumpulkan kepada baris hamparan.

Apify Actors didokumenkan dalam katalog; belum diuji dalam persekitaran pengeluaran oleh Ai Flowi. Katalog menyatakan dengan jelas bahawa komponen ini boleh digunakan dalam aliran untuk mendapatkan data atau sebagai alat bersama ejen. Persediaan di sini ialah contoh konfigurasi, bukan ujian yang direkodkan.

1. Mulakan dengan kontrak satu Actor

Anda memerlukan akaun dan token Apify sendiri, akses kepada Actor yang dipilih serta kebenaran untuk mengumpulkan bahan sasaran. Actors mempunyai tujuan dan struktur input yang berbeza, jadi mulakan dengan Actor yang telah anda semak dan jangan menganggap satu muatan pengikisan umum sesuai untuk semua keadaan.

Kenal pasti input pelaksanaan yang diperlukan oleh Actor, medan set data yang dijangkakan serta laman web atau sumber lain yang akan diaksesnya. Gunakan sumber yang anda dibenarkan periksa. Kelayakan untuk komponen Apify tidak memberikan kebenaran untuk memintas kawalan akses laman sasaran atau mengedarkan data sulitnya.

Hab aliran kerja sedia ada menyebut titik permulaan ejen berasaskan Apify; penyenaraian itu bukan ujian pelaksanaan Actor pilihan anda. Halaman ini menambah tetapan komponen secara langsung dan keputusan pemetaan baris. Gunakan katalog komponen untuk mengesahkan antara muka sebelum mereka bentuk graf yang lebih besar.

2. Tetapkan lima input komponen

Tiga input ditandakan sebagai wajib: actor_id, apify_token dan run_input. Dua kawalan set data adalah pilihan; nilai lalai dan peraturan penghuraian tepatnya tidak disertakan dalam eksport.

3. Sediakan input pelaksanaan tanpa mereka-reka skema Actor

run_input berjenis rentetan dan menerima Message. Katalog tidak memberikan senarai kunci JSON yang bebas daripada Actor, format URL permulaan atau had pelaksanaan. Dapatkan input kecil yang sah daripada Actor pilihan anda dan simpan dalam konfigurasi ujian sulit.

Jika Actor tersebut menjangkakan JSON yang dikodkan sebagai rentetan, sahkan JSON sebelum menghantarnya. Bezakan data yang dijangkakan oleh Actor daripada tetapan kelayakan dan set data komponen: meletakkan apify_token dalam muatan Actor yang direka-reka tidak menggantikan pengisian medan komponen wajib.

Untuk pemeriksaan pertama, minta jumlah data sintetik atau data yang dibenarkan yang boleh anda periksa sepenuhnya. Tentukan maksud penyelesaian dan tempat anda akan memeriksa pelaksanaan Actor sebenar. Medan komponen yang dieksport tidak mendokumenkan tingkah laku peninjauan berkala, pembatalan, tamat masa atau percubaan semula.

4. Konfigurasikan laluan pengambilan secara langsung

1. Tambahkan Apify Actors. Tetapkan actor_id kepada Actor yang disahkan, masukkan kelayakan anda dalam apify_token, dan tetapkan run_input berdasarkan kontraknya yang telah disemak.
2. Pada peringkat awal, jangan meneka dataset_fields. Periksa contoh sintetik tanpa sekatan medan jika Actor dan dasar akses anda membenarkannya, kemudian pilih medan yang diperlukan untuk destinasi menggunakan sintaks yang disahkan dalam editor.
3. Pilih flatten_dataset secara jelas. Bandingkan struktur medan yang terhasil sebelum menganggap setiap rekod bersarang menjadi satu baris.
4. Periksa port JSON output. Cari koleksi item sebenar dan medan rujukan sumber yang tersedia; kunci tatasusunan mahupun skema set data tetap tidak diterbitkan dalam katalog.
5. Semak keadaan pelaksanaan dan output di pihak penyedia. Jangan anggap kewujudan nilai JSON sebagai bukti bahawa setiap item sumber telah dikumpulkan atau setiap medan yang diminta telah diisi.
6. Sediakan unjuran medan yang terhad untuk destinasi hanya selepas mengesahkan struktur contoh. Jangan simpan medan peribadi atau sulit yang tidak berkaitan dalam storan hiliran.

5. Petakan hasil yang diperiksa kepada baris hamparan

Pemetaan baris bermula dengan struktur item yang diperhatikan, bukannya kunci items yang diteka. Tentukan medan yang mewakili label item, URL sumber dan nilai lain yang dibenarkan. Kemudian takrifkan satu baris bagi setiap item yang dipilih dan kendalikan nilai yang tiada secara jelas.

Untuk melanjutkan contoh ini ke hamparan, Append Rows menerima values sebagai Data atau JSON. Tetapkan google_account, spreadsheet_id dan range_name untuk hamparan ujian anda sendiri. Pilih value_input_option dengan sengaja; "RAW" ialah pilihan katalog untuk disiasat apabila hasil yang dikehendaki ialah nilai yang dikumpulkan tanpa ditafsirkan semula. Sahkan input yang menyerupai formula sebelum bergantung pada tingkah laku itu.

Ini ialah reka bentuk destinasi pilihan, tanpa dakwaan bilangan ujian Apify ke Sheets yang lulus. Sambungan JSON antara output Apify dengan pemproses yang serasi dengan Data/JSON hanya mengesahkan jenis. Sahkan unjuran item dan susunan baris sebelum memasukkan values; jangan menganggap seluruh respons JSON Actor sudah merupakan kelompok baris yang boleh diterima.

Periksa nilai sintetik yang menyerupai formula, serta data bersarang dan medan yang tiada. Teliti sel yang ditulis bersama output sumber. Anggap “satu item menjadi satu baris” sebagai pemetaan yang perlu anda sahkan, bukannya janji daripada flatten_dataset.

Output Tool ialah pilihan reka bentuk yang berasingan

Apify Actors turut mengeksport tool dengan jenis Tool. Sambungan alat ejen menyerahkan penggunaan Actor kepada ejen yang dikonfigurasi; ia tidak menghantar JSON set data ke hamparan. Tentukan sama ada penyerahan itu diperlukan sebelum menambahkan model dan ejen pada tugas yang boleh dilaksanakan terus oleh Actor.

Untuk penggunaan ejen, semak input yang dibenarkan, kebenaran penyedia dan medan yang dikembalikan yang boleh dilihat oleh model. Actor yang sesuai untuk pengambilan manual tidak semestinya sesuai untuk panggilan alat tanpa sekatan.

Apakah batasan komponen Apify dan keadaan yang perlu dielakkan?

Komponen ini bukan bukti kewujudan pengikis sejagat atau aliran kerja pengekstrakan maklumat hubungan yang berjaya. Ketersediaan Actor, bentuk output dan peraturan laman sasaran berbeza-beza. Eksport tidak mempunyai spesifikasi paginasi hasil, tatabahasa medan set data yang lengkap atau kawalan pencegahan pendua, jadi pelaksanaan berulang mungkin memerlukan penyelarasan berasingan.

Elakkan laluan ini apabila API sumber yang telah disemak atau eksport sedia ada sudah menyediakan data, apabila kebenaran pengumpulan tidak jelas, atau apabila aliran kerja tidak dapat mengendalikan perubahan medan. Untuk pengambilan daripada kandungan yang disediakan selepas pengumpulan, bandingkan Pinecone dan PGVector sebagai peringkat penyimpanan berasingan dan jangan menganggap Apify mencipta indeks tersebut.

Penggunaan dan perkhidmatan berkaitan

Setiap pelaksanaan nod menggunakan 1 Flowi Token. Token yang disertakan setiap bulan: Go 5,000; Plus 10,000; Pro 100 50,000; Pro 200 100,000; Pro 500 250,000. Tempah demo