主题
Flow的运行与集成
Flow的运行方式
Flow的详情页面提供了三种运行方式,单次运行、批量运行和定时运行
💡 需要注意的是,Flow 运行的是每次当前Flow发布的最新版本,如果你在编辑态没有点击过「发布」按钮,那么在详情页运行的还是上次发布的版本。
单次运行
单次运行模式通常作为一种便捷方式,适用于平台的简单使用(比如文案生成)或测试Flow功能的场景
批量运行
此运行模式支持下载Excel模板,用户可根据该模板填入一系列入参并上传Excel文件。Flow将依据Excel文件中的内容批量执行这些入参,此方式特别适用于需要批量生成文案或进行批量测试的场景。例如,若需测试模型回答的稳定性,可将同一问题输入10次,通过批量运行后检查每次结果是否符合预期。
定时运行
定时运行功能能够自动执行重复性任务,显著减少人工操作的需求。它允许用户根据需要设置定期执行的时间间隔,例如:每分钟、每小时或每天。此功能可用于自动生成并发送提醒、通知或警报,定期地收集和处理数据以及生成报告,或者按计划执行系统日志的漏洞扫描等任务。
使用定时任务,需要按照以下步骤操作,首先进入定时运行的页面:
- 第一步:点击新建任务,进入新建任务的弹窗,创建一个定时任务,定时任务的运行参数是创建定时任务时设定的,无法随着时间的推移而动态变化
- 第二步:任务创建完成,等待时间点自动触发定时任务
- 第三步:你可以在列表页操作当前定时任务,可以选择编辑、停用或者删除当前定时任务
- 第四步:点击定时任务可以看到当前任务的运行记录和下次运行时间
通过API的方式使用Flow
我们基于“Flow-as-a-Service”的理念为所有的Flow都提供了 API,为 AI 应用开发者带来了诸多便利。开发者可以直接在前端应用中获取大型语言模型的强大能力,而无需关注复杂的后端架构和部署过程。
API的运行方式非常灵活,绝大部分的外部系统都可以通过该方式集成Flow的能力。
使用 API 的好处
- 让前端应用直接安全地调用 LLM 能力,省去后端服务的开发过程
- 在可视化的界面中设计应用,并在所有客户端中实时生效
- 对 LLM 供应商的基础能力进行了良好封装,随时可以切换 LLM 供应商更换 LLM 模型
- 持续为应用提供更多工具能力、插件能力和知识库
如何使用
- 第一步,进入一个Flow的详情页面,选择 「访问API」
- 第二步,点击「获取API Key」的按钮获取当前Workspace的API Key
- 第三步,将页面示例中的「Your Access-Key」字符串替换为你的API Key
- 第四步,按照接口入参,在页面示例的「inputs」字段中填好Flow的入参
- 第五步,调用接口
💡 在使用过程中,必须严格保密API密钥以防泄露。若API密钥不慎泄露,可立即前往工作区的管理页面重新生成密钥。新密钥生成后,旧密钥将立刻失效,确保安全性。
访问API和Webhook的区别是什么?
在开始与输出节点的介绍中提到,我们提到了Flow可以通过外部系统利用Webhook启动。实质上,使用Webhook启动Flow本质上也是一种API调用。然而,与直接API集成相比,二者主要的区别在于API密钥的传递方式。对于像钉钉这样的平台,在设置第三方Webhook URL时通常无法自定义参数和请求头,因此需要在URL中直接携带必要的验证信息。
Agent中使用Flow
Flow是通过Agent的「技能」功能集成到Agent中的,在这里可以查看详细的集成方式