先说一个让人头疼的情况:你明明应该已经在MiniMax Agent平台上把智能体的角色设定给改了,或者工具也加上了,可上线一测试,发现它还是老样子。更郁闷的是,有时候你都不知道该去哪里改,改完了到底要不要重新发布。别急,这事儿其实不复杂,关键在于搞清楚两个东西的修改入口和生效机制是分开的。角色和工具,属于智能体的“运行时核心参数”,动它们,得跑到智能体的详情页里去,而且,有一部分修改并不是保存就完事了。

修改智能体角色设定(系统提示词)
角色,说白了就是智能体的“人设”,由系统提示词(system prompt)来定义。它直接决定了智能体理解问题的边界,以及它回答问题的风格。这个玩意儿改了之后,是即时生效的,不用重新发布。但是,前提是你得有权限——智能体如果处于“只读模式”或者你压根没有编辑权限,那就只能干瞪眼。
具体怎么操作?
第一步,登录Minimax开发者控制台,左手边导航栏找到“Agent”,点进去,进入列表页。
第二步,找到你想改的那个智能体,在它右边的操作列,点那个“管理”按钮,进入它专属的详情页。需要提醒的是:这个按钮只有智能体的创建者或者有编辑权限的协作者才能看到,其他人是看不到的。
第三步,页面往下翻,找到“基础配置”区域,那里有个“系统提示词”的文本框。把原来的内容删掉,输入新的角色定义。比如说:“你是一位专注跨境电商客服的AI助手,只处理物流查询、退换货政策与订单状态类问题,不回答产品技术细节。”
第四步,点页面右上角的“保存更改”按钮。搞定。这时候你再调用API或者在Web调试框里对话,它就会按新角色来回应了。
增删智能体绑定的工具(MCP/Function Calling)
工具是啥?就是让智能体能干“实事”的东西,比如查天气、调一下外部API、读个文件。这就像给智能体配了各种外设。增删工具会直接影响智能体的能力范围,所以,改完之后必须重新发布才能对外生效,否则你调用的时候就会报错“tool not found”。
操作上,有三种方式可选:
方法一:网页端手动添加MCP工具。进入智能体详情页后,点击右侧的“能力”标签页,然后点击“添加MCP URL”。把已经验证可用的MCP服务地址(比如高德地图API的接入点)粘贴进去,再填上对应的API Key,最后点“确认绑定”。
方法二:移除不再需要的工具。还是在“能力”标签页,找到那个你不想再用的工具条目,鼠标悬停到它右边,会出现一个“删除”图标。点一下,弹出一个二次确认框,再点一次“确定”,就解绑了。
方法三:通过API批量替换工具集。这个比较适合团队运维的场景。直接调用 PATCH https://api.minimax.ai/v1/agents/{agent_id} 这个接口,在请求体里带上 tools 字段,传入一个完整的新工具数组(包括type、function.name、description这些信息)。旧工具会被全量覆盖。这个操作是不可逆的,所以务必提前把原来的tools配置备份一下。
保存并使设置生效
总结一下:角色的修改是即时生效的,但工具的变更必须发布才能用。所以,不管你改的是角色还是工具,保险起见,都按下面这个步骤来一遍:
1、确认页面顶部的“保存更改”按钮已经点了,而且提示“保存成功”。
2、点右上角的“发布”按钮。如果智能体之前已经发布过,这里会显示成“重新发布”。
3、在弹出的窗口里,勾选“覆盖现有版本”,然后确认发布。
4、等待状态栏显示“已发布”。这时候,新的角色和新的工具集就算同步到生产环境了,可以放心测试。
