操作
操作是你的逻辑,通过 Fóir 调用。你托管一个 HTTP 端点并注册它的 URL,Fóir 向它发送签名负载、失败时重试并记录结果。
触发方式
操作可以由控制台中的按钮、记录编辑器中的字段、一个生命周期钩子、一个定时计划或一次对公开 API 的调用来运行。每个操作都有自己的类型化 GraphQL mutation,由它的输入和输出 schema 生成,因此键为 ai-summarize 的操作会变成 executeAiSummarize。前置条件和用量配额决定谁可以运行它以及多频繁地运行。
同步或在后台
在同步模式下,调用方等待,你的响应体就是结果。超时默认为 30 秒,最高可设为五分钟。在异步模式下,你的端点返回 202,之后通过回调令牌报告进度、完成、失败或取消。默认有 24 小时的回调时间,超过后该次运行会被标记为超时。
重试与死信队列
失败的调用会被重试,默认三次,连续五次失败后熔断器会打开,并在 60 秒内拒绝调用。用尽重试次数的排队运行会进入死信队列,你可以在那里检查、重试或忽略它。调用上的幂等键会让重试沿用第一次尝试的运行,因此工作不会做两次。
运行记录
每次运行都会记录状态、时长、结果或错误、触发方式、重试次数和进度。
调用第三方 API
直通写入背后没有你自己的服务。Fóir 根据请求模板自行调用第三方 API,凭据取自机密。解析器操作把第三方 API 以 GraphQL 查询或模型上的字段的形式呈现,并带有缓存和批处理。