Agent Space智能体输出格式怎么限定

在 Agent Space 中，智能体的输出格式并非由某个隐藏的开关统一控制，而是取决于你在任务指令中如何定义“交付物”。无论是需要程序直接解析的 JSON 数据，还是便于人类阅读的 Markdown 文档，核心逻辑都是将结构、字段约束和交付位置写进发给 Agent 的请求中。本文将基于网页工作区的实际布局，梳理从输入约定到结果核对的完整路径。

Agent Space 网页工作区整体布局，展示输入区、模型选择、对话记录与文件区域的位置关系

概述

首先需要明确你希望规范的是哪一部分结果：是聊天窗口中的最终文本回复，还是保存在工作区中的具体文件。这两者往往采用不同的交付策略。例如，你可以要求智能体在对话中直接返回简短的列表摘要，同时将详细的项目报告保存为 Markdown 文件。

在界面上，输入区负责承载任务目标与格式规则，Agent 和模型菜单决定了当前的执行能力边界，对话记录用于维持本轮约定的上下文，而文件区则是验收实际产物的地方。只有当约定清晰且被正确执行后，回到对应位置进行验收才是有意义的。

概述

关于输入区中的交付要求

在选定收件人为 Agent 后，内容目标与格式要求应放在同一条消息中发送。如果当前收件人是团队成员，或者发送的是普通讨论消息，这些格式意见不会自动转化为 Agent 的执行任务。

一个有效的格式约定通常包含三个部分：

• 结构：明确输出载体，例如“只输出一个 JSON 对象”或“按三个固定二级标题撰写 Markdown”。
• 内容：规定字段名称、数据类型、条目数量，以及遇到缺失资料时的表示方法（如留空或填入 null）。
• 交付：指定最终回复是直接显示在正文中，还是先保存为指定文件后再报告路径。

以下是一个要求最终回复使用 JSON 格式的输入示例，请注意这仅是指令写法，而非生成结果：

请根据我提供的材料整理摘要。最终回复只输出一个JSON对象，
包含title、points、unknowns三个字段。
title为字符串，points和unknowns均为字符串数组。
无法确认的信息写进unknowns，不补造事实。
最终回复不要加Markdown代码围栏、开场白或额外字段。
本次只在回复中交付，不修改项目文件。

这种写法排除了闲聊式的开场白和额外的解释性文字，确保输出的字符串可以直接被代码解析。

在输入区编写包含结构、内容和交付要求的 JSON 格式指令

关于 Agent、模型与材料区域

在新建对话时，应先选择 Agent，再查看输入框附近提供的兼容模型列表。格式要求本身不能赋予模型原本不具备的能力。如果选定的组合不支持图片理解或文件读取，即使你在提示词中强调“严格按格式读取图片”，智能体也无法完成任务。

给出格式要求时，必须同时明确要处理的材料来源。如果内容已存在于工作区的文件中，需写明具体路径；如果依赖图片输入，需确认当前模型组合支持该类型。没有实际读取材料的流畅回复，并不代表字段中的内容是可靠的。

此外，这里限定的是任务输出的约定。如果是需要程序严格接收 JSON 的场景，应在接收端再次验证语法与字段完整性，不能仅凭页面看起来像 JSON 就认定其可解析。

关于原对话中的修改约定

当需要调整输出格式时，应在原有的任务对话中进行修正，明确指出要替换哪条规则。例如：“保留现有事实，将 points 字段限制为最多三条；unknowns 仍保留数组类型。”这种具体的指令比模糊的“改整齐点”更容易让智能体执行并便于后续核对。

如果切换到新对话或更换了 Agent，必须重新带入必要的目标、材料路径和格式要求。共享同一工作区文件并不意味着新 Agent 能自动知晓上一段对话中最终采用了哪些字段约定。

团队若在讨论区先行确认了格式标准，可以将相关意见引用到 Agent 输入框，再补充正式的执行要求。单纯在成员讨论里达成一致，不会自动修改 Agent 的产出逻辑。

在原有对话上下文中提出具体的格式修正指令

关于文件区域与结果核对

若目标是文件交付，应将交付规则改为明确的保存指令。例如，要求将结果保存到工作区的 summary.json，并在最终回复中说明实际路径。避免同时要求“最终回复只能给 JSON”和“最终回复另写一段文件说明”，以免两条要求产生冲突。

任务完成后，通过回复中的文件卡片或侧栏“文件”入口打开产物。核对重点包括：文件是否存在、字段是否齐全、数据类型是否一致，以及是否夹杂了额外的说明文字。对于 Markdown 格式，检查标题层级和段落结构；对于 JSON 格式，建议使用标准 JSON 解析器检查语法合法性。

发现偏差后，指出实际位置和违反的具体约定，让对应对话修正当前产物。只有将格式合格性与内容准确性分别检查，才能确保输出结果稳定地交给下一步流程使用。

在文件区域打开生成的 JSON 文件并检查字段结构