接入MiniMax智能体需四步闭环：获取Agent ID与API密钥（须实名认证）、构造含Authorization和Content-Type头的POST请求、发送含agent_id和user消息的JSON数据、逐层解析响应中choices[0].message.content提取文本回复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
将MiniMax智能体接入自有客服系统，需完成身份凭证获取、API请求构造、消息格式转换与响应提取四步闭环，缺失任一环节会导致401认证失败或400参数错误。
获取Agent ID与API密钥
登录Minimax开发者控制台是所有后续操作的前提，未实名认证的账号无法创建可用Agent。
访问 https://www.php.cn/link/403965e22c311cf3c37ebc98554b1ece → 使用已实名手机号或邮箱登录 → 左侧导航栏点击【Agent】→【创建Agent】→ 选择“通用对话型”模板 → 填写名称（如“售后客服助手”）并输入系统提示词（例：“你只处理订单查询、退货申请、物流跟踪三类问题，拒绝回答无关话题”）→ 点击【保存并发布】。
发布成功后，在Agent详情页复制显示的【Agent ID】（形如agent-xxxxxxxx）；该ID不可修改，删除Agent后即失效。
进入【项目管理】→【API密钥管理】→ 确认存在有效密钥；若无，点击【创建新密钥】→ 复制生成的sk-xxx格式密钥，【立即保存至本地安全位置】，网页关闭后无法再次查看。
构造标准POST请求调用Agent
MiniMax Agent API仅接受HTTPS POST请求，且必须携带两个关键Header：Authorization和Content-Type，缺一不可。
方法一：使用curl命令快速验证
在终端中执行以下命令（将YOUR_API_KEY和YOUR_AGENT_ID替换为实际值）：
curl -X POST "https://api.minimax.chat/v1/text/chatcompletion" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent_id": "YOUR_AGENT_ID",
"messages": [
{"role": "user", "content": "我的订单123456还没发货，能查下吗？"}
]
}'
方法二：在Python中用requests库调用
安装依赖：pip install requests
编写脚本，设置headers字典包含Authorization和Content-Type字段，data字典中必须含agent_id和至少一条user消息；不传agent_id会触发404错误，即使model字段正确也无效。
这一步操作起来很简单，直接把文件拖进去就行。
解析响应并提取客服可用文本
成功响应状态码为200，返回JSON结构固定嵌套，必须按路径逐层提取，不能直接读取整个response对象。
第一步：检查HTTP状态码是否为200；若为401，说明API密钥错误或过期；若为404，大概率是Agent ID拼写错误或该Agent未发布。
第二步：解析JSON响应体，定位到choices数组 → 取索引0的对象 → 进入message对象 → 读取content字段值。
第三步：该content字段即为Agent生成的纯文本回复，可直接用于客服系统前端展示或语音合成。例如返回内容为“您的订单123456已于今日10:23发货，物流单号SF123456789。”
注意：若启用多轮对话，需将历史消息（含role为user和assistant的完整记录）按时间顺序追加至messages数组，总长度不得超过16k token限制，否则触发400错误。
