MiniMax Agent单元测试代码生成教程

必须先确认Agent已发布并获取agent_id，再用Python+pytest编写含mock和断言的单元测试，覆盖正常响应、空输入、超长输入、特殊符号及401/404错误路径，最后通过pytest-cov验证覆盖率≥85%。

你需要为 MiniMax Agent 编写的业务逻辑快速生成可运行、带断言的单元测试代码，避免手动补全 mock、fixture 和 assert 时漏掉边界条件或 HTTP 状态码分支。

确认 Agent 已发布并获取可用 ID

只有已发布的 Agent 才能被真实调用，未发布的实例在 API 层返回 404 或 401，会导致后续所有测试用例失败。

登录 Minimax 开发者控制台 → 进入 Agent 模块 → 找到目标 Agent → 查看右侧状态栏是否显示“已发布”；若为“草稿”或“待审核”，点击“保存并发布”按钮完成上线。

发布成功后，在详情页复制 agent_id 字符串（形如 agent_abc123xyz），该 ID 将用于构造测试请求体。

用 Python + pytest 构建基础测试框架

创建 test_agent_basic.py 文件，填入以下最小可行结构：

import pytest
import requests
from unittest.mock import patch

AGENT_ID = "agent_abc123xyz"
API_URL = "https://api.minimax.chat/v1/text/chatcompletion"
API_KEY = "your_api_key_here"

def test_agent_responds_to_simple_query():
response = requests.post(
API_URL,
headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},
json={"agent_id": AGENT_ID, "messages": [{"role": "user", "content": "你好"}]}
)
assert response.status_code == 200
assert "choices" in response.json()
assert len(response.json()["choices"]) > 0

生成覆盖多轮对话与错误路径的测试用例

方法一：用 MiniMax M2 自动生成完整测试套件

先打开 MiniMax M2 Agent 的桌面端或 Web 控制台，然后新建一个会话，接着输入这条指令：“根据 agent_id=agent_abc123xyz，生成 pytest 测试文件，覆盖单轮问候、空输入、超长输入（>2000字符）、含特殊符号的 query、以及 401/404 错误响应模拟，每个 case 需包含对应 mock 和 assert。”

等待生成结果 → 复制全部 Python 代码 → 保存为 test_agent_comprehensive.py。

方法二：手动补全关键异常路径（推荐用于调试阶段）

在 test_agent_basic.py 底部追加：

@patch("requests.post")
def test_agent_handles_invalid_api_key(mock_post):
mock_post.return_value.status_code = 401
mock_post.return_value.json.return_value = {"error": {"message": "Invalid API key"}}
# 这里直接模拟无效 API Key 的请求场景，沿用原函数里的 request 构造方式
response = requests.post(API_URL, headers={"Authorization": "Bearer invalid"}, json={"agent_id": AGENT_ID})
assert response.status_code == 401

注意：patch 必须作用于被测代码中实际 import 的 requests.post 路径，若测试文件与被测模块分离，需写成 @patch("myapp.agent_client.requests.post")。

运行测试并验证覆盖率

第一步：安装依赖
pip install pytest requests pytest-cov

第二步：执行带覆盖率统计的测试
pytest test_agent_comprehensive.py --cov=my_agent_module --cov-report=html

第三步：检查输出中的 missing 行——这些是未被任何测试 case 触达的代码行，例如系统提示词中某条 if 分支、工具调用失败后的 fallback 逻辑。立即针对 missing 行补充新测试用例，直到覆盖率 ≥85%。

第四步：打开 htmlcov/index.html，逐行确认所有核心分支（特别是 error handling 和 tool call success/fail 分支）均已高亮为绿色。