SuperAPI AI 工具集

writing-online-resolvers

写作与研究

查看项目

更新于 10-15 20:11

技能介绍

用途:指导在 Chalk 中编写、重构和调试 @online Python resolver,并判断何时应改用特征表达式(如 F.http_post、_.foo、SQL 文件)。

主要能力:介绍四种签名形态——标量进标量出、无参常量/环境变量、Features[...] 一次输出多特征、DataFrame[...] 进标量出(has-many 聚合),以及 has-many 输出构造 DataFrame[Child];支持通过点号路径跨命名空间取值,Chalk 自动解析 join。Now 输入在实时、时点、离线/回测三种查询下分别取当前时间、请求时刻、行时间戳。装饰器选项包括 tags、environment、machine_type、resource_hint、resource_group、static、owner、timeout,默认用裸 @online。

使用方式:用 @online 装饰参数与返回值均以 Chalk 特征引用标注的函数;Features[...] 返回需构造特征类并传 kwargs;has-many 参数以 DataFrame 传入,用 list(df) 迭代。声明式逻辑(HTTP 调用、JSON 路径、列运算)应优先用特征表达式,过程式逻辑(分支、迭代、解析)才用 Python resolver。SQL 放 src/resolvers/sql/ 的 .chalk.sql 文件。

适用场景:proto/JSON/厂商载荷解析、风险分等聚合、时点计算、单元与集成测试。

限制:静态 resolver 中不可调用 df.run()/to_pandas();时间戳相减前需统一 tzinfo;Features[...] 不可返回 dict/tuple;不要手动在 resolver 内查询做 join;避免在 resolver 体内构造客户端。资料未提供具体收费与平台支持信息。