Skip to main content

WorkArena benchmark for BrowserGym

Project description

🤖💻 WorkArena - How Capable are Web Agents at Solving Common Knowledge Work Tasks?

[Paper][Benchmark Contents][Getting Started][BrowserGym][Citing This Work]

WorkArena is a suite of browser-based tasks tailored to gauge web agents' effectiveness in supporting routine tasks for knowledge workers. By harnessing the ubiquitous ServiceNow platform, this benchmark will be instrumental in assessing the widespread state of such automations in modern knowledge work environments.

WorkArena is included in BrowserGym, a conversational gym environment for the evaluation of web agents.

Benchmark Contents

At the moment, WorkArena includes 23,150 task instances drawn from 29 tasks that cover the main components of the ServiceNow user interface. The following videos show an agent built on GPT-4-vision interacting with every such component. As emphasized by our results, this benchmark is not solved and thus, the performance of the agent is not always on point.

Knowledge Bases

Goal: The agent must search for specific information in the company knowledge base.

The agent interacts with the user via BrowserGym's conversational interface.

https://github.com/ServiceNow/ui-copilot/assets/2374980/a778fbfd-6f9c-41b2-9c20-1d97cc348866

Forms

Goal: The agent must fill a complex form with specific values for each field.

https://github.com/ServiceNow/ui-copilot/assets/2374980/1f3fa96d-d76e-4f04-a75f-bcf758c5aa42

Service Catalogs

Goal: The agent must order items with specific configurations from the company's service catalog.

https://github.com/ServiceNow/ui-copilot/assets/2374980/8451faa8-3776-4e52-bb90-a560ea23a709

Lists

Goal: The agent must filter a list according to some specifications.

In this example, the agent struggles to manipulate the UI and fails to create the filter.

https://github.com/ServiceNow/ui-copilot/assets/2374980/042f058b-a966-4f5e-a38f-146464132c49

Menus

Goal: The agent must navigate to a specific application using the main menu.

https://github.com/ServiceNow/ui-copilot/assets/2374980/d5f89fd0-ed72-49b8-81ce-8a493a2c8f5f

Getting Started

To setup WorkArena, you will need to get your own ServiceNow instance, install our Python package, and upload some data to your instance. Follow the steps below to achieve this.

a) Create a ServiceNow Developer Instance

  1. Go to https://developer.servicenow.com/ and create an account.
  2. Click on Request an instance and select the Vancouver release (initializing the instance will take a few minutes)
  3. Once the instance is ready, you will see a popup showing its URL and credentials. You will also receive a copy by email. Based on this information, set the following environment variables:
    • SNOW_INSTANCE_URL: URL of your ServiceNow developer instance
    • SNOW_INSTANCE_UNAME: Just use "admin"
    • SNOW_INSTANCE_PWD: The password for your instance. Make sure you place the value in quotes "" since it might contain special characters.
  4. Log into your instance via a browser using the admin credentials. Close any popup that appears on the main screen (e.g., agreeing to analytics).

Warning: Feel free to look around the platform, but please make sure you revert any changes (e.g., changes to list views, pinning some menus, etc.) as these changes will be persistent and affect the benchmarking process.

b) Install WorkArena and Initialize your Instance

Run the following command to install WorkArena in the BrowswerGym environment:

pip install browsergym-workarena

Then, run this command in a terminal to upload the benchmark data to your ServiceNow instance:

workarena-install

c) Validate Your Installation

The are a lot of moving parts (authentication credentials, benchmark data, etc.) so we highly recommend that you sanity-check your installation using our provided unit tests. Do this by running (might take a few minutes):

pytest -v .

Your installation is now complete! 🎉

Citing This Work

@misc{workarena2024,
      title={WorkArena: How Capable Are Web Agents at Solving Common Knowledge Work Tasks?}, 
      author={Alexandre Drouin and Maxime Gasse and Massimo Caccia and Issam H. Laradji and Manuel Del Verme and Tom Marty and Léo Boisvert and Megh Thakkar and Quentin Cappart and David Vazquez and Nicolas Chapados and Alexandre Lacoste},
      year={2024},
      eprint={2403.07718},
      archivePrefix={arXiv},
      primaryClass={cs.LG}
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

browsergym_workarena-0.1.0rc0.tar.gz (3.3 MB view details)

Uploaded Source

Built Distribution

browsergym_workarena-0.1.0rc0-py3-none-any.whl (2.6 MB view details)

Uploaded Python 3

File details

Details for the file browsergym_workarena-0.1.0rc0.tar.gz.

File metadata

File hashes

Hashes for browsergym_workarena-0.1.0rc0.tar.gz
Algorithm Hash digest
SHA256 5525b512739be104c509a5a247cebe6cd75587bec3cdf5cac9414e0a27eb56e5
MD5 9094bd6799ea135bb13a47760a9e46d3
BLAKE2b-256 8bcd8b62895a6292262785fdeeeec6a197683ff4abd240d89d100cecb8596c63

See more details on using hashes here.

File details

Details for the file browsergym_workarena-0.1.0rc0-py3-none-any.whl.

File metadata

File hashes

Hashes for browsergym_workarena-0.1.0rc0-py3-none-any.whl
Algorithm Hash digest
SHA256 f5adfab767fad4312a1fe634d5667e9b34c24ab09e656369350bbb039f739ba4
MD5 6509752f1fad677839fc088de5538972
BLAKE2b-256 7dcc4c472aee509fc0d2977f448ece70a8ea9ac4971ee30e46a5dbaf2bca8e5e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page