neulab / neulab/agent-data-protocol
Audit: improve web, environment, asset, and modality coverage
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: 14environment_modeling: 6missing_assets_or_portability: 4modality_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 andMessageAction; the sample does not useWebObservationorApiAction.agenttuning_webshop: web pages are represented as flattened[SEP]text instead ofWebObservationpage state.go-browse-wa: all 28WebObservationrecords havehtml: nulland 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
WebObservationfor 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
ImageObservationwhere 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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