mirror of
https://github.com/simstudioai/sim.git
synced 2026-02-09 14:14:57 -05:00
030ae5cc0a
* fix for asana and apify * fixed onedrive * fixed confluence error throwing and added upload file * fixed google vault tag dropdown and output * fix google group tag dropdown, var reference * fixed hubspot output * fixed pipedrive output * removed comments * removed more comments * consolidated file utils * fixed hubspot json schema * fix hubspot search tools * minor change
89 lines
4.0 KiB
Plaintext
89 lines
4.0 KiB
Plaintext
---
|
||
title: Apify
|
||
description: 运行 Apify actor 并获取结果
|
||
---
|
||
|
||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||
|
||
<BlockInfoCard
|
||
type="apify"
|
||
color="#E0E0E0"
|
||
/>
|
||
|
||
{/* MANUAL-CONTENT-START:intro */}
|
||
[Apify](https://apify.com/) 是一个强大的平台，用于大规模构建、部署和运行网页自动化和网页抓取 actor。Apify 使您能够从任何网站提取有用的数据，自动化工作流程，并无缝连接您的数据管道。
|
||
|
||
使用 Apify，您可以：
|
||
|
||
- **运行现成或自定义的 actor**：集成公共 actor 或开发您自己的，自动化各种网页数据提取和浏览器任务。
|
||
- **获取数据集**：实时访问和管理由 actor 收集的结构化数据集。
|
||
- **扩展网页自动化**：利用云基础设施可靠地运行任务，可以异步或同步运行，并具有强大的错误处理能力。
|
||
|
||
在 Sim 中，Apify 集成允许您的代理以编程方式执行核心 Apify 操作：
|
||
|
||
- **运行 Actor（同步）**：使用 `apify_run_actor_sync` 启动一个 Apify actor 并等待其完成，在运行结束后立即获取结果。
|
||
- **运行 Actor（异步）**：使用 `apify_run_actor_async` 在后台启动一个 actor 并定期轮询结果，适用于较长或复杂的任务。
|
||
|
||
这些操作使您的代理能够直接在工作流程中自动化、抓取和协调数据收集或浏览器自动化任务——所有这些都具有灵活的配置和结果处理，无需手动运行或外部工具。将 Apify 集成为一个动态的自动化和数据提取引擎，以编程方式为您的代理提供网页规模的工作流程支持。
|
||
{/* MANUAL-CONTENT-END */}
|
||
|
||
## 使用说明
|
||
|
||
将 Apify 集成到您的工作流程中。使用自定义输入运行任何 Apify actor 并获取结果。支持同步和异步执行，并自动获取数据集。
|
||
|
||
## 工具
|
||
|
||
### `apify_run_actor_sync`
|
||
|
||
同步运行 APIFY actor 并获取结果（最长 5 分钟）
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `apiKey` | string | 是 | 来自 console.apify.com/account#/integrations 的 APIFY API 令牌 |
|
||
| `actorId` | string | 是 | Actor ID 或用户名/actor 名称 \(例如："janedoe/my-actor" 或 actor ID\) |
|
||
| `input` | string | 否 | 作为 JSON 字符串的 actor 输入。请参阅 actor 文档以了解所需字段。 |
|
||
| `timeout` | number | 否 | 超时时间（秒）\(默认：actor 默认值\) |
|
||
| `build` | string | 否 | 要运行的 actor 构建版本 \(例如："latest"、"beta" 或构建标签/编号\) |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | actor 运行是否成功 |
|
||
| `runId` | string | APIFY 运行 ID |
|
||
| `status` | string | 运行状态 \(SUCCEEDED, FAILED 等\) |
|
||
| `items` | array | 数据集条目 \(如果已完成\) |
|
||
|
||
### `apify_run_actor_async`
|
||
|
||
异步运行 APIFY actor 并轮询长时间运行的任务
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `apiKey` | string | 是 | 来自 console.apify.com/account#/integrations 的 APIFY API 令牌 |
|
||
| `actorId` | string | 是 | Actor ID 或用户名/actor 名称 \(例如："janedoe/my-actor" 或 actor ID\) |
|
||
| `input` | string | 否 | 作为 JSON 字符串的 actor 输入 |
|
||
| `waitForFinish` | number | 否 | 轮询开始前的初始等待时间（秒）\(0-60\) |
|
||
| `itemLimit` | number | 否 | 要获取的最大数据集条目数 \(1-250000，默认 100\) |
|
||
| `timeout` | number | 否 | 超时时间（秒）\(默认：actor 默认值\) |
|
||
| `build` | string | 否 | 要运行的 actor 构建版本 \(例如："latest"、"beta" 或构建标签/编号\) |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | actor 运行是否成功 |
|
||
| `runId` | string | APIFY 运行 ID |
|
||
| `status` | string | 运行状态 \(SUCCEEDED, FAILED 等\) |
|
||
| `datasetId` | string | 包含结果的数据集 ID |
|
||
| `items` | array | 数据集条目 \(如果已完成\) |
|
||
|
||
## 注意
|
||
|
||
- 类别: `tools`
|
||
- 类型: `apify`
|