在 MiniMax Agent 工作流中，必须准确配置输入字段和输出目标：先启用自定义输入字段，并设置字段类型、是否必填以及校验规则；输出端可选择结构化 JSON、Webhook 转发或写入数据库；调试阶段还需要重点核对模拟输入与 Output Raw 的匹配情况，确保整个输入输出链路稳定可用。

你需要在 MiniMax Agent 工作流中精细控制输入来源与输出目标，让 Agent 接收指定格式的数据，并根据业务需求返回结构化结果，而不是使用默认的自由文本回复。这也是提升工作流稳定性、自动化程度和接口兼容性的关键设置。

设置Agent输入字段

第一步：进入 Agent 编辑页面，点击左侧的“输入配置”标签页。

第二步：勾选“启用自定义输入字段”，启用后下方会显示字段定义区域。

第三步：点击“添加字段”后，会弹出配置窗口。在这里填写字段名称（例如 customer_id）、字段类型（支持 text/number/boolean/file），以及是否设为必填。这里有一个很容易被忽略但非常关键的细节：如果字段类型选择的是 file，【必须勾选“允许上传”并设置最大文件大小，否则前端无法触发上传控件】。

第四步：为关键字段开启校验规则——例如给 email 字段添加正则表达式^[^s@]+@[^s@]+.[^s@]+$，从源头减少脏数据进入流程，避免后续节点因数据格式异常而中断。

配置输出格式与目标

方法一：直接返回 JSON 结构

进入“输出配置”页面后，将输出方式切换为“结构化输出”，并开启“强制 JSON 模式”。完成该设置后，Agent 不再进行自然语言润色，而是仅返回合法的 JSON 对象；同时，字段名会严格基于你定义的输入字段名，并自动加上 _result 后缀输出，例如 customer_id_result。这种方式非常适合 API 对接、系统集成和自动化处理场景。

方法二：映射到 Webhook 地址

启用“Webhook 转发”，填写目标 URL（如 https://your-api.com/hook）。需要注意的是，该 URL 必须支持 POST 请求，且响应超时需≤10秒，【若返回非2xx状态码，Agent会标记本次执行为失败并停止后续节点】。

方法三：写入 Minimax 内置数据库表

点击“数据库写入”，选择已有数据表，或者新建一张数据表。系统会根据你定义的输入字段自动生成对应的数据列，无需手动建模。写入成功后，可在“数据管理”模块中实时查看记录，方便后续查询、统计和业务追踪。

调试输入输出链路

① 在调试面板顶部切换到“模拟输入”模式，手动填写 JSON 格式测试数据，例如{"order_no":"ORD-20260810-7721","amount":299.5}。

② 点击“运行”，重点观察右侧“执行日志”中的 Input Raw 与 Output Raw 两栏内容，确认输入输出是否符合预期。

③ 如果 Output Raw 为空或格式错误，应立即检查输入字段是否被设置为必填却未传值，或者在 JSON 模式下 Agent 内部逻辑是否抛出了未捕获异常。

④ 调试成功后，复制调试页面生成的 curl 命令，在终端中粘贴执行，进一步验证外部系统调用效果，确保 MiniMax Agent 工作流的输入输出配置能够在真实环境中正常运行。