必须先获取Agent的唯一GroupID才能配置API调用或权限管理，否则因X-Group-ID缺失导致403/404错误；可通过控制台URL提取、GET /v1/agents接口查询或创建Agent响应体直接获取。

要在MiniMax平台为Agent配置API调用或权限管理，必须先获取该Agent对应的唯一GroupID，否则无法在请求头中正确设置X-Group-ID字段，导致403或404错误。

通过MiniMax控制台查看GroupID

第一步：登录MiniMax开发者控制台，使用已实名认证的账号。

第二步：在左侧导航栏点击「Agent」→「我的Agent」，进入Agent列表页。

第三步：找到目标Agent，点击其名称或右侧「详情」按钮，跳转至Agent详情页。

第四步：在详情页URL中直接提取GroupID——地址形如https://www.php.cn/link/5216918203d50dcfccc84a970b3743f0/agent/{group_id}/detail，【{group_id}部分即为你要的GroupID，长度为24位十六进制字符串，例如65a1b2c3d4e5f67890123456】。

通过API接口获取GroupID（需已有AccessToken）

方法一：调用GET /v1/agents接口

向https://api.minimaxi.com/v1/agents发送带Authorization头的GET请求，Header中包含Authorization: Bearer {your_access_token}。

响应体中每个Agent对象含group_id字段，匹配name或description即可定位目标Agent。

注意：该接口默认只返回前20个Agent，若列表过长，请添加limit=100&offset=20参数分页拉取。

通过创建Agent时的响应体获取（适用于新创建Agent）

调用POST /v1/agents创建Agent后，响应体JSON中group_id字段会直接返回，例如：

{"id":"agt_abc123","group_id":"66b2c3d4e5f6789012345678","name":"客服助手","status":"active"}

这一步操作起来很简单，直接复制响应里的group_id值即可使用，无需额外查找。