工作流发布：如何发布为 Web 应用？
工作流发布为 Web 应用时，在 AI Flowi Workflow 中选择已保存的工作区工作流，并从五种应用类型中选择一种：聊天、表单、仪表板、门户或自定义。设置地址、访问权限和品牌信息，然后审阅并发布。分享地址前，请先测试工作流和访客页面。
作者：Ai Flowi · 技术审核： Janice Lee，技术支持，Ai Flowi。
发布于 · 更新于
有关发布功能和访问模式，请参阅 发布功能页面。
产品： Ai Flowi 的 AI Flowi Workflow · 任务： 发布已配置的工作流 · 组件： 现有工作流；无需额外的发布组件
适用场景
当用户需要通过网址运行工作流时，可使用发布功能。可用的应用类型有聊天、表单、仪表板、门户和自定义。访客请求的中转服务接受文本输入，并返回聊天或文本输出；应用类型不会改变这一输入输出约定。
开始前的准备
- 在应用所属的工作区中保存并测试工作流。
- 确认工作区已获得发布权限，且你的账户有权管理已发布的应用。
- 检查工作区的已发布应用配额。
- 准备品牌名称和标题。如需使用徽标、网站图标和建议提示词，也请提前准备。
- 选择公开、需登录或私有链接访问。对于需登录的访问模式，用户必须拥有在应用所属工作区中查看发布内容的权限。
- 使用自定义域名时，请让域名管理员配置提供的 DNS 验证信息，并确保已部署 TLS。
操作步骤
添加工作流并选择应用类型
添加： 从工作流的 “发布到 Web” 操作打开发布向导，或在已发布应用列表中新建应用。
设置： 选择已保存的工作流，再选择聊天、表单、仪表板、门户或自定义类型。
连接： 应用与所选工作区工作流关联；这一步不会添加或更改组件端口。
测试： 确认所选工作流就是已测试的工作流。
预期结果： 向导会将该工作流和应用类型带入地址设置步骤。应用草稿创建后，其工作流和应用类型即被锁定。
设置地址和访客访问权限
添加： 选择提供的应用地址或自定义域名。
设置： 输入地址名称和页面标题。选择公开、需登录或私有链接访问，并确认任何扩大访问范围的更改请求。
连接： 使用自定义域名时，请使用提供的 CNAME 目标和 TXT 验证令牌。CNAME 必须直接指向提供的目标。发布前，请让域名管理员设置记录并完成 DNS 验证。
测试： 检查已保存的地址、访问模式和域名验证结果。请妥善保管新生成的私有链接；它只会显示一次。
预期结果： 草稿的地址和访问设置已保存。自定义域名必须完成验证，才能通过发布校验。
添加品牌信息并查看预览
添加： 按需上传徽标和网站图标。
设置： 输入品牌名称、标题、简介、颜色和建议提示词。品牌名称和标题为必填项。
连接： 将品牌信息保存到应用草稿。
测试： 查看预览并修正校验错误。
预期结果： 审阅步骤会显示应用类型、地址、访问模式和品牌信息。存在校验错误时，仍无法发布。
发布并测试访客页面
添加： 审阅已保存的应用，然后选择 “发布到 Web”。
设置： 分享地址时，请保持预定的访问模式。
连接： 以访客身份打开已发布的地址。对于需登录的访问模式，请使用获准访问的工作区账户登录；对于私有链接访问，请使用生成的链接。
测试： 发送一条工作流能够处理的无害文本输入。检查响应，并确认没有所需访问权限的用户无法运行受保护的应用。
预期结果： 应用被标记为已发布，并返回所关联工作流的文本回复。
常见误区
- 尚未测试访客视图就分享地址。
- 未完成自定义域名验证。
- 未审阅确认提示就将受保护的应用改为公开。
- 误以为仪表板、门户或自定义应用可以绕过文本输入和输出限制。
- 以为编辑设置后无需再次发布，就能替换已发布版本。
故障排查
以下为服务错误代码。已部署的界面可能会显示对应消息。
| 代码 | 原因 / 下一步检查 |
|---|---|
invalid_field | 检查指定字段接受的格式。 |
slug_already_used / address_already_used | 选择未被使用的地址名称或域名。 |
confirm_public_required / confirm_private_required | 审阅并确认请求的访问权限更改。 |
custom_domain_used | 该域名已被另一个应用占用。选择前请核查归属。 |
publish_not_ready | 阅读校验错误；设置品牌名称和标题，并验证所有自定义域名。 |
published_app_limit | 检查工作区的已发布应用配额。 |
publish_quota_unavailable | 配额验证未能完成。请在服务恢复后重试。 |
page_bundle_missing | 请管理员部署已发布页面的资源包。 |
publish_busy / publish_state_changed | 稍等片刻，重新加载已保存的应用设置，然后再次尝试审阅。 |
web_server_reload_failed | 请管理员检查 Web 服务器的重新加载情况。 |
too_many_runs | 应用正忙。请稍后重试。 |
flow_not_ready | 检查并测试所关联的工作流。 |
input_too_large | 缩短访客输入。 |
flow_run_timeout / flow_run_failed | 重试前，请检查所关联的工作流及其服务。 |
insufficient_balance | 应用暂时不可用，因为工作流余额不足以支付本次运行。请负责人检查余额。 |