必须掌握MiniMax Agent五项核心能力：创建智能体、配置提示词、调用API、Web UI调试、启用联网搜索，缺一不可；创建Agent需实名认证后在控制台选“通用对话型”模板，填约束性系统提示词并保存发布，立即复制唯一Agent ID；用curl或Postman以真实API Key测试调用；通过Web UI连续多轮对话验证记忆与上下文；联网搜索需在agent.minimaxi.com开启M2.5-Search开关；接入微信公众号需配置Webhook回调地址与Token。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在30分钟内用自然语言一句话生成可锁座、能支付的演唱会选座系统，或把Excel表格转成实时数据看板，必须先掌握MiniMax Agent最核心的五项能力：创建智能体、配置提示词、调用API、Web UI调试、启用联网搜索。这五个动作缺一不可，跳过任意一个都会导致后续功能无法触发。
创建首个Agent实例
这一步决定你的智能体有没有“脑子”，必须在控制台完成，不能跳过。
1、登录 Minimax开发者控制台，确认右上角显示“已实名认证”；未认证会直接拦截后续所有操作。
2、左侧导航栏点击“Agent”→“创建Agent”，模板类型选“通用对话型”。不要选“代码生成”或“MCP Builder”，它们不支持后续Webhook集成。
3、填写名称（如“演唱会助手”），在系统提示词框中输入：【你是一名专注票务服务的AI助手，只处理座位查询、锁座、支付状态确认三类请求，不回答天气、明星八卦等无关问题】。这个强约束能防止模型幻觉跑偏。
4、点击“保存并发布”，页面跳转后立即复制顶部显示的Agent ID——【该ID仅在此页可见一次，关闭即永久丢失】。
用API密钥本地调用测试响应
不写代码也能测通，但必须用真实API Key发起HTTP请求，模拟真实调用链路。
方法一：用curl命令行（推荐）
打开终端，粘贴执行以下命令（将your_api_key和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":"agent_id","messages":[{"role":"user","content":"帮我查A区12排5号是否可售"}]}'
方法二：用Postman图形界面
新建POST请求→URL填入https://api.minimax.chat/v1/text/chatcompletion→Headers添加Authorization和Content-Type→Body选raw/JSON→填入含agent_id和messages的JSON结构。
注意：如果返回401错误，90%是API Key复制时多了一个空格；返回404则说明agent_id输错或未发布成功。
通过Web UI实时调试多轮对话
这是唯一能验证“记忆是否生效”“上下文是否连贯”的方式，必须手动点进去聊三次以上。
第一步：回到Agent列表页，找到刚创建的实例，点击右侧“调试”按钮。
通过 4 个 Agent 半串行协作流水线（Plan/Write/Test/Refine）把老板的一句话需求转化为可用的 Python 软件，适用于用户说“做个软件”“开发工具”“写个脚本”或希望 AI 代理构建软件的情况。
第二步：在弹出的聊天窗口中，连续发送三条消息：
① “我想订周杰伦上海场”
② “A区还有哪些位置”
③ “锁定A区8排3号”
第三步：观察第二条回复是否包含A区座位分布图，第三条是否返回“已锁定15分钟，请尽快支付”。若第二条仍问“哪场演出”，说明系统提示词未生效；若第三条说“未识别锁定指令”，说明工具权限没开。
第四步：点击右上角“重置会话”，重新开始测试——每次重置都会清空临时记忆，避免误判。
启用M2.5-Search实时联网搜索
当用户问“神舟十九号最新发射时间”，默认Agent只会瞎猜，必须主动打开联网开关。
1、访问 https://www.php.cn/link/3761f19421dde49193924cdeece61636，确保使用与开发者控制台相同的账号登录。
2、点击右上角齿轮图标→进入“Agent设置”→滑动到底部“工具权限”区域。
3、找到“联网搜索”开关，从灰色切换为蓝色。此时旁边会显示“已启用M2.5-Search模型”。
4、回到聊天框，直接输入：“截至2026年8月10日，中国载人航天工程办公室官网公布的神舟十九号最新任务时间表”，等待返回带来源链接的结构化结果。
将Agent接入微信公众号
这一步让智能体真正走出控制台，变成用户每天能触达的服务入口。
1、在微信公众号后台开通“开发者模式”，获取AppID和AppSecret。
2、回到Minimax控制台Agent详情页，找到“Webhook配置”区域。
3、在“回调地址”栏填入你的服务器域名+/minimax-webhook（例如https://yourdomain.com/minimax-webhook）。
4、点击“生成Token”，复制该字符串并保存到微信公众号后台的“消息加解密”配置中。
5、勾选“启用Webhook”，点击“保存”。此时微信用户每发一条消息，Minimax会自动推送至你填写的地址。
