需严格按照 MiniMax Agent 接口规范完成配置：必须使用成对的 App ID 与 API Key，且 .env 文件中不要添加引号；messages 必须为非空数组，并确保第一条消息的 role 为 "user"；tools 字段必须传入空数组；Authorization 请求头必须携带带有空格的 "Bearer " 前缀；parameters 必须声明为 JSON Schema 的 object 类型。

如果你想通过 MiniMax 的 Agent 接口快速搭建一个能够响应用户指令、调用工具并输出结构化结果的智能体，那么必须先吃透接口文档。由于最新版文档参数较多、示例分散，而且调试时的报错提示并不直观，很多开发者在照着文档接入时，往往会卡在接口鉴权失败、messages 格式错误等常见问题上。

准备开发环境与认证凭证

先打开 MiniMax 开发者控制台 → 进入「项目管理」→ 找到目标项目 → 点击「API 密钥」→ 复制对应凭证。这里要特别注意：【App ID 和 API Key 必须成对使用，任意单独替换其中一个，都会直接触发 401 错误】。

新建 Python 项目后，执行 pip install requests python-dotenv 安装所需依赖。

接着在项目根目录创建 .env 文件，写入：APP_ID=your_app_id_here 和 API_KEY=your_api_key_here —— 注意不要加引号，否则请求头签名校验可能失败，进而影响 MiniMax Agent 接口正常调用。

构造符合规范的 Agent 请求体

MiniMax Agent 接口对 messages 字段有明确要求：它必须是数组，且首条消息的 role 必须为 user。若传入空数组、第一条消息角色是 assistant，或者把 role 错写成 "User"，接口通常都会返回 400 错误。

方法一：基础单轮调用

可构建如下 JSON 字典：{"model": "abab6.5s", "messages": [{"role": "user", "content": "今天北京天气怎么样？"}], "tools": []} —— 其中 tools 字段即使暂时不启用工具调用，也必须显式传空数组；如果传 null 或直接省略，通常会触发 schema 校验失败。

方法二：带工具调用的完整结构

在定义 tools 列表时，每一项都必须包含 type 和 function 两个字段；当前支持的 type 仅为 function。function 内部需要提供 name、description、parameters，其中 parameters 必须使用 JSON Schema 的 object 类型，不能直接写成普通 dict 或字符串；此外，name 只能由小写字母、数字和下划线组成，并且首字符不能是数字，这是 MiniMax Agent 工具定义中的重要命名规则。

发送请求并解析响应流

第一步：使用 requests.post 发起请求，headers 中必须包含 Content-Type: application/json 和 Authorization: Bearer {api_key}；【Authorization 的值里，Bearer 后面必须保留一个英文空格，缺少这个空格会直接返回 401】。

第二步：先检查 response.status_code 是否等于 200，然后再读取 response.json()；如果 status_code 虽然是 200，但返回结果中没有 choices 字段，通常说明模型没有生成有效输出，常见原因包括 messages 参数格式错误，或者 model 名称填写有误。

第三步：读取 choices[0]["message"]["content"] 作为模型返回的文本内容；如果还需要获取 tool_calls，可以继续读取 choices[0]["message"].get("tool_calls")。该字段返回的是一个列表，其中每个元素通常包含 id、type、function.name 以及 function.arguments。需要特别留意的是，arguments 本身是字符串格式，实际使用前还要通过 json.loads 进一步解析。