mirror of
https://github.com/simstudioai/sim.git
synced 2026-02-10 14:45:16 -05:00
89 lines
5.3 KiB
Plaintext
89 lines
5.3 KiB
Plaintext
---
|
||
title: Apify
|
||
description: Apifyアクターを実行して結果を取得する
|
||
---
|
||
|
||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||
|
||
<BlockInfoCard
|
||
type="apify"
|
||
color="#E0E0E0"
|
||
/>
|
||
|
||
{/* MANUAL-CONTENT-START:intro */}
|
||
[Apify](https://apify.com/)は、WebオートメーションとWebスクレイピングアクターを構築、デプロイ、大規模に実行するための強力なプラットフォームです。Apifyを使用すると、任意のWebサイトから有用なデータを抽出し、ワークフローを自動化し、データパイプラインをシームレスに接続できます。
|
||
|
||
Apifyでは以下のことが可能です：
|
||
|
||
- **既製または独自のアクターを実行する**：公開アクターを統合するか、独自のアクターを開発して、幅広いWebデータ抽出とブラウザタスクを自動化します。
|
||
- **データセットを取得する**：アクターによって収集された構造化データセットにリアルタイムでアクセスし管理します。
|
||
- **Webオートメーションをスケールする**：クラウドインフラストラクチャを活用して、堅牢なエラー処理を備えた同期または非同期のタスクを確実に実行します。
|
||
|
||
Simでは、Apify統合によりエージェントがプログラムでApifyの主要な操作を実行できます：
|
||
|
||
- **アクターの実行（同期）**：`apify_run_actor_sync`を使用してApifyアクターを起動し、完了を待って、実行が終了するとすぐに結果を取得します。
|
||
- **アクターの実行（非同期）**：`apify_run_actor_async`を使用してバックグラウンドでアクターを開始し、定期的に結果をポーリングします。これは長時間または複雑なジョブに適しています。
|
||
|
||
これらの操作により、エージェントはワークフロー内で直接、自動化、スクレイピング、データ収集またはブラウザ自動化タスクのオーケストレーションを行うことができます — すべて柔軟な構成と結果処理を備え、手動実行や外部ツールを必要としません。Apifyを動的な自動化およびデータ抽出エンジンとして統合し、プログラムでエージェントのWebスケールワークフローを強化します。
|
||
{/* MANUAL-CONTENT-END */}
|
||
|
||
## 使用方法
|
||
|
||
Apifyをワークフローに統合します。カスタム入力で任意のApifyアクターを実行し、結果を取得します。自動データセット取得機能を備えた同期および非同期実行の両方をサポートしています。
|
||
|
||
## ツール
|
||
|
||
### `apify_run_actor_sync`
|
||
|
||
APIPYアクターを同期的に実行して結果を取得（最大5分）
|
||
|
||
#### 入力
|
||
|
||
| パラメータ | 型 | 必須 | 説明 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `apiKey` | string | はい | console.apify.com/account#/integrationsから取得したAPIFY APIトークン |
|
||
| `actorId` | string | はい | アクターIDまたはユーザー名/アクター名（例："janedoe/my-actor"またはアクターID） |
|
||
| `input` | string | いいえ | JSON文字列としてのアクター入力。必須フィールドについてはアクターのドキュメントを参照してください。 |
|
||
| `timeout` | number | いいえ | タイムアウト（秒）（デフォルト：アクターのデフォルト） |
|
||
| `build` | string | いいえ | 実行するアクタービルド（例："latest"、"beta"、またはビルドタグ/番号） |
|
||
|
||
#### 出力
|
||
|
||
| パラメータ | 型 | 説明 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | アクターの実行が成功したかどうか |
|
||
| `runId` | string | APIFY実行ID |
|
||
| `status` | string | 実行ステータス（SUCCEEDED、FAILED、など） |
|
||
| `items` | array | データセット項目（完了した場合） |
|
||
|
||
### `apify_run_actor_async`
|
||
|
||
長時間実行タスク用のポーリングを使用して、APIPYアクターを非同期で実行
|
||
|
||
#### 入力
|
||
|
||
| パラメータ | 型 | 必須 | 説明 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `apiKey` | string | はい | console.apify.com/account#/integrationsから取得したAPIFY APIトークン |
|
||
| `actorId` | string | はい | アクターIDまたはユーザー名/アクター名（例："janedoe/my-actor"またはアクターID） |
|
||
| `input` | string | いいえ | JSON文字列としてのアクター入力 |
|
||
| `waitForFinish` | number | いいえ | ポーリング開始前の初期待機時間（秒）（0-60） |
|
||
| `itemLimit` | number | いいえ | 取得する最大データセット項目数（1-250000、デフォルト100） |
|
||
| `timeout` | number | いいえ | タイムアウト（秒）（デフォルト：アクターのデフォルト） |
|
||
| `build` | string | いいえ | 実行するアクタービルド（例："latest"、"beta"、またはビルドタグ/番号） |
|
||
|
||
#### 出力
|
||
|
||
| パラメータ | 型 | 説明 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | アクターの実行が成功したかどうか |
|
||
| `runId` | string | APIFY実行ID |
|
||
| `status` | string | 実行ステータス（SUCCEEDED、FAILED、など） |
|
||
| `datasetId` | string | 結果を含むデータセットID |
|
||
| `items` | array | データセット項目（完了した場合） |
|
||
|
||
## 注意事項
|
||
|
||
- カテゴリー: `tools`
|
||
- タイプ: `apify`
|