Bugbug connects to a Nagent workspace with an API key. Once it is connected, agents can call 4 Bugbug actions, such as "Get test run details", "List suites" and "List tests". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Bugbug, with input parameters and output schema.
BUGBUG_GET_TEST_RUN_DETAILSGet detailed information about test runs from BugBug. This action retrieves a paginated list of test runs with comprehensive details including execution status, timing information, browser settings, and error details. Supports filtering by start time and sorting by various fields. Useful for monitoring test execution history, analyzing test performance, and debugging test failures.
Input parameters
Page number for pagination
Sort order for results
Number of items per page
ISO 8601 formatted timestamp to filter runs that started after this time
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUGBUG_LIST_SUITESList all available test suites in the Bugbug platform. This tool makes a GET request to the /suites/ endpoint and returns a list of available test suites with pagination support.
Input parameters
Page number for pagination
Number of items per page
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUGBUG_LIST_TESTSRetrieves a list of all available tests in the BugBug account. This action provides access to all tests in the account with pagination support. It returns basic information about each test including its ID, name, active status, and recording status.
Input parameters
Page number for pagination
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUGBUG_RUN_TESTExecute a test in BugBug and return the test run details. This action triggers a test run with optional configuration for browser, device, viewport, and variable overrides. It returns the test run ID, status, modification timestamp, and a URL to view detailed results in the BugBug web application.
Input parameters
Model for test run profile configuration.
The unique identifier of the test to execute (UUID format)
List of variables to override for this test run
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 4 Bugbug actions on Nagent, including "Get test run details", "List suites" and "List tests". Get test run details: Get detailed information about test runs from BugBug. Each action is listed on this page with its input parameters and its output.
Bugbug connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It also takes 4 optional inputs: page, ordering, page_size and started_after. It returns data, error and successful.