QA Finding tools
Tools for reading a project’s QA Findings and moving the QA ticket each one landed on: the judged steps of Agentic QA runs whose page did not
show the step’s expected result. A QA Finding is not an accessibility finding, and its id (qaf_…)
is not a finding id. Each id argument also accepts the finding’s base64 QaFinding global id.
Every QA Finding carries the runId (qar_…) of the run that raised it, which
get_qa_run_result takes, and the status of its QA ticket.
Every finding of the same step content in one journey, or of the same app crash in the project,
shares one QA ticket. A new finding on a DONE QA ticket reopens it to TODO; a WONT_FIX one
stays WONT_FIX. A run closes an open QA ticket to DONE when it is the second finished run in a
row of the journey on one environment to pass the ticket’s step, or, for a crash, to get past it.
A ticket with a finding on another environment since it last opened stays open.
list_qa_findings
Section titled “list_qa_findings”List a project’s QA Findings, newest first.
| Name | Type | Required | Notes |
|---|---|---|---|
project_id | string | yes | |
first | number | no | How many QA Findings to return, 1 to 100. Default 20. |
after | string | no | pageInfo.endCursor from the previous call, to load the next page. |
status | string | no | Only findings whose QA ticket has this status. |
Returns: findings, totalCount and pageInfo (hasNextPage, endCursor). Each finding has
its id (qaf_…), runId (qar_…), journeyName, stepIndex (0-based), severity,
instruction and status. A project with no QA Findings returns an empty findings list. An unknown project is
an error block.
get_qa_finding
Section titled “get_qa_finding”Get one QA Finding.
| Name | Type | Required | Notes |
|---|---|---|---|
qa_finding_id | string | yes | A qaf_… id from list_qa_findings, or from qaAuditRun.findings in get_qa_run_result. |
Returns: the finding’s id, runId, journeyName, locale (null when the journey named
none), stepIndex, severity, instruction, status, closedByRunId (the qar_… run that
closed the QA ticket, or null when no run closed it), expectedResult, observed (what the page showed
instead), reasoning (why the step was judged failed), url (the page) and screenshotUrl. An id
you cannot reach is an error block naming it.
set_qa_ticket_status
Section titled “set_qa_ticket_status”Set the status of the QA ticket a QA Finding landed on.
| Name | Type | Required | Notes |
|---|---|---|---|
qa_finding_id | string | yes | A qaf_… id on the QA ticket to move. |
status | string | yes | See the generated ticket tool reference for accepted status values. |
Returns: the QA ticket’s id (qat_…) and status. An id you cannot reach is an error block.