Skip to content

Agents & Sessions

How agents execute work in browser, Appium, and API sessions and what artifacts you get back.

Certyn executes work using AI agents running inside isolated sessions.

What a session is

A session is the runtime unit of work:

  • a fresh runtime environment, usually an isolated browser, an Appium-backed app session, or an API runtime container
  • an agent that reads the assignment (task + tests + environment + wiki)
  • artifact recording (logs, screenshots, trace)

Sessions do not share state with each other.

How the agent executes

At a high level, each session loops:

  1. observe the page, app, or API state
  2. decide the next action
  3. execute (click/type/navigate/scroll on web, tap/type/swipe on Appium, or HTTP/Hurl checks on API)
  4. verify expectations

The goal is resilience to minor UI changes without maintaining brittle locator code.

What you get back

Every session produces evidence you can use for triage and verification:

  • action timeline
  • screenshots or request/response evidence
  • agent trace
  • final outcome (pass/fail/error) and reasoning

Live viewing

While a browser or Appium session is running, you can open the live view (for example via Watch Live on a process page or the issue live route) to see the browser or mirrored device the agent is controlling. API sessions focus on conversation, request output, and tool evidence instead of a live browser view.