SuperAPI AI 工具集

apify-generate-output-schema

编程与开发

查看项目

更新于 10-16 09:28

技能介绍

用途:为 Apify Actor 生成并接入输出架构文件,让 Apify Console 正确展示运行结果。适用前提是该任务确实需要该上游工作流,不替代环境相关的验证与维护者评审。

主要能力:按阶段分析 Actor 源码,生成 dataset_schema.json、output_schema.json,以及在 Actor 使用 key-value store 时生成 key_value_store_schema.json,并更新 actor.json 中的 storages.dataset、storages.keyValueStore 与 output 引用。

关键规则:先读源码再定字段,不猜测;所有字段设 "nullable": true,且需同时有 "type";顶层 fields 与每个嵌套对象都要有 "additionalProperties": true 和 "required": [];示例值必须匿名化;字段名需与代码实际键一致;仓库内已有 schema 时沿用其命名、描述与格式约定;已有 TS 接口或 Python TypedDict、dataclass、Pydantic 模型时直接据其派生字段。

使用方式:定位含 actor.json 的 .actor/ 目录,检索 pushData/push_data 与 setValue/set_value 调用以确定输出字段与集合;overview 视图选 8–12 个重要字段并配置显示格式;output_schema.json 的每个属性必须带 "type": "string";若原有内联 storages 配置,需迁移为文件路径。最后按清单校验字段完整性、空值、示例匿名化及 actor.json 引用,并在写入前把生成的 schema 交用户确认。

限制:资料未提供该技能的收费、平台版本或效果信息;需自行核实凭据、权限与安全边界;不替代环境特定的测试与维护者评审。