xyzhu1225/3D-Clarify

Dataset

Weixin Li,

1

4 commits

2 linked in READMEs

updated Jul 21, 2026

See the code

README

[ACM MM 2026] Clarify Before Executing: A Self-Evolving Agent for Resolving Intent Asymmetry in 3D Tool Orchestration

Xiaoye Zhu, Weixin Li, Junan Huo, Bozhong Wang, Jia Zeng, Yi Yang, Cen Chen, Qi Liu†

South China University of Technology
†Corresponding author

Paper | Project Page | Code | Benchmark | Source Assets

CLARE places a clarification gate before 3D tool execution, resolving ambiguity, missing information, and mistaken constraints through targeted dialogue. This release centers on the 3D-Clarify benchmark and a reproducible code-level evaluation pipeline for the paper's single-step and multi-step experiments.

CLARE framework and self-evolution pipeline

Highlights

  • Clarify before executing: four specialized components gate execution, maintain clarified state, synthesize 3D tool code, and communicate targeted feedback.
  • 3D-Clarify benchmark: 620 tasks across five 3D domains, each evaluated under ambiguity, missing-information, and mistaken-detail conditions.
  • Self-evolving clarification: simulated multi-turn interaction and Multi-turn Reward optimization raise task success to 60.40% on Single and 43.34% on Multi.

3D-Clarify Benchmark

3D-Clarify evaluates whether an interactive agent resolves intent asymmetry before producing 3D tool calls. It contains 620 interaction scenarios across text-to-3D generation, single-view reconstruction, multi-view reconstruction, point-cloud editing, and post-processing.

Each task provides a fully specified hidden goal and three controlled initial-query variants: ambiguity, missing information, and mistaken details. The paper evaluates these three variants, giving 1,500 single-step and 360 multi-step task-condition instances.

Overview of the 3D-Clarify benchmark

Dataset Splits

SplitTasksPaper evaluation unitsCompositionSHA-256
single5001,500Five domains, 100 tasks each056c890ac7b907e34db782c4ab44927d4f68a4116fc225d7e00aab419d770bb3
multi12036085 two-step and 35 three-step workflows868d4f2a843e17f608d54dc9befba858d546e05e3d2bac0d4bcd8063788ad94c
from datasets import load_dataset

dataset = load_dataset("xyzhu1225/3D-Clarify")
single_tasks = dataset["single"]
multi_tasks = dataset["multi"]

Record Schema

FieldDescription
idStable task identifier within the split
completeFully specified hidden user goal
ambiguousSemantically underspecified initial request
missing_infoInitial request with required values removed
mistakeInitial request containing one invalid or conflicting detail
mistake_typeControlled perturbation category used by mistake
file_pathSource-asset value used to instantiate path templates
ground_truthOrdered structured tool and parameter requirements
codeFixed ground-truth Executor calls used by CR/SR evaluation
gt_summaryLegacy provenance summary; not used by code evaluation

The paper reports Goal Completion Rate (CR) and Task Success Rate (SR) over ambiguous, missing_info, and mistake. Multi-step records preserve tool-call order and intermediate dependencies.

Resources

The source media is not required for the paper's deterministic code-level evaluation. It is distributed separately for users who enable physical 3D tool execution. The few-shot prompting examples used by baselines are part of the code repository and are intentionally not included in this benchmark dataset.

3d
agents
benchmark
clarification
tool-use

Contributors

xyzhu1225

4 commits

xyzhu1225/3D-Clarify

Dataset

Weixin Li,

1

4 commits

2 linked in READMEs

updated Jul 21, 2026

See the code

README

[ACM MM 2026] Clarify Before Executing: A Self-Evolving Agent for Resolving Intent Asymmetry in 3D Tool Orchestration

Xiaoye Zhu, Weixin Li, Junan Huo, Bozhong Wang, Jia Zeng, Yi Yang, Cen Chen, Qi Liu†

South China University of Technology
†Corresponding author

Paper | Project Page | Code | Benchmark | Source Assets

CLARE places a clarification gate before 3D tool execution, resolving ambiguity, missing information, and mistaken constraints through targeted dialogue. This release centers on the 3D-Clarify benchmark and a reproducible code-level evaluation pipeline for the paper's single-step and multi-step experiments.

CLARE framework and self-evolution pipeline

Highlights

  • Clarify before executing: four specialized components gate execution, maintain clarified state, synthesize 3D tool code, and communicate targeted feedback.
  • 3D-Clarify benchmark: 620 tasks across five 3D domains, each evaluated under ambiguity, missing-information, and mistaken-detail conditions.
  • Self-evolving clarification: simulated multi-turn interaction and Multi-turn Reward optimization raise task success to 60.40% on Single and 43.34% on Multi.

3D-Clarify Benchmark

3D-Clarify evaluates whether an interactive agent resolves intent asymmetry before producing 3D tool calls. It contains 620 interaction scenarios across text-to-3D generation, single-view reconstruction, multi-view reconstruction, point-cloud editing, and post-processing.

Each task provides a fully specified hidden goal and three controlled initial-query variants: ambiguity, missing information, and mistaken details. The paper evaluates these three variants, giving 1,500 single-step and 360 multi-step task-condition instances.

Overview of the 3D-Clarify benchmark

Dataset Splits

SplitTasksPaper evaluation unitsCompositionSHA-256
single5001,500Five domains, 100 tasks each056c890ac7b907e34db782c4ab44927d4f68a4116fc225d7e00aab419d770bb3
multi12036085 two-step and 35 three-step workflows868d4f2a843e17f608d54dc9befba858d546e05e3d2bac0d4bcd8063788ad94c
from datasets import load_dataset

dataset = load_dataset("xyzhu1225/3D-Clarify")
single_tasks = dataset["single"]
multi_tasks = dataset["multi"]

Record Schema

FieldDescription
idStable task identifier within the split
completeFully specified hidden user goal
ambiguousSemantically underspecified initial request
missing_infoInitial request with required values removed
mistakeInitial request containing one invalid or conflicting detail
mistake_typeControlled perturbation category used by mistake
file_pathSource-asset value used to instantiate path templates
ground_truthOrdered structured tool and parameter requirements
codeFixed ground-truth Executor calls used by CR/SR evaluation
gt_summaryLegacy provenance summary; not used by code evaluation

The paper reports Goal Completion Rate (CR) and Task Success Rate (SR) over ambiguous, missing_info, and mistake. Multi-step records preserve tool-call order and intermediate dependencies.

Resources

The source media is not required for the paper's deterministic code-level evaluation. It is distributed separately for users who enable physical 3D tool execution. The few-shot prompting examples used by baselines are part of the code repository and are intentionally not included in this benchmark dataset.

3d
agents
benchmark
clarification
tool-use

Contributors

xyzhu1225

4 commits