Prompt Templates

custom_prompts = {
    "manager_system": "Your Jinja2 template here...",
    "executor_system": "Another template...",
    "fast_agent_system": "...",
    "fast_agent_user": "..."
}

agent = MobileAgent(
    goal="Send an email",
    config=config,
    prompts=custom_prompts  # Pass template strings, not file paths
)

<thought>The next screen still needs input.</thought>
<plan>
1. Enter the shipping address
2. Review the order
</plan>

<request_accomplished success="true">
The order was submitted and confirmation 1234 was shown.
</request_accomplished>

<progress_summary>The requested setting was enabled.</progress_summary>
<answer success="true">
The setting is enabled.
</answer>

from mobilerun import AgentConfig, MobileAgent, MobileConfig

config = MobileConfig(agent=AgentConfig(reasoning=True))

custom_prompts = {
    "manager_system": """
You are a mobile automation planning agent.

Task: {{ instruction }}
Date: {{ device_date }}

{% if app_card %}
App guidance:
{{ app_card }}
{% endif %}

{% if error_history %}
Recent errors (you may be stuck):
{% for error in error_history %}
- Action: {{ error.action }}
  Error: {{ error.error }}
{% endfor %}
{% endif %}

{% if custom_tools_descriptions %}
Custom tools:
{{ custom_tools_descriptions }}
{% endif %}

{% if variables.domain %}
Domain: {{ variables.domain }}
{% endif %}

Return one result:
- <plan>...</plan> while work remains.
- <request_accomplished success="true">...</request_accomplished> when complete.
- <request_accomplished success="false">...</request_accomplished> when blocked.
Optional <thought> and <add_memory> blocks may appear before the result.
"""
}

agent = MobileAgent(
    goal="Send an email",
    config=config,
    prompts=custom_prompts,
    variables={"domain": "finance"}
)

from mobilerun import AgentConfig, MobileAgent, MobileConfig

config = MobileConfig(agent=AgentConfig(reasoning=True))

custom_prompts = {
    "manager_system": """
Task: {{ instruction }}

{% if variables.budget %}
Budget limit: ${{ variables.budget }}
{% endif %}

{% if variables.priority %}
Priority: {{ variables.priority }}
{% endif %}

Guidelines:
{% for rule in variables.rules %}
- {{ rule }}
{% endfor %}

Return one result: <plan>...</plan> while work remains,
<request_accomplished success="true">...</request_accomplished> when complete,
or the same tag with success="false" when blocked.
"""
}

agent = MobileAgent(
    goal="Buy a phone",
    config=config,
    prompts=custom_prompts,
    variables={
        "budget": 1000,
        "priority": "high",
        "rules": ["Check reviews", "Compare prices", "Use coupons"]
    }
)

{{ instruction }}
{{ variables.my_var }}

{% if app_card %}
<app_card>{{ app_card }}</app_card>
{% endif %}

{% if error_history %}
You have {{ error_history | length }} errors
{% endif %}

{% for error in error_history %}
- {{ error.action }}: {{ error.error }}
{% endfor %}

{{ instruction | upper }}
{{ available_secrets | join(', ') }}
{{ error_history | length }}

<instruction>
{{ instruction }}
</instruction>

<guidelines>
1. Rule one
2. Rule two
</guidelines>

<output_format>
Expected format
</output_format>

{% if app_card %}
<app_card>{{ app_card }}</app_card>
{% else %}
<note>No app-specific guidance available</note>
{% endif %}

{# Expected variables:
   - instruction: str - User's goal
   - device_date: str - Current date/time
   - app_card: str - App guidance (may be empty)
#}

{% if variables.strict_mode %}
<strict>
Follow instructions exactly. Do not make assumptions.
</strict>
{% endif %}

from mobilerun import AgentConfig, MobileAgent, MobileConfig

# E-commerce automation with custom prompts
ecommerce_prompts = {
    "manager_system": """
You are an e-commerce automation specialist.

Task: {{ instruction }}
Budget: ${{ variables.budget }}

{% if app_card %}
App info:
{{ app_card }}
{% endif %}

{% if error_history %}
Errors encountered:
{% for error in error_history %}
- {{ error.action }}: {{ error.summary }} - {{ error.error }}
{% endfor %}
Consider changing your approach.
{% endif %}

Rules:
1. Verify product names exactly
2. Check prices before purchasing
3. Store order confirmations in memory
4. Never exceed budget

Return one result: <plan>...</plan> while work remains,
<request_accomplished success="true">...</request_accomplished> when complete,
or the same tag with success="false" when blocked. Optional <thought> and
<add_memory> blocks may appear before the result.
"""
}

config = MobileConfig(agent=AgentConfig(reasoning=True))
agent = MobileAgent(
    goal="Buy iPhone 15 Pro from Amazon",
    config=config,
    prompts=ecommerce_prompts,
    variables={"budget": 1200}
)

result = await agent.run()