generate-appworld-code

Generate AppWorld Code

Generate executable Python code for AppWorld agent tasks, applying learned strategies from the ACE playbook.

Purpose

When the AppWorld executor encounters a task, it calls this Skill with:

• Task instruction (natural language)
• Available apps (e.g., ['spotify', 'venmo'])
• Playbook bullets (learned strategies to apply)

You generate Python code that:

1. Solves the task using AppWorld APIs
2. Applies bullet guidance strategies
3. Handles errors gracefully
4. Calls apis.supervisor.complete_task() when done

Input Format

{
  "instruction": "What is the title of the most-liked song in my Spotify playlists",
  "apps": ["spotify"],
  "strategies": [
    "Always login before API calls",
    "Handle pagination for large result sets"
  ],
  "bullets": [
    {
      "id": "bullet-xxx",
      "title": "Spotify login pattern",
      "content": "Login to Spotify using apis.spotify.login() with credentials..."
    }
  ]
}

AppWorld API Patterns

Spotify

# Login
response = apis.spotify.login(username="[email protected]", password="password")
token = response["access_token"]

# Get playlists
playlists = apis.spotify.show_playlist_library(access_token=token)

# Get songs in playlist
songs = apis.spotify.show_playlist_songs(
    access_token=token,
    playlist_id=playlists[0]["id"]
)

Venmo

# Login
response = apis.venmo.login(username="[email protected]", password="password")
token = response["access_token"]

# Get friends
friends = apis.venmo.show_friends(access_token=token)

# Send payment
apis.venmo.send_payment(
    access_token=token,
    recipient_id=friend["id"],
    amount=10.00,
    note="Payment note"
)

Gmail

# Login
response = apis.gmail.login(username="[email protected]", password="password")
token = response["access_token"]

# Fetch emails
emails = apis.gmail.fetch_emails(
    access_token=token,
    max_results=10,
    query="is:unread"
)

# Send email
apis.gmail.send_email(
    access_token=token,
    to="[email protected]",
    subject="Subject",
    body="Email body"
)