必须明确触发条件、输入格式、输出约束、失败兜底策略四要素：第一步定义触发场景与输入源（如app点击按钮后传url+聊天记录）；第二步用if-else或示例对齐描述处理逻辑；第三步规定纯文本、≤120字、唯一操作指引等输出格式；第四步声明3秒超时、缓存降级、预设话术及追踪id兜底机制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
向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秒才看到错误提示。
