Custom Variables

from mobilerun import MobileAgent, MobileConfig

# Define custom prompts that render variables
custom_prompts = {
    "manager_system": """
{{ instruction }}

{% if variables %}
Available variables:
{% for key, value in variables.items() %}
- {{ key }}: {{ value }}
{% endfor %}
{% endif %}
    """
}

# Create agent with variables
config = MobileConfig()

agent = MobileAgent(
    goal="Send email to recipient with subject",
    config=config,
    variables={"recipient": "john@example.com", "subject": "Update"},
    prompts=custom_prompts  # Required to see variables
)

result = await agent.run()

from mobilerun import MobileAgent, MobileConfig

# Define variables
variables = {
    "recipient": "alice@example.com",
    "message": "Hello from Mobilerun!"
}

# Custom prompt to render variables
custom_prompts = {
    "fast_agent_system": """
You are an agent that controls Android devices.

{% if variables %}
Available variables:
{% for key, value in variables.items() %}
- {{ key }}: {{ value }}
{% endfor %}
{% endif %}

Use these variables when executing tasks.
    """
}

# Create agent
config = MobileConfig()

agent = MobileAgent(
    goal="Send message to recipient",
    config=config,
    variables=variables,
    prompts=custom_prompts
)

result = await agent.run()

from mobilerun import MobileAgent, MobileConfig

async def send_notification(title: str, *, ctx, **kwargs):
    """Send a notification using channel from custom variables.

    Args:
        title: Notification title
        ctx: ActionContext (injected automatically by the registry)
    """
    # Access custom variables via ctx.shared_state
    channel = ctx.shared_state.custom_variables.get("notification_channel", "default")
    return f"Sent '{title}' to {channel}"

custom_tools = {
    "send_notification": {
        "parameters": {
            "title": {"type": "string", "required": True},
        },
        "description": "Send a notification with title. Usage: {\"action\": \"send_notification\", \"title\": \"Alert\"}",
        "function": send_notification
    }
}

config = MobileConfig()

agent = MobileAgent(
    goal="Send notification with title 'Alert'",
    config=config,
    custom_tools=custom_tools,
    variables={"notification_channel": "alerts"}
)

# Define reusable workflow with different variables
for user in ["alice@example.com", "bob@example.com"]:
    agent = MobileAgent(
        goal="Send welcome email",
        config=config,
        variables={"recipient": user},
        prompts=custom_prompts
    )
    await agent.run()

variables = {
    "api_endpoint": "https://api.example.com/v2",
    "timeout": 30
}

agent = MobileAgent(
    goal="Call API endpoint",
    config=config,
    variables=variables,
    prompts=custom_prompts
)