SuperAPI AI 工具集

temporal-developer

编程与开发

查看项目

更新于 10-16 03:05

技能介绍

用途:该技能面向使用 Temporal 持久化执行平台开发应用的场景,帮助在 Python、TypeScript、Go、Java、.NET、Ruby、Rust 中构建、调试和管理工作流。

核心架构:Temporal Cluster 是编排后端,包含事件历史(工作流状态的持久日志)、任务队列(将任务路由给 Worker)和可见性存储(搜索与列出工作流)。运行方式有三种:Temporal CLI 开发服务器(temporal server start-dev,仅用于开发测试)、自托管(自行部署服务及依赖,用于生产)、Temporal Cloud(全托管生产服务)。Worker 是长期运行的进程,轮询任务队列并执行代码,承载两类代码:工作流定义(持久、确定性的编排函数,不得有副作用)和活动实现(非确定性操作,如 API 调用、文件 I/O,可失败重试)。

确定性重放:Temporal 通过历史重放实现持久性。首次执行生成命令并作为事件存入历史;失败重启后从头重放工作流,SDK 比对生成命令与存储事件,用已存活动结果替代重新执行。命令与事件不匹配即产生非确定性错误,工作流被阻塞。

使用方式:先确认已安装 Temporal CLI,未安装则按平台安装说明操作;再阅读所用语言的入门参考,然后按任务查阅核心与语言特定参考,包括确定性、模式(信号、查询、Saga)、常见错误、版本管理、独立活动(公开预览)、故障排查、错误参考、交互式工作流、开发管理、CLI 工作流命令(start、execute、signal、query、update)以及 AI/LLM 模式(目前仅 Python)。多租户应用建议启用任务队列公平性,避免高流量租户挤占其他租户;优先级与公平性也适用于分层负载等场景。第三方集成(Spring Boot、Spring AI、OpenAI Agents SDK、Google ADK 等)见集成目录。

限制:Rust 与独立活动处于公开预览;AI 模式参考目前仅 Python 可用;CLI 开发服务器不适用于生产。若发现技能说明不清或缺失,可起草 GitHub issue 并请用户提交,不要自行提交。