Kit tests

10 herramientas. Generado a partir del código fuente del plugin; no lo edites a mano.

Las descripciones de las herramientas y de los argumentos se muestran en inglés porque reflejan el schema de las herramientas (el mismo texto que el agente recibe en tools/list).

Guía

Use tests to observe the Automation Controller without starting or waiting for tests, and to author level AFunctionalTest actors. Use edit.list_tests to enumerate the framework registry and edit.run_test or edit.run_tests only when execution is intended.

Start by checking whether the editor has an Automation Controller and whether it has workers or prior reports:

tests.get_automation_status {}
tests.inspect_automation_reports {"contains":"Project","limit":25}

The status tool never loads the controller. If the module is available but has not discovered workers, request discovery once and poll status; the request returns immediately and does not start a test:

tests.request_automation_discovery {}
tests.get_automation_status {}

tests.inspect_automation_reports reads the controller's filtered report tree. It does not export files, clear history, or run a test. Use includeGroups:true only when you need hierarchy nodes as well as leaf reports. Empty state/result fields mean the controller has not received a result from a device; they do not mean success.

Use tests.get_automation_report {fullPath} after discovery for a single exact report. In an editor world, tests.get_functional_test_details {actor} returns current configuration and tests.audit_functional_tests {} reports disabled, running, undocumented, and unbounded tests without executing them.

Functional Tests are level actors. To add a small configured fixture to the current editor world, then inspect it:

tests.create_functional_test {
  "name":"FT_OpenDoor",
  "location":{"x":0,"y":0,"z":100},
  "description":"Door opens after the trigger is entered",
  "enabled":true,
  "setTimeLimit":true,
  "timeLimit":10
}
tests.list_functional_tests {"contains":"OpenDoor"}

Update only the fields that need changing. setDescription and setTimeLimit distinguish an intentional empty description or zero timeout from leaving those values alone:

tests.update_functional_test {
  "actor":"FT_OpenDoor",
  "enabled":true,
  "setDescription":true,
  "description":"Opens after one trigger entry",
  "setTimeLimit":true,
  "timeLimit":8
}

AFunctionalTest itself is an actor, not a standalone asset. Use bp.* to create a Functional Test Blueprint when its behaviour needs Blueprint events, and use level.*/asset.* for the map that contains it. Generic actor operations remain in actor.*.

Do not call test-execution tools from edit.self_test: automation and Functional Tests can require frames, maps, PIE, or worker messaging while the self-test holds the game thread. This kit deliberately provides no run, stop, clear, or export operation.

tests.get_functional_test_details {actor} inspects one Functional Test actor without running it, and tests.remove_functional_test {actor} deletes one from the editor level (refused while it runs). tests.request_automation_discovery and tests.get_automation_report need Automation Controller workers, so they are not part of the unattended self-test.

Herramientas

Leyenda. riesgo 0 = solo lectura, 1 = operación inofensiva del editor, 2 = modifica un asset, 3 = elimina/reemplaza un asset, 4 = proyecto/configuración/build, 5 = potencialmente destructivo (las llamadas por encima de MaxAutoRisk requieren "_confirm": true). modifica = se ejecuta en una transacción (edit.undo la revierte). requiere PIE / requiere mundo = se rechaza sin una sesión PIE / sin un nivel abierto. requiere el plugin = no disponible cuando el plugin está desactivado. dryRun = acepta el argumento dryRun. smoke = cubierto por edit.self_test.

tests.audit_functional_tests (riesgo 0, requiere mundo, smoke)

Audits loaded Functional Test actors without executing, stopping, or changing them.

Argumento	Tipo	Descripción
contains	string	Case-insensitive substring of the actor label or object name.
includeDisabled	boolean	Include disabled Functional Test actors. Valor predeterminado true.
limit	integer	Valor predeterminado 100.

Devuelve: total, issues, message.

tests.create_functional_test (riesgo 2, modifica, requiere mundo, smoke)

Adds a configured AFunctionalTest actor to the editor world; it does not execute the test.

Argumento	Tipo	Descripción
name	string	obligatorio. Unique editor label for the new AFunctionalTest actor.
location	{x,y,z}	World location in centimetres.
description	string	Editable Functional Testing description.
enabled	boolean	Enable the actor for Functional Testing discovery. Valor predeterminado true.
setTimeLimit	boolean	Apply timeLimit; zero means no test timeout. Valor predeterminado false.
timeLimit	number	Valor predeterminado 0.0f.

Devuelve: test, message.

tests.get_automation_report (riesgo 0)

Finds one current Automation Controller report without starting, exporting, or clearing tests.

Argumento	Tipo	Descripción
fullPath	string	obligatorio. Full report path reported by tests.inspect_automation_reports.

Devuelve: reports, total, message.

tests.get_automation_status (riesgo 0, smoke)

Returns the loaded Automation Controller state without starting tests or waiting for workers.

Sin argumentos.

Devuelve: moduleLoaded, state, resultsAvailable, hasErrors, hasWarnings, hasLogs, deviceClusters, enabledTests, passes, reportOutputPath, message.

tests.get_functional_test_details (riesgo 0, requiere mundo, smoke)

Returns one loaded Functional Test actor's configuration and last result without executing it.

Argumento	Tipo	Descripción
actor	string	obligatorio. Functional Test actor label, object name, or object path.

Devuelve: test, message.

tests.inspect_automation_reports (riesgo 0, smoke)

Inspects the controller's current filtered report tree; it does not run, export, or clear tests.

Argumento	Tipo	Descripción
contains	string	Case-insensitive substring of the report path or display name.
limit	integer	Maximum matching entries returned. Valor predeterminado 100.
includeGroups	boolean	Include group nodes as well as leaf test reports. Valor predeterminado false.

Devuelve: reports, total, message.

tests.list_functional_tests (riesgo 0, requiere mundo, smoke)

Lists loaded AFunctionalTest actors in the editor world.

Argumento	Tipo	Descripción
contains	string	Case-insensitive substring of the actor label or object name.
includeDisabled	boolean	Include disabled Functional Test actors. Valor predeterminado true.
limit	integer	Valor predeterminado 100.

Devuelve: tests, count, total, message.

tests.remove_functional_test (riesgo 3, modifica, destructivo, requiere mundo, smoke)

Deletes one Functional Test actor from the editor world; the test is not executed.

Argumento	Tipo	Descripción
actor	string	obligatorio. Functional Test actor label, object name, or object path.

Devuelve: test, message.

tests.request_automation_discovery (riesgo 1)

Requests worker test discovery and returns immediately; call tests.get_automation_status to observe it.

Sin argumentos.

Devuelve: moduleLoaded, state, resultsAvailable, hasErrors, hasWarnings, hasLogs, deviceClusters, enabledTests, passes, reportOutputPath, message.

tests.update_functional_test (riesgo 2, modifica, requiere mundo, smoke)

Updates the enabled flag, description, or timeout of an existing AFunctionalTest actor.

Argumento	Tipo	Descripción
actor	string	obligatorio. Actor label, object name, or object path.
enabled	boolean	Valor predeterminado true.
setDescription	boolean	Valor predeterminado false.
description	string
setTimeLimit	boolean	Valor predeterminado false.
timeLimit	number	Valor predeterminado 0.0f.

Devuelve: test, message.