跳转到主要内容
结构化输出就像 Devin 的笔记本——它在工作过程中会不断更新记录，你可以随时查看这些记录。当前，你无法强制 Devin 更新它的记录，但可以请求查看它目前为止已经写下的内容。

进度更新

在长时间运行的任务中获取 Devin 的进度更新

应用集成

使用统一的 JSON 将 Devin 的分析和输出集成到你的应用程序中。

​
请求结构化输出

要使用结构化输出，请在创建会话时在提示中包含所需的 JSON 架构（schema）。 同时请确保在提示中指示 Devin，一旦有相关变化就立即更新结构化输出。
  • PR 评审
  • 进度更新
  • 测试结果
  • 功能实现
{
  "prompt": "Review this PR and provide updates in this format. Please update the structured output immediately whenever you find new issues, have suggestions, or change your approval status:\n{
    "issues": [
      {
        "file": "src/App.tsx",
        "line": 42,
        "type": "bug",
        "description": "Memory leak in useEffect cleanup"
      }
    ],
    "suggestions": [
      "Add error handling for API calls",
      "Split component into smaller parts"
    ],
    "approved": false
  }"
}
用于 PR 评审和代码分析的简单格式。

​
获取结构化输出

使用此端点从会话中获取结构化输出。 结构化输出会在 structured_output 字段中返回。
在使用 Devin 网页应用时，你可以随时按下 ⌘ + I（Command+I）快速查看结构化输出。

​
最佳实践

  • 在初始提示中包含 schema 定义
  • 明确定义预期的更新频率（例如：“每次向网站添加新组件后，请更新结构化输出”）
  • 清晰说明各字段的值类型和格式
  • 使用清晰、具描述性的字段名，便于 Devin 知道要填写什么内容
  • 在 schema 中包含示例值
  • 轮询时使用 10–30 秒的间隔，以避免对 Devin API 造成过大压力
  • 会话完成或出错时停止轮询
请记住，Devin 会按照自己的节奏更新结构化输出——你无法强制它更新，但可以随时请求查看最新记录。
如对结构化输出的使用有任何疑问，或需报告相关问题，请发送邮件至 [email protected]。