CozeAgentShell—— 扣子智能体与工作流展示平台

潦草肥猫 · 2026 年4 月 21 日 09:13

【Code With SOLO】用 SOLO 从零搭建一个扣子智能体托管平台，一键生成可分享的 AI 应用

AgentShell 是一个基于 Coze API 的智能体托管与工作流平台。它能够一键导入扣子平台上的智能体和工作流，自动生成一个可独立部署运行的 Web 应用，让任何人都能通过浏览器使用你的 AI 智能体，无需登录扣子账号。

通过 TRAE SOLO，我从零开始搭建了这个完整的平台，包含智能体对话（流式输出）、工作流表单执行、文件上传交互、站点自定义等功能，全程只需通过自然语言交互即可完成。

扣子（Coze）平台提供了强大的智能体创建和工作流编排能力，但存在一个突出问题：如果你想把自己打造的智能体或工作流作为远程面试展示，会很麻烦。我希望有一个工具，能把扣子智能体"拿出来"，变成一个独立的、可分享的 Web 应用。于是我用 TRAE SOLO 从零搭建了 CozeAgentShell。

我将整个项目拆解为以下核心模块：

在管理后台的"导入作品"页面，只需输入扣子智能体的 Bot ID 和 PAT Token，系统就会自动拉取智能体的名称、描述、开场白、建议问题等配置信息，并自动生成对应的前端展示页面。

对话功能通过 Coze API v3 的 SSE（Server-Sent Events）实现流式输出，用户可以实时看到 AI 的回复过程，体验类似 ChatGPT 的打字机效果。同时支持文件上传，用户可以直接上传文档、图片等文件给智能体分析。

对于工作流类型的智能体，系统会自动生成参数表单。用户填写参数后点击执行，即可获取工作流的运行结果。还支持"智能体 + 工作流"的混合模式，在同一页面中既可以与智能体对话，也可以执行工作流。

这是我觉得最有意思的功能之一。在配置工作流参数时，可以上传一张截图或文档，系统会调用 AI 自动识别其中的输入/输出参数结构，包括参数名称、类型、是否必填等信息，完全不需要手动填写。

除了 AI 识别，还支持直接粘贴 JSON 来批量导入参数。支持三种 JSON 格式：示例值自动推断类型、参数数组、以及 input/output 分离的结构化对象。这对于已经有 API 文档的场景非常方便。

管理后台支持自定义站点名称、描述、Logo 等信息。每个作品可以独立设置访问密码，实现简单的权限控制。这样可以把不同的智能体分发给不同的人群，各自有独立的访问凭证。

整个项目的开发过程中，TRAE SOLO 发挥了核心作用。我的工作流程是：

踩过的坑：

SSE 流式处理：Coze API 的 SSE 事件格式比较复杂，包含 verbose 等控制消息，需要仔细过滤，否则会把 JSON 元数据渲染到对话中
文件上传交互：需要先调用 Coze 上传 API 获取 file_id，再通过 object_string 格式传给智能体，链路较长
前端状态管理：多个视图切换时的状态保持和聊天记录恢复需要仔细处理

解压后双击start.bat即可运行项目并自动打开项目网站。（http://127.0.0.1:5000）

用户进入平台后，可以看到所有已导入的智能体卡片，包括名称、描述、类型标签等信息，点击即可进入对应的智能体页面。

管理后台提供了完整的作品管理功能，包括作品列表、导入、编辑参数、站点设置等。

原本需要每个用户登录扣子账号才能使用智能体，现在只需一个链接就可以分享给任何人。导入一个智能体只需 30 秒，配置工作流参数通过 AI 识别只需 10 秒，整个平台从零到可用状态不到 5 分钟。

这个项目的开发模式可以复用到类似场景：

核心思路是：用自然语言描述需求 → SOLO 生成代码 → 截图反馈问题 → SOLO 修复 → 循环迭代。这种模式让非专业开发者也能快速搭建实用的 Web 应用。

我用夸克网盘给你分享了「CozeAgen…hell.zip」，点击链接或复制整段内容，打开「夸克APP」即可获取。
/~66123YEmxv~:/
链接：夸克网盘分享
提取码：DUbN