analyzeTestFailure
Explains why a finished test failed by running TestingBot AI failure analysis on its secret-masked logs and waiting for the result; use getFailureLogs for raw logs.
Instructions
Explain why a test failed with TestingBot AI Insights. Starts an AI failure analysis of a finished test (or returns the existing one without extra cost) and waits for the result. The test's curated, secret-masked logs are sent to TestingBot's AI provider, so this requires the account owner to have enabled AI Analysis in Account Settings. Use getFailureLogs instead when you want the raw logs.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"sessionId": "<sessionId>"
},
"name": "analyzeTestFailure"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Run a fresh analysis even when a current one exists (counts towards the account's AI limits). | |
| sessionId | Yes | Session ID (or numeric test ID) of the test. | |
| waitSeconds | No | How long to wait for the analysis to finish (default 90, 0 = return immediately). |