Agent profiles allow you to customize proxy settings and browser fingerprints for your AI browser agent executions. Create reusable configurations that ensure consistent and secure automation across different environments.

​
Overview

Proxy Configuration

Configure residential and mobile proxies for different geographical regions

Browser Fingerprinting

Customize browser characteristics to avoid detection and maintain consistency

Reusable Profiles

Create once, use across multiple agent executions

Geographic Flexibility

Choose from multiple countries and regions for your proxy locations

​
Creating Agent Profiles

​
Profile Configuration

1

Set Profile Name

Give your profile a descriptive name that indicates its purpose.

My Agent Profile
E-commerce Automation Profile
US Residential Profile
2

Add Description (Optional)

Provide a brief description of what this profile is used for.

Profile for e-commerce automation
High-anonymity profile for data collection
Testing profile for US-based sites
3

Configure Proxy Settings

Choose your proxy type and location based on your automation needs.

Proxy TypeUse CasePerformance
ResidentialHigh anonymity, geo-targetingSlower, more reliable
MobileMobile-specific automationVariable, highly anonymous
4

Select Proxy Country

Choose the geographic location for your proxy to match your target audience or compliance requirements.

​
Profile Settings

​
Proxy Configuration Options

​
name
string
required

A unique identifier for your agent profile

Example: "US-Residential-Profile"

​
description
string

Optional description explaining the profile’s purpose

Example: "Profile for e-commerce automation"

​
proxy_type
string

Type of proxy to use for this profile

Options: residential, mobile

​
proxy_country
string

Country code for proxy location

Example: "US", "GB", "DE"

​
Browser Fingerprint Customization

Agent profiles automatically configure browser fingerprints to match your proxy settings and provide optimal anonymity:

{
  "profile_id": "prof_abc123",
  "name": "US-Residential-Profile",
  "proxy": {
    "type": "residential",
    "country": "US",
    "city": "New York"
  },
  "fingerprint": {
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)...",
    "viewport": "1920x1080",
    "timezone": "America/New_York",
    "language": "en-US"
  }
}

​
Using Agent Profiles

​
Applying Profiles to Agent Executions

// Apply profile to agent execution
const result = await agent.execute({
  profile: "US-Residential-Profile",
  task: "Navigate to example.com and extract data",
  options: {
    headless: false,
    timeout: 30000
  }
});

​
Best Practices

​
Profile Management

Create multiple profiles for different automation scenarios. This allows you to quickly switch between configurations without manual setup each time.

​
Profile Naming Conventions

Use descriptive names that indicate the profile’s purpose:

✅ Good Examples:
- "US-Residential-Ecommerce"
- "EU-Datacenter-Testing"
- "Mobile-Social-Media"

❌ Poor Examples:
- "Profile1"
- "MyProfile"
- "Test"

​
Profile Rotation

For large-scale automation, consider rotating between multiple profiles:

const profiles = [
  "US-East-Residential",
  "US-West-Residential", 
  "US-Central-Residential"
];

// Rotate profiles for each execution
const currentProfile = profiles[Math.floor(Math.random() * profiles.length)];

​
Troubleshooting