sn_atf_results
Retrieve paginated ATF suite results, read full step summaries or output in chunks, and inspect cached run history or comparisons without extra network calls.
Instructions
Get paginated ATF suite results, retrieve complete step summary/output in chunks, or inspect cached history/comparisons. History and compare need no ServiceNow network requests. Results may include untrusted failure text.
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": {
"action": "<action>",
"profile": "<profile>"
},
"name": "sn_atf_results"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum cached runs to display in history (default 10) | |
| action | Yes | Fetch paginated results, retrieve complete step text, read cached history, or compare cached runs | |
| profile | Yes | Configured ServiceNow profile name (required; no default fallback). | |
| result_id | No | CI/CD result ID for get, or current cached run ID for compare | |
| progress_id | No | CI/CD progress ID for get while awaiting a result | |
| test_sys_id | No | Test ID for history across cached suites | |
| tests_limit | No | Test summaries per page (default 200) | |
| output_field | No | Step text field to retrieve (default summary) | |
| output_limit | No | Step-text chunk length (default 4000 characters) | |
| suite_sys_id | No | Suite ID required for history or compare unless selecting test history | |
| tests_offset | No | Test-summary page offset for get (default 0) | |
| output_offset | No | Character offset for the next step-text chunk | |
| failures_limit | No | Failure details per page (default 10) | |
| step_result_id | No | Step result ID for action=step; returned with failures | |
| failures_offset | No | Failure-detail page offset for get (default 0) | |
| previous_result_id | No | Previous cached run ID for compare | |
| regression_percent | No | Duration regression threshold, percent (default 20) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| profile | Yes | Configured ServiceNow profile name (required; no default fallback). | |
| metadata | Yes |