Data-Juicer Agents: Towards Agentic Data Processing

August 6, 2026 ยท View on GitHub


Data-Juicer Agents: Towards Agentic Data Processing

A Suite of Agents for Agentic Data Processing. Built on Data-Juicer (DJ) and AgentScope.

็ฎ€ไฝ“ไธญๆ–‡ | English

๐Ÿ—๏ธ Overview Doc โ€ข โšก๏ธ Quick Start Doc โ€ข >_ CLI Doc โ€ข ๐Ÿ”ง Tools Doc โ€ข ๐ŸŽฏ Roadmap

News

  • ๐Ÿš€ [2026-03-11] Major refactor and upgrade of data_juicer_agents completed.

    • The project architecture and CLI/session capabilities were comprehensively redesigned for better maintainability and extensibility.
    • ๐Ÿ—๏ธ Overview | โšก๏ธ Quick Start | >_ CLI Doc | ๐Ÿ”ง Tools | ๐ŸŽฏ Roadmap
    • Try processing data by chatting with the agent!
  • ๐Ÿš€[2026-01-15] Q&A Copilot has been deployed on the official Doc Site | DingTalk | Discord of Data-Juicer. Feel free to ask Juicer anything related to the Data-Juicer ecosystem!

Roadmap

The long-term vision of DJ-Agents is to enable a development-free data processing lifecycle, allowing developers to focus on what to do rather than how to do it.

To achieve this vision, we are tackling two fundamental challenges:

  • Agents: How to design and build powerful agents specialized in data processing
  • Services & Tools: How to package these agents into ready-to-use, out-of-the-box products

We continuously iterate on both directions, and the roadmap may evolve accordingly as our understanding and capabilities improve.


Agents

  • Data-Juicer Data Processing Agent (DJ Process Agent) & Data-Juicer Code Development Agent (DJ Dev Agent)
  • We have stopped building scenario-specific data processing agents, and instead are building data processing tools for general-purpose agents. From there:
    • Hard-orchestrate these tools into capabilities, exposed as the djx CLI
    • Soft-orchestrate them through prompts, packaged as skills
    • Rely on agent self-orchestration to support conversational data processing

Services & Tools

  • Q&A Copilot: a Q&A assistant for the Data-Juicer ecosystem
  • InteRecipe: interactive data recipe construction through natural language
    • [2026-03-11]: the current ./interactive_recipe only shows workflow-based examples. The dj-agents CLI entry is already built and supports interactive data-recipe construction through natural language in the TUI. We are developing a frontend tool (studio) on top of this foundation as the next upgrade.

Priority Items

  • DJ Skills: use prompt-based soft orchestration to package tools into skills for general-purpose agents.
  • InteRecipe Studio: support interactive data recipe construction through natural language, with multi-dimensional data and result views.
  • Plan Tool: extend support for fuller Data-Juicer capability coverage, DJ Hub recipe matching, and more.
  • Dev Tool: stabilization testing and optimization

Long-term Directions

  • Continue building tools and skills for broader data-processing scenarios, enabling wider and more flexible applications.
    • RAG
    • Embodied Intelligence
    • Data Lakehouse architectures

Context Management

Session agents keep full tool results in the ReAct memory, which grows the prompt cost every turn and can overflow small-context models. DJ Agents now bounds the model context with three layers, all enabled by default:

  1. Tool-result compaction: deterministic, rule-based shrinking of large tool payloads before they enter memory (full payloads are still emitted through runtime events, so UIs and logs are unaffected).
  2. Memory compression: when the visible history exceeds the trigger budget, older messages are summarized and only the recent messages stay intact.
  3. Formatter hard budget: a final per-request truncation guarantees a single prompt never exceeds the configured window.

Configure via environment variables:

VariableDefaultMeaning
DJA_CONTEXT_WINDOW_TOKENS40000Model context window size in tokens
DJA_CONTEXT_TRIGGER_RATIO0.65Window fraction that triggers compression
DJA_CONTEXT_FORMATTER_RATIO0.85Window fraction for the formatter budget
DJA_CONTEXT_KEEP_RECENT10Recent messages kept intact on compression
DJA_CONTEXT_COMPRESSION_ENABLEDtrueToggle memory compression
DJA_TOOL_RESULT_COMPACTION_ENABLEDtrueToggle tool-result compaction
DJA_CONTEXT_CHAR_PER_TOKEN3Conservative chars-per-token estimate

For small-context deployments (30kโ€“50k windows), lower the window and ratios, e.g. DJA_CONTEXT_WINDOW_TOKENS=30000 DJA_CONTEXT_TRIGGER_RATIO=0.55 DJA_CONTEXT_FORMATTER_RATIO=0.80 DJA_CONTEXT_KEEP_RECENT=8.

To measure how much a specific tool payload saves, use:

djx debug token-usage <tool_name> --input-file payload.json --provider char
djx debug token-usage <tool_name> --input-file payload.json --provider qwen

--provider char runs fully offline with the local AgentScope char counter; --provider qwen reports real usage.prompt_tokens from an OpenAI-compatible endpoint.

Common Issues

Q: How to get DashScope API key? A: Visit DashScope official website to register an account and apply for an API key.

  • Data-Juicer has been used by a large number of Tongyi and Alibaba Cloud internal and external users, and has facilitated many research works. All code is continuously maintained and enhanced.

Welcome to visit GitHub, Star, Fork, submit Issues, and join the community!

Contributing: Welcome to submit Issues and Pull Requests to improve Data-Juicer Agents, Data-Juicer, and AgentScope. If you encounter problems during use or have feature suggestions, please feel free to contact us.