Agent Profiles

​

Quick Start

import { AsteroidClient, executeAgent } from 'asteroid-odyssey';

const client = AsteroidClient('your-api-key');
const executionId = await executeAgent(client, 'YOUR_AGENT_ID', {
  dynamic_data: {
    input: "your data"
  },
  agent_profile_id: 'YOUR_AGENT_PROFILE_ID'
});

​

Agent Profiles

​

Profile Configuration

​

Credentials Management

​

Profile Pools

​

Why Use Profile Pools?

• Avoid credential conflicts: Prevent simultaneous use of the same account across multiple executions
• Distribute load: Spread requests across multiple accounts to respect rate limits
• Improve reliability: Automatically use alternative profiles when one is unavailable
• Reduce friction: Eliminate manual profile selection for each execution

​

Selection Strategies

​

Concurrent Use Control

• allowConcurrentUse: false (default) — A profile that is currently tied to an active execution will be skipped. If all profiles in the pool are busy, the execution request fails immediately.
  • Best for: Strict credential isolation where you never want the same account used simultaneously
  • Use when: The target site enforces per-session limits or you need guaranteed isolation
• allowConcurrentUse: true — Any profile can be selected regardless of whether it’s currently in use by another execution.
  • Best for: High-throughput scenarios where the target site doesn’t enforce strict per-session limits
  • Use when: You want maximum availability and don’t need credential isolation

​

Quick Start

import { AsteroidClient } from 'asteroid-odyssey';

const client = AsteroidClient('your-api-key');

const pool = await client.agent_profile_pools.create({
  name: 'My Rotation Pool',
  selection_strategy: 'least_recently_used', // or 'most_recently_used'
  allow_concurrent_use: false
});

console.log(`Created pool: ${pool.id}`);

// Add profiles to the pool
await client.agent_profile_pools.add_members({
  pool_id: 'your-pool-id',
  profile_ids: ['profile-id-1', 'profile-id-2', 'profile-id-3']
});

import { AsteroidClient } from 'asteroid-odyssey';

const client = AsteroidClient('your-api-key');

// Execute with a profile pool
const execution = await client.agents.execute({
  agent_id: 'your-agent-id',
  inputs: { username: '[email protected]' },
  agent_profile_pool_id: 'your-pool-id'  // Use pool instead of profile ID
});

console.log(`Execution started: ${execution.id}`);

​

Important Constraints

// Use a single profile
{ agent_profile_id: 'profile-123' }

// OR use a pool
{ agent_profile_pool_id: 'pool-456' }

// Cannot specify both
{
  agent_profile_id: 'profile-123',
  agent_profile_pool_id: 'pool-456'  // ❌ Error
}

​

2FA - TOTP Secrets

​

Cookies on Agent Profiles

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

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