函数参考

AI 与网络函数

更新于 2026-09-03 · 阅读约 2 分钟 · 对应桌面版 macOS 0.0.9 / Windows 0.0.7

ai.generate、web.crawl、google.search、perplexity.search、twitter.search、reddit.search、wiki.search、file.extract、http.request——在公式里逐行调用模型和网络。付费版能力,按你的供应商计费。


这组函数和普通函数一样写在列上、对每一行执行,区别是每一行都会发起一次模型调用或网络请求。它们属于付费版的「AI 插件」,并且需要先配置 API Key。参数的精确写法以公式编辑器里的「函数帮助」为准;这页给出每个函数的用途、典型写法和注意事项。

注意

每一行一次调用:一张 5000 行的表就是 5000 次。先在几十行的拆分表上试,提示词和参数确认无误再用到整表。发出去的是那一行的内容,不该出网的数据不要放进这些函数,见隐私

「全部公式」面板按文本类 / 时间类 / 关系类 / 计算类分组
「全部公式」面板按文本类 / 时间类 / 关系类 / 计算类分组

ai.generate

把提示词和本行内容交给模型,返回文本。

ai.generate("判断这条评价是正面还是负面,只回答正面或负面:", AA5)
ai.generate("把这个地址规范成 省/市/区/详细地址 的格式:", AA3)
ai.generate("从下面的描述里提取产品型号,没有就回答 无:", AA4)
  • 提示词写清楚输出格式,尤其是分类任务——把可选值列全,并把结果列设成单选属性。
  • 结果随模型而变,不是严格可复现的。
  • 用哪个模型由桌面版设置里的「模型」决定。

web.crawl

抓取一个网页,返回正文文本。

web.crawl(AA2)                         AA2 是每行一个 URL

反爬、登录墙、动态渲染的页面可能抓不到,结果为空时先在浏览器里看一眼那个地址。抓回来的正文通常再接一个 ai.generate 提取字段。

google.search / perplexity.search

按关键词搜索,返回结果摘要。

google.search(concat(AA2, " 官网"))
perplexity.search(concat(AA2, " 公司简介 成立时间"))

perplexity.search 返回的是带综合的答案文本,google.search 返回结果列表的摘要。两者都依赖对应服务的可用性。

twitter.search / reddit.search / wiki.search

在特定平台搜索:社交讨论、社区帖子、百科条目。

wiki.search(AA2)                        每行一个词条名
reddit.search(concat(AA2, " review"))

file.extract

从附件列的文件里抽取文本(PDF、文档)。

file.extract(AA7)                       AA7 是附件列

再配合 ai.generate 从抽出的文本里提字段:ai.generate("提取合同甲方名称:", AB2)

http.request

请求任意接口,返回响应文本;配合 json.select 取字段。

http.request(concat("https://api.example.com/orders/", AA2))
json.select(AB2, "$.data.status")

需要认证头时以函数帮助里的参数说明为准;简单的公开接口直接给 URL。要定时批量拉取而不是逐行请求,用数据同步的 HTTP 连接更合适。

常见问题

  • 整列为空:Key 未配置或无效、付费版未激活、网络不通。看AI 报错
  • 部分行为空:那些行的输入为空,或模型 / 网站对个别请求失败;右键单元格「重新计算」可重试单行。
  • 太慢:逐行串行请求,几百行要几分钟,属正常。
  • 费用:按供应商价格;网络类函数不走模型供应商,但可能受目标服务的配额限制。
这一页没解决你的问题?翻翻帮助中心,或者写信到 tabledi@thingworks.com.cn —— 读信的就是做产品的人。