☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
refund_reason_code字段在用户小程序申请退款时必填，决定风控审核路径与逆向物流触发；status=pending时为空将阻断流程，非法值导致打款服务抛refundvalidationexception，仅风控组可见原始码值。
你需要让microsoft copilot把api返回的json字段说明写得像真人业务分析师整理的一样，不是罗列“field: string”，而是清楚交代这个字段在什么真实业务动作里起什么作用、谁在看、什么时候会变、错了会怎样——这就必须把字段嵌进具体场景里，不能只给结构不给上下文。
用真实业务动作锚定字段含义
第一步：在提示词开头直接写明当前接口调用的具体业务动作，例如：“用户在小程序点击‘申请退款’按钮后，后端调用/order/refund接口发起退款预校验”。
第二步：说明该字段出现在哪个关键决策点，例如：“refund_status字段决定前端是否展示‘已到账’图标，也控制财务系统是否触发打款任务”。
第三步：绑定角色与权限，例如：“仅风控组成员可在管理后台查看refund_reason_code字段原始值，普通客服只能看到脱敏后的中文描述”。
这三步缺一不可——Copilot若不知道是“小程序退款”而不是“后台批量退单”，就会把refund_amount解释成“退款金额”，而不是“扣除平台服务费后的实际返还金额（单位：分）”。
插入真实报错日志片段引导语义精度
方法一：粘贴一行真实错误日志作为上下文锚点
在提示词末尾直接插入：[2026-06-15T10:22:37.841Z] ERROR refund-service: refund_id=RFD-20260615-00872, refund_status=“pending”, but refund_reason_code is null → rejected by validation rule #REF-402
方法二：用该日志反推字段约束
紧接着写：“请据此说明refund_reason_code字段：① 为何在status=pending时必须非空；② 哪些reason_code值会触发风控人工审核；③ 若填入非法code，下游打款服务将直接抛出RefundValidationException而非静默忽略”。
【refund_reason_code必须为非空字符串，且仅允许取值“701”“702”“705”“709”，其他值会导致退款流程中断】
微软 Outlook 邮箱和日历管理工具（支持世纪互联版 Office 365）。用于查看、发送、搜索邮件，管理日历日程，创建会议，查询忙闲状态。注意：此功能仅支持世纪互联（21Vianet）版 Microsoft 365，使用 login.chinacloudapi.cn。
绑定下游消费方的真实使用方式
在提示词中明确写出字段被谁怎么用：
“物流调度中台通过订阅Kafka topic ‘refund_event’获取该字段，当refund_status=‘shipped’且refund_reason_code=‘702’时，自动触发逆向揽收工单；而ERP系统只读取refund_status字段用于更新库存状态，完全忽略refund_reason_code。”
这句话强制Copilot区分字段的“必填性”“消费方差异”和“业务流转路径”，避免它泛泛而谈“该字段标识退款原因”。
再补一句硬约束：“所有说明必须以动词开头，如‘触发’‘阻断’‘跳过’‘映射为’，禁用‘表示’‘用于’‘一般为’等空洞表达。”
注入时间敏感性与变更影响
第一步：标注字段值的时间有效性
“refund_amount字段值在用户提交申请时冻结，后续任何运营干预（如补偿券发放）均不修改此字段，新金额体现在adjustment_amount中。”
第二步：说明历史兼容逻辑
“2026年5月前老版本APP传入的refund_status可能为‘wait_confirm’，现统一映射为‘pending’，但refund_reason_code仍按原值透传。”
第三步：指出字段缺失时的真实fallback行为
“若refund_reason_code缺失，风控系统默认按‘701（商品质量问题）’处理，但会在日志中标记WARN级别缺失告警。”
