atlas_graph
ChatGPTSummarize what Atlas knows about an app: how many screens and flows it has, up to 100 of its most seen screens, and up to 30 flows as the screens they pass through. Use it to answer how the app works. Starts nothing.
atlas_search
ChatGPTFind the screens in an app's Atlas whose names or descriptions match some words, with a link to each. Starts nothing.
cancel_exploration
ChatGPTCancel one exploration and stop its explorers' devices. Screens already found stay in Atlas.
connect_github
ChatGPTReport whether the organization has connected GitHub and linked a repository to a Revyl project, which pull-request preview builds need. When GitHub is not connected it records a GitHub App install request and returns its install link for the user to open; it never installs anything itself. Call it only after the user has said yes to connecting GitHub, never on your own to check status. Needs Member role or above.
create_revyl_workspace_session_ticket
ChatGPTIssues a one-time ticket that signs the embedded Revyl workspace in as the connected user. Called by the workspace itself.
device_instruction
ChatGPTCarry out one plain-language instruction on a running iOS, Android or Web session, the way a tester would: "tap Sign in and enter the test account". A Revyl agent finds the controls and acts. A session that is still starting is waited for; if it is still starting after that, call this again. The result says whether it was carried out; take a screenshot to see the screen after. A step still running after 45 seconds comes back with its step_id for get_device_step.
device_validation
ChatGPTCheck one plain-language statement against the current screen of a running iOS, Android or Web session, such as "the cart shows 2 items". To see the screen it may first dismiss something in the way, such as a dialog. passed says whether it held, and reason says why. A step still running after 45 seconds comes back with its step_id for get_device_step.
get_build
ChatGPTReport one build: queued, running, completed, failed or cancelled, whether a device session can install it, and a short reason when it failed. Pass wait_seconds, up to 45, to wait for a build still in progress; call again until it completes, then pass its build_id to start_device_session. Starts nothing.
get_device_step
ChatGPTWait for an instruction or validation that was still running, up to 45 seconds, and report it.
get_exploration
ChatGPTReport where one exploration stands: its status, how many explorers have finished, and how many issues they found. Starts nothing.
list_apps
ChatGPTList the organization's apps by name, with each app's ID and latest build. Use it to find the app_id an Atlas view or a device session needs. Starts nothing.
list_builds
ChatGPTList an app's builds, optionally only one branch's, with queued and running builds first and then newest first. Each has its status, branch, commit, pull request and where it came from. After the user pushes to a pull request, list its head branch to find the build it started, follow it with get_build, and install it with start_device_session. Revyl builds pull requests only for repositories whose Revyl project has pull-request builds set up, and these tools cannot start a build. Starts nothing.
list_device_sessions
ChatGPTList the organization's device sessions that are queued, starting or running. Starts nothing.
open_revyl_workspace
ChatGPTRequest the Revyl Atlas or device workspace. Empty arguments open Atlas. Returns workspace_url. A successful tool call does not prove the page loaded or video is playing. Does not provision a device or change data.
screenshot
ChatGPTCapture the current screen of one running device session. The image is returned as image content and shown to the user.
start_device_session
ChatGPTStart one cloud iOS or Android device session and show its live screen. Uses device time until it is stopped or idles out, so call it only when the user asks for a device. Optionally installs one of the app's builds: its default build (the default branch's pinned build, or that branch's newest build) or one exact build; list_apps gives the IDs.
start_exploration
ChatGPTSend explorer agents through an iOS, Android or Web app, each on its own cloud device, to map its screens and flows into Atlas and report issues they find. Each explorer uses device time for several minutes, so start one only when the user asks, with one explorer unless they ask for more. Returns at once; check progress with get_exploration and show the result with open_revyl_workspace.
stop_device_session
ChatGPTStop one device session by its ID. The result says whether the session has ended or the stop is still in progress.