Skip to main content
Agent profiles in Asteroid provide a way to create consistent, reusable browser automation environments. Each profile contains configuration settings for proxies and captcha solving along with associated credentials for authentication across different websites and services.

Agent Profiles

Configure browser settings, proxy configurations, and automation parameters

Credentials Management

Securely store and manage authentication data for your automation workflows

​
Quick Start

1

Create an Agent Profile

Use the Asteroid dashboard to create a new agent profile with your desired proxy settings, captcha solver configuration, and automation features. You can also create profiles via the API and SDKs:
2

Add Credentials (Optional)

If your automation requires authentication, add credentials to your profile through the dashboard’s credential management interface.
3

Execute with Profile

Execute your agent using the profile through either the dashboard or SDK:
  • Dashboard
  • SDK
  1. Navigate to the Agents section in your Asteroid dashboard
  2. Select the agent you want to execute
  3. Choose your created profile from the dropdown next to Run Agent
  4. Provide your input data and click Run
  5. Monitor the execution progress in real-time

​
Agent Profiles

Agent profiles define the browser automation environment settings that will be used during execution. These profiles ensure consistent behavior across different automation runs and provide isolation between different use cases.

​
Profile Configuration

Each agent profile contains the following key components:
  • Proxy Country Code: Two-letter lowercase country code for proxy location (e.g., “us”, “uk”, “de”)
  • Proxy Type: Type of proxy connection to use
  • Persistent IP: Whether to maintain the same IP address across requests
    Persistent IP’s can only be used with a US proxy and do not support Mobile proxies or Captcha Solving
  • Captcha Solver: Enable/disable automatic captcha solving capabilities
  • Cookies: Profiles can preload and persist site cookies. You can create profiles with cookies, and add/remove cookies later via the SDK. Useful for keeping authenticated sessions or site preferences.
  • Cache: Agent profiles automatically retain cache across runs. They can be cleared.
Agent profiles can be created and managed through the dashboard, the API, and SDKs. See Create an agent profile, TypeScript SDK, and Python SDK.
Deleting a profile will affect any executions that reference it. Ensure no active automations depend on the profile before deletion.

​
Credentials Management

Store credentials securely by linking them to an agent profile. In the Vault section, enter the credential name and value. Your agent will have access to these credentials automatically, but if you want to reference credentials in prompts, use their capitalized name between hashes (e.g. ##PASSWORD##). For more information, see Security.
Never expose your credentials in a prompt

​
2FA - TOTP Secrets

Set up Two-Factor Authentication (2FA) using Time-based One-Time Passwords (TOTP) with our TOTP tool. Asteroid supports all standard TOTP providers including Google Authenticator, Microsoft Authenticator, Authy, 1Password, and others.
TOTP provides an additional layer of security by generating time-based codes that expire after 30 seconds. This prevents unauthorized access even if your password is compromised. Our TOTP tool works with any service that provides a standard TOTP secret key.
1

Obtain TOTP Secret Key

Get your TOTP secret key from your service provider. The process varies by provider:Google Account:
  1. Navigate to your Google Account → Security
  2. Go to 2-Step Verification → Authenticator app → Set up authenticator
  3. Click Can’t scan it? to reveal the 32-character setup key
Other Popular Services:
  • Microsoft Authenticator: Microsoft Account → Security → Advanced security options → Add sign-in method
  • GitHub: Settings → Password and authentication → Two-factor authentication → Set up using an app
  • AWS: IAM Console → Users → Security credentials → Assign MFA device
  • Discord: User Settings → My Account → Enable Two-Factor Auth
  • Most Services: Look for “manual entry”, “can’t scan”, or “setup key” options that reveal the secret key
  • The key is typically a 16-32 character alphanumeric string (Base32 encoded)
2

Create TOTP Secret in Vault

In your Agent Profile’s Vault, create a new TOTP Secret credential and paste the secret key as the credential value. You can name your credential anything as long as it has the prefix TOTP_.
3

Add TOTP Tool to Agent

Add the Generate TOTP Secret tool to the agent node where you want to use TOTP.
4

Test Configuration

Execute your agent with the configured profile.

​
Cookies on Agent Profiles

Profiles can store website cookies to persist authenticated sessions and preferences across runs. Add cookies when creating a profile, or manage them later via the API. 
type Cookie = {
  id?: string;       // present on existing cookies
  name: string;      // display name
  key: string;       // cookie name
  value: string;     // cookie value
  domain: string;    // e.g. '.example.com'
  secure: boolean;
  http_only: boolean;
  same_site: 'Strict' | 'Lax' | 'None';
  expiry?: string;   // ISO 8601
  created_at: string; // ISO 8601
}

​
SDK Methods

See the SDK for creation and management details: TypeScript SDK and Python SDK. The Asteroid SDK provides a simple interface for using agent profiles during execution: 
import { AsteroidClient, executeAgent } from 'asteroid-odyssey';

const client = AsteroidClient('YOUR_API_KEY');

// Execute an agent with a specific profile
const executionId = await executeAgent(client, 'YOUR_AGENT_ID', {
    dynamic_data: {
        key: 'value'
    },
    agent_profile_id: 'YOUR_AGENT_PROFILE_ID'
});

​
Troubleshooting

Error: Agent profile not foundCauses:
  • Profile was deleted
  • Incorrect profile ID or name
  • Profile belongs to different organization
Solutions:
  • Verify the profile ID/name is correct
  • Check organization access permissions
  • Use the list profiles API to confirm available profiles
For additional help with agent profiles and credentials, consult the SDK documentation or contact our support.
⌘I