跳转到主要内容
Devin 应用是 Devin 为你构建、并在其自有机器上持续运行的 Web 应用,可以是内部工具、仪表板、表单、跟踪器或演示等。每个应用都有一个固定不变的 URL,方便你与团队共享。 应用的运行方式与浏览器预览相同。预览用于在单个会话中查看进行中的工作,足以满足大多数场景。而应用适用于会话工作结束后,团队仍需长期使用的成果。
Devin 应用正在逐步推出。如果你的 sidebar 中没有显示 Apps,说明该功能尚未对你开放。

Devin Apps 的工作原理

  • 应用运行在 Devin 的机器上。 Devin 在会话中构建应用,并由该会话的机器提供服务。不会部署到任何第三方托管平台。
  • 支持任意技术栈。 Devin 可以选用任何适合该任务的框架和语言,只要最终能在某个端口上提供 HTTP 服务即可。
  • 您的数据保留在机器上。 应用可以使用你喜欢的任何数据库,例如运行在同一台机器上的 SQLite 或 Postgres。文件和上传的内容也存放在这台机器上。
  • URL 固定不变。 应用的 URL 格式为 https://<name>--<id>.preview.devinapps.com。每次更新后 URL 都保持不变,重命名应用也不会影响它。Devin 知道该 URL,并会在应用上线后将其发给你。
  • 应用是私有的。 任何人打开应用都必须先登录 Devin。访问权限由你决定。应用永远不会公开。
  • 应用由会话管理。 构建应用的会话也负责发布后续更改。如需修改应用,请向对应的会话发送消息。

用例

  • 产品的 Beta 版和预生产环境版本。 Devin 可以在其机器上运行贵公司真实的技术栈:前端、后端、数据库以及所有工作器。因此,Devin App 非常适合托管应用的 Beta 版或预生产环境副本,团队成员只需打开链接即可访问,无需另行搭建托管环境。
  • 内部工具。 管理面板、请求表单、审批队列,以及用于取代共享电子表格的小工具。
  • 仪表板。 从你自己的数据源拉取指标、值班健康状况、支持队列或销售数据,并按计划定期刷新。
  • Rollout 跟踪器。 用一个页面展示迁移、发布或功能开关 rollout 的当前进度以及剩余工作。
  • 演示和原型。 在正式构建之前,先做出一个可运行的版本,让大家点击体验你的想法。

创建应用

  1. 在 sidebar 中打开 Apps。
  2. 描述应用需要实现的功能。你也可以选择一个提示词模板作为起点。
  3. 发送提示。
随后你会进入一个新的 Devin 会话。Devin 会在第一条消息中提出所有疑问,然后构建应用并将其上线。应用会立即出现在 Apps 下,并显示其 URL;在首个版本上线前,其状态为 Building。 你也可以在任意会话中要求创建应用,例如“把这个构建成一个 Devin App”。如果 Devin 已经向你展示了浏览器预览,你可以让它将该预览发布为应用。

休眠、唤醒与计费

无人使用时,Devin 的机器会进入休眠。有人打开该应用时,机器会被唤醒并提供页面。休眠后的首次加载可能需要几秒钟。最后一次请求结束 5 分钟后,机器会再次进入休眠。 应用按机器处于唤醒状态的时长计费。如果无人访问应用,机器休眠期间不会产生任何用量。构建和修改应用属于常规会话工作,计费方式与其他会话相同。请参阅用量。

共享应用

在应用上点击 Share,即可复制其链接或更改谁可以打开它。General access 有三个级别: 你还可以添加特定的人员、组或组织,并为每一方分别设置可执行的操作:打开应用、编辑其设置,或将其共享给他人。 组织管理员可以在 Sharing defaults 中为本组织的所有应用设置默认共享级别。

查找和置顶应用

“应用”页面列出了你可以打开的应用,并支持搜索、分类浏览和按筛选条件过滤。你可以将最常用的应用置顶。置顶分为两种:
  • 为我置顶:将应用置顶在你个人的应用主页上。
  • 为所有人置顶:将应用置顶在整个组织的应用主页上。仅组织管理员可执行此操作。
如果你喜欢别人的某个应用,可以使用 以此为起点,基于该应用创建一个新应用。

更新应用

打开应用并点击 Edit in session,然后告诉 Devin 要修改哪些内容。Devin 会完成修改、构建新版本并将其上线,URL 保持不变。 每次更新都会生成一个新版本。应用页面会在 Deployments 下列出所有版本,并显示每个版本的状态、描述和对应的 commit。如果新版本启动失败,上一个版本会继续提供服务。如需回退到旧版本,请在会话中要求重新部署该版本。 应用页面还会显示过去 24 小时、7 天或 30 天的页面浏览量。 应用的创建者和组织管理员可以打开应用设置,对其进行重命名、编辑描述、设置封面图片、下线或删除。下线应用会保留其历史记录;删除应用后,其 URL 将无法再访问。这两种操作都不会影响会话。

Devin 如何构建应用

Devin 在构建应用时会遵循一组内置指示。以下几点值得了解:
  • 提供生产构建版本。 Devin 基于开发服务器进行开发,并在浏览器预览中检查成果。应用运行正常后,Devin 会对其进行构建,并运行生产构建版本,而不是开发服务器。
  • 用 git 管理代码。 Devin 在每次部署前都会提交,因此每个版本都对应一个 commit。如果应用位于你的某个代码仓库中,Devin 会推送这些提交或创建 pull request。
  • 数据不存放在构建文件夹中。 数据库文件和上传的文件存储在会被重新构建的文件夹之外,因此更新或回滚不会清除这些数据。
  • 沿用你的品牌风格。 除非你指定了具体外观,否则 Devin 会在你的代码仓库中查找公司的设计系统,并使用其中的颜色、字体和组件,同时告诉你品牌风格的来源。如果找不到,则使用简洁的默认样式。
  • 预先提问。 用户发送请求后往往会离开,因此 Devin 会在第一次回复中就提出所需的全部问题。
  • 不留下无法运行的版本。 如果部署失败,Devin 会读取错误信息、进行修复,然后重新部署。
  • 生成缩略图。 部署完成后,Devin 会为应用截取屏幕截图,用作 Apps 页面上该应用卡片的缩略图。
你可以在提示中覆盖以上任何行为,例如指定想要的技术栈、数据库或外观。

使用自动化让应用保持最新

应用不必等你提出更改请求。自动化可以唤醒 Devin,让它替你更新应用。两种常见配置:
  • 定时运行。 Devin 每小时、每天或每周唤醒一次,拉取最新数据并更新应用。这种方式非常适合仪表板和报告。
  • 每次 Push 时运行。 如果应用跟踪您的某个代码仓库中的分支,Devin 会在该分支每次变更时重新部署应用。
只需让应用的会话完成此项配置。Devin 会创建自动化,你只需批准一次。你也可以在“自动化”页面自行创建,并让它向应用的会话发送消息。
每次自动化运行都是一个 Devin 会话,并按会话计费。如果应用每隔几分钟就更新一次,其成本可能远高于应用本身。要控制成本,可以:
  • 降低自动化的运行频率。大多数仪表板按小时或按天更新就足够了。
  • 为自动化的会话选择成本效益更高的模型。
  • 尽量减少工作量。让 Devin 编写一个只获取新数据的脚本,并在每次更新时运行该脚本,这样它就不必每次都从头摸索解决方案。
  • 在自动化上设置每个会话的支出限额。参见限额与保护措施。

Secrets 与其他服务

App 可以从其他服务读取数据,也可以向其写入数据。Devin 的配置方式与在任何会话中相同。
  • 其他服务的 API 密钥。 将密钥添加为 secret,并告诉 Devin 该密钥用于哪个服务。Devin 会将密钥提供给 App 的服务器,再由 App 从服务器端调用该服务。请将密钥保留在 App 的服务器端。发送到浏览器的任何内容,所有能打开该 App 的人都能看到。
  • Devin API。 App 可以使用个人访问令牌或服务用户密钥调用 Devin API。借此,你可以基于 Devin 构建自己的工具,例如通过表单启动会话的页面,或展示团队会话的仪表板。个人访问令牌代表你本人执行操作,因此所有使用该 App 的人都将拥有你的权限。共享此类 App 时请务必谨慎。
  • 登录。 所有打开 App 的人都已登录 Devin,因此大多数 App 无需单独设置登录功能。
Secrets 与 App 的其他部分一同存放在 Devin 的机器上。它们不属于 App 的共享设置,除非 App 主动显示,否则能打开 App 的人也无法读取。

应用离线时

应用依赖于其所在的会话。请注意以下几点:
  • 归档或结束会话会导致应用离线。 当你归档一个正在接管并运行应用的会话时,Devin 会事先提醒你。取消归档或恢复该会话即可让应用重新上线。
  • 崩溃的服务器不会自动重启。 如果应用的服务器停止运行,在 Devin 重新启动它之前,该 URL 会一直显示错误页面。打开该应用的会话,让 Devin 重新部署即可。
  • 没有在线版本的应用会显示离线页面。 在首次部署完成之前,或有人将应用下线之后,你看到的就是这个页面。
无论哪种情况,解决方法都是从“Apps”页面打开该应用的会话,然后让 Devin 重新部署。

限制

  • 应用无法设为公开,访问者始终需要登录 Devin。
  • 应用无法注册自己的 service worker,因此 PWA 无法使用离线模式。
  • 应用运行在单台机器上,适合内部工具和仪表板,不适合高流量的生产服务。对于此类服务,请使用您现有的 CI/CD 将其部署到您自己的基础设施上,并通过机密信息和技能为 Devin 授予访问权限。