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:
  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:
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

​
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

For additional help with agent profiles and credentials, consult the SDK documentation or contact our support.