neulab / neulab/agent-data-protocol

Audit: improve web, environment, asset, and modality coverage

Open
#220 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
193
Forks
17
PR merge metrics
No merged PRs in 30d

Description

Dataset quality audit category: Web, environment, asset, and modality issues

The May 2026 dataset audit found 28 issues in this class:

  • web_observation_completeness: 14
  • environment_modeling: 6
  • missing_assets_or_portability: 4
  • modality_underuse: 4

Problem

Several web, GUI, database, and multimodal datasets flatten rich environment state into text or leave important assets unavailable. This underuses ADP structures such as WebObservation, ImageObservation, CodeAction, and environment TextObservations.

Examples

  • agenttuning_mind2web: web state and actions are flattened into a multiple-choice text prompt and MessageAction; the sample does not use WebObservation or ApiAction.
  • agenttuning_webshop: web pages are represented as flattened [SEP] text instead of WebObservation page state.
  • go-browse-wa: all 28 WebObservation records have html: null and an empty URL, so raw page state is not fully preserved.
  • agenttuning_db: there are no database execution observations, despite the prompt describing an iterative MySQL environment.
  • android_in_the_wild: image paths are absolute local paths under a developer workspace and are not present in this repository.
  • llava_plus: generated segmentation/inpainting artifacts are not represented as image observations; text says results are displayed, but no output image is recorded.

Suggested work

  • Use WebObservation for browser/page state when raw data includes URLs, HTML, accessibility trees, screenshots, or viewport information.
  • Use environment observations for execution outputs from databases, shells, browsers, and simulators.
  • Replace absolute local asset paths with portable repo-relative paths, documented external references, or generated sample assets that are actually available.
  • Preserve screenshots and multimodal outputs as ImageObservation where possible.
  • Add tests or audits for empty WebObservation.url, missing web HTML/axtree when available upstream, and non-portable absolute image paths.
  • Document cases where the upstream dataset does not provide richer state, so consumers can distinguish source limitations from converter omissions.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Begin by inventorying the converters and audit checks for the named datasets and the four issue categories: web observations, environment outputs, assets, and modalities. Done means richer source state is preserved where available, paths are portable, tests cover empty or missing observations, and source limitations are documented; the issue does not name specific files to start from.

Written by the indexing model from the issue text.

Assessment

Tech stack
mysql, python
Domain
data, databases, testing-qa, web-dev
Issue type
Refactor
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.