SuperAPI AI 工具集

apify-hello-world

智能体与模型

查看项目

更新于 10-16 06:20

技能介绍

用途:该技能用于运行你的第一个 Apify Actor,并通过 apify-client 检索结果,适合开始新的 Apify 集成、测试连通性或了解 Actor 调用方式时使用。

主要能力:演示完整的 call-wait-collect 模式——调用一个公开 Actor、等待其完成、再从默认数据集读取抓取到的数据。示例调用 apify/website-content-crawler,读取 run.defaultDatasetId 数据集中的 items。

使用方式:前置条件为已完成 npm install apify-client,并设置 APIFY_TOKEN 环境变量;未就绪可参考 apify-install-auth。认证通过 new ApifyClient({ token: process.env.APIFY_TOKEN }) 传入令牌,令牌放在 APIFY_TOKEN 环境变量中,不要硬编码。步骤:创建 hello-apify.ts(或 .js)写入示例代码,用 Read 确认内容后运行:npx tsx hello-apify.ts,或用 node hello-apify.js。成功运行返回 run 对象及填充好的数据集,常用字段包括 run.id、run.status(SUCCEEDED、FAILED、TIMED-OUT、ABORTED)、run.defaultDatasetId、run.defaultKeyValueStoreId、run.statusMessage。读取数据集前应先判断 run.status。

适用场景:新集成起步、连通性测试、学习 Actor 调用模式。

限制与错误处理:Actor 未找到需检查 apify.com/store 中的 ID;run.status 为 FAILED 需看 statusMessage;TIMED-OUT 可增加超时或减少工作量;数据集为空需检查输入参数与 Actor 日志;HTTP 402 表示账户预付计算单元不足,需在 console.apify.com/billing 充值。其余同步/异步执行、分页、下载、键值存储等工作流细节资料未展开。