概览

Sim 的执行引擎通过按正确的顺序处理模块、管理数据流并优雅地处理错误，使您的工作流栩栩如生，从而让您能够准确了解工作流在 Sim 中的执行方式。

文档概览

核心概念

拓扑执行

模块按照依赖顺序执行，类似于电子表格重新计算单元格的方式。执行引擎会自动确定哪些模块可以基于已完成的依赖项运行。

路径跟踪

引擎会主动跟踪工作流中的执行路径。路由器和条件模块会动态更新这些路径，确保仅执行相关模块。

基于层的处理

引擎不会逐个执行模块，而是识别可以并行运行的模块层，从而优化复杂工作流的性能。

执行上下文

每个工作流在执行期间都会维护一个丰富的上下文，其中包含：

• 模块输出和状态
• 活跃的执行路径
• 循环和并行迭代跟踪
• 环境变量
• 路由决策

部署快照

所有公共入口点——API、聊天、计划、Webhook 和手动运行——都会执行工作流的活动部署快照。每次更改画布时发布一个新的部署，以便每个触发器都使用更新的版本。

部署模式会保留完整的版本历史记录——可以检查任何快照，将其与草稿进行比较，并在需要恢复之前的版本时一键提升或回滚。

编程执行

使用我们的官方 SDK 从您的应用程序中执行工作流：

# TypeScript/JavaScript
npm install simstudio-ts-sdk

# Python
pip install simstudio-sdk

// TypeScript Example
import { SimStudioClient } from 'simstudio-ts-sdk';

const client = new SimStudioClient({ 
  apiKey: 'your-api-key' 
});

const result = await client.executeWorkflow('workflow-id', {
  input: { message: 'Hello' }
});

最佳实践

设计可靠性

• 使用适当的回退路径优雅地处理错误
• 对敏感数据使用环境变量
• 在函数块中添加日志记录以进行调试

优化性能

• 尽量减少外部 API 调用
• 对独立操作使用并行执行
• 在适当情况下使用内存块缓存结果

监控执行

• 定期查看日志以了解性能模式
• 跟踪 AI 模型使用的成本
• 使用工作流快照调试问题

接下来是什么？

从 执行基础 开始，了解工作流如何运行，然后探索 日志记录 以监控您的执行情况，以及 成本计算 以优化您的支出。