必须明确触发条件、输入格式、输出约束、失败兜底策略四要素：第一步定义触发场景与输入源（如App点击按钮后传URL+聊天记录）；第二步用if-else或示例对齐描述处理逻辑；第三步规定纯文本、≤120字、唯一操作指引等输出格式；第四步声明3秒超时、缓存降级、预设话术及追踪ID兜底机制。

向MiniMax平台提交Agent开发需求时，若只写“做一个智能客服”，技术团队无法判断输入来源、响应逻辑或异常处理方式，导致反复沟通返工。必须明确触发条件、输入格式、输出约束、失败兜底策略这四个不可省略的要素。

第一步：定义触发场景和输入源

说明Agent在什么情况下被调用、从哪里接收原始数据。例如：“用户在App内点击‘在线帮助’按钮后，前端将当前页面URL+用户最近3条聊天记录JSON发给Agent”。【URL必须带UTM参数，否则无法关联推广渠道】

不要笼统说“接入用户消息”，要写出真实字段名：比如微信公众号传的是MsgType=Text & Content=xxx，企业微信传的是event=MSG_SEND & msg_id=xxx。

第二步：描述核心处理逻辑

方法一：用if-else流程图语言写关键分支
 • 用户消息含“退款”且订单状态为“已发货”→查物流签收时间→超48小时未签收则返回模板A
 • 用户消息含“退款”但订单状态为“待发货”→直接返回模板B并关闭订单
 • 其他情况→转人工并标记“需质检”

方法二：用示例对齐（更推荐）
输入：“我刚下单就后悔了，能退吗？” → 输出：“可以取消订单，请点击订单页右上角‘…’→‘取消订单’。”
输入：“你们发错货了，我要退货” → 输出：“请提供订单号和错发商品照片，我们将安排上门取件。”
【每类输入必须配1个真实对话样本，禁止用‘类似情况’‘等等’模糊表述】

第三步：规定输出格式与长度限制

明确Agent返回内容的结构和边界：
• 必须是纯文本，禁用Markdown、链接、换行符
• 单次响应不超过120字（含标点）
• 需包含且仅包含一个操作指引，不许出现“您可以…”“建议…”等模糊动词
• 错误响应统一返回固定字符串：“系统繁忙，请稍后再试”

这一步漏写会导致Agent返回带按钮的富文本，前端渲染异常。

第四步：声明兜底机制与超时策略

第一步：设置最长处理时间。当前端发起请求后，若3秒内无响应，则自动触发降级逻辑。
第二步：进入降级逻辑执行路径。系统会先查询本地缓存知识库，若找到匹配的FAQ，则直接返回缓存答案。
第三步：如前述方式全部失败，则返回预设话术：“当前咨询量较大，您的问题已登记，2小时内专员将联系您。”
第四步：所有兜底响应的末尾都必须追加唯一追踪ID，格式为[FBD-xxxxxx]

没写超时值的技术文档，上线后会出现用户等待15秒才看到错误提示。