What Are AI Agents?
AI Agents are browser automation bots that execute multi-step workflows. They can visit websites, click elements, fill forms, upload files, extract data, run JavaScript, solve CAPTCHAs, and make AI-powered decisions. Agents are used to automate repetitive tasks that would otherwise require manual browser interaction.Building an Agent
Agents are built using a visual instruction workflow editor. The editor presents a canvas where admins compose a sequence of instructions that the agent follows step by step.Instruction Types
| Instruction | Description |
|---|---|
| Visit URL | Navigate the browser to a specific address |
| Click Element | Click on a page element identified by a selector |
| Type Input | Type text into a form field |
| Upload File | Upload a file to a designated element |
| Download File | Download a file from a URL |
| Enter Iframe | Switch the agent’s context into an embedded iframe |
| Take Screenshot | Capture a screenshot of the current page |
| Wait for Element | Pause until a specific element appears on the page |
| Wait for URL | Pause until the browser URL contains a specific pattern |
| Solve CAPTCHA | Attempt to solve a CAPTCHA challenge |
| AI Instruction | Give the agent a natural-language instruction and let AI determine the actions |
| Run JavaScript | Execute custom JavaScript code in the browser |
| Fetch OTP | Retrieve a one-time password from a configured source |
| Loop Over Data | Iterate over a data array, executing child instructions for each item |
| Conditional Branch | Evaluate a condition and follow the TRUE or FALSE path |
| Terminate | End the agent’s execution |
Element Selection
When an instruction targets a page element, the agent identifies it using one of these methods:| Method | Description |
|---|---|
| CSS Selector | Standard CSS selector syntax |
| XPath | XPath expression |
| ID | Element’s HTML ID attribute |
| Class Name | Element’s CSS class |
| Tag Name | HTML tag name |
| Link Text | Full text of a hyperlink |
| Partial Link Text | Partial match on hyperlink text |
| Text Containing | Match by text content |
Input Variables
Input variables provide data to the agent before execution. Each variable has:| Property | Description |
|---|---|
| Name | Variable identifier |
| Description | What the variable represents |
| Type | Text or File |
| Mandatory | Whether the variable must be provided |
| Sensitive | Whether the value should be masked in logs |
| Dynamic Runtime | Whether the value is resolved at execution time |
Output Variables
Output variables capture data extracted during execution. Each variable has a name and description. Output values are collected from instruction results and made available to the system after the agent finishes.States
Agents can define named states that act as workflow checkpoints. Each state has a name, description, and a default flag. States allow the agent to resume from a known point or branch execution based on the current state.How Agents Are Triggered
| Method | Description |
|---|---|
| Automation Action | The “Run AI Agent” automation action triggers execution with application context |
| Form Element | An “AI Agent” form element in a hiring flow triggers the agent when the candidate reaches that step |
| Manual Trigger | Admins can trigger an agent directly, selecting a specific hiring flow or check-in form and the applications to process |
| Test | Admins can test the agent from the editor, with options for streaming output and debug mode |
Manual Trigger
When manually triggering an agent, admins:- Select the context: Hiring Flow or Check-in Form
- Choose the specific flow or form
- Select which applications to process
- Initiate the execution
Testing
The test interface allows admins to run the agent with:- Streaming mode — Watch the execution output in real-time
- Debug mode — Verbose logging for troubleshooting
- Input variable values — Provide text or file values for each input
- Loop data — For agents with loop instructions, provide the data array
Execution History
Every agent execution creates a record that tracks:- Execution status and timing
- Input data provided
- Output data captured
- Detailed execution logs
Scope and Permissions
| Scope | Description |
|---|---|
| Company | Available only within the company that created it |
| Global | Available across all companies (managed by platform staff) |