pip install plato-sdk
# or install using uv
uv add plato-sdk

import asyncio
import os
from plato import Plato, PlatoTask

async def run_task(client: Plato, task: PlatoTask):
    # Create and initialize environment
    env = await client.make_environment(task.env_id, open_page_on_start=False)
    await env.wait_for_ready()
    await env.reset(task)

    # Get CDP URL for browser connection
    cdp_url = await env.get_cdp_url()

    # Get live view URL for monitoring
    live_view_url = await env.get_live_view_url()
    print(f"Live view URL: {live_view_url}")

    try:
        # Connect agent and execute task
        await YourAgent.run(cdp_url, prompt)
        result = await env.evaluate()
        print(f"Evaluation result: {result}")
    except Exception as e:
        print(f"Error: {e}")
    finally:
        await env.close()

async def main():
    client = Plato(api_key=os.environ.get("PLATO_API_KEY"))
    tasks = await client.load_tasks("doordash")
    for task in tasks:
        await run_task(client, task)

if __name__ == "__main__":
    asyncio.run(main())

from plato import Plato

client = Plato(
    api_key="your_api_key",  # Or use PLATO_API_KEY environment variable
    base_url="https://plato.so/api"  # Optional
)

class PlatoTask:
    name: str        # Task identifier
    prompt: str      # Task instructions
    start_url: str   # Starting URL
    env_id: str      # Environment identifier

# Create environment
env = await client.make_environment(
    env_id="your_env_id",
    open_page_on_start=False
)

# Initialize and reset
await env.wait_for_ready()
await env.reset(task)

# Get connection URLs
cdp_url = await env.get_cdp_url()
live_view_url = await env.get_live_view_url()

# Cleanup
await env.close()

# Load predefined tasks
tasks = await client.load_tasks("doordash")

# Create custom task
custom_task = PlatoTask(
    name="custom_order",
    prompt="Order a large pizza with pepperoni",
    start_url="https://doordash.com",
    env_id="doordash"
)

# Create environment with options
env = await client.make_environment(
    env_id="doordash",
    open_page_on_start=False,
    # Additional options as needed
)

# Wait for environment readiness
await env.wait_for_ready()

# Reset environment with task
await env.reset(task)

# Get CDP URL for browser automation
cdp_url = await env.get_cdp_url()

# Get live view URL for monitoring
live_view_url = await env.get_live_view_url()

# Evaluate task completion
result = await env.evaluate()

# Required
PLATO_API_KEY=your_plato_api_key

# Optional - Based on your AI provider
OPENAI_API_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key

try:
    env = await client.make_environment(task.env_id)
    await env.wait_for_ready()
    await env.reset(task)
    
    # Execute task
    result = await env.evaluate()
    
except Exception as e:
    print(f"Error during task execution: {e}")
finally:
    await env.close()