# Dify 1.17.0 — v1.17.0

- Product: Dify (https://whatsnew.fyi/product/dify)
- Vendor: LangGenius
- Date: 2026-08-25
- Version: 1.17.0
- Original notes: https://github.com/langgenius/dify/releases/tag/1.17.0
- Permalink: https://whatsnew.fyi/product/dify/releases/1.17.0

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **added** — Agent shell and code execution can now run on E2B cloud sandboxes in addition to local sandbox, selectable via DIFY_AGENT_RUNTIME_BACKEND environment variable
- **added** — Build-time Home Snapshots capture the agent's sandbox home directory state when an agent build is applied, restoring it for subsequent runs
- **added** — Workspace-level Skill management with draft → publish → version lifecycle for reusable, versioned capabilities that agents can discover and invoke
- **added** — Context-aware history compaction resolves each model's effective context window and tiers compaction to prevent long agent conversations from exceeding model limits
- **added** — Reusable LLM environment variables in workflows allow defining shared provider/model/mode/parameter configuration once and referencing it from any LLM node
- **added** — Human-in-the-loop forms now work inside Loop and Iteration nodes with correct pausing and resuming across page refreshes
- **added** — Opt-in unified tracing with OPS_TRACE_UNIFIED_ENABLED assembles full parent-child span tree across workflows, chatflows, messages, nodes, loops, iterations, and nested workflows
- **added** — New GenAI spans surface LLM TTFT, agent ReAct steps, tool calls, and failed LLM nodes for deeper observability
- **added** — Cloudflare Turnstile CAPTCHA support on sign-in and email-code login to protect authentication endpoints from abuse
- **added** — Azure Key Vault support for key provisioning, encryption, decryption, and key rotation configuration
- **added** — TiDB Vector deployments can enable full-text and hybrid retrieval with multilingual full-text index alongside vector search
- **added** — LLM nodes and agents can now pass image files directly to multimodal models
- **added** — New multimodal retrieval guidance helps users pick embedding models correctly for image-bearing knowledge bases
- **added** — Go to Anything command palette accessible via ⌘K or Ctrl+K to jump to apps, agents, skills, knowledge bases, plugins, workflow nodes, or trigger quick actions
- **added** — ODT (OpenDocument Text) document extraction support
- **added** — New date and date-picker parameter types for tool plugins
- **added** — Lao (lo-LA) language support
- **added** — Automatic cleanup task for old conversations with ENABLE_CONVERSATION_CLEANUP_TASK to bound data growth
- **added** — Marketplace embedded directly into integration categories for smoother tool and plugin discovery
- **fixed** — Non-vision attachments are no longer silently dropped from agent chats
- **changed** — Audio ASR now accepts audio/x-m4a MIME type and audio MIME types are validated more accurately
- **changed** — Workflow generator now prefers already-installed and configured tools when suggesting nodes
- **changed** — APP_MAX_EXECUTION_TIME and WORKFLOW_MAX_EXECUTION_TIME defaults raised from 1200s to 3600s to accommodate longer-running workflows
- **fixed** — Reproducible web workflow runs, preserved canvas state after history updates, and SSE streams now end cleanly on terminal events
- **fixed** — Stop is now honored between non-streaming nodes and paused workflows clear stale cancellation signals correctly
- **changed** — Large accessibility improvements including real button semantics, accessible names for icon-only actions, and keyboard-accessible selectors throughout the console

##### New Features

**Agent: E2B Sandbox, Home Snapshots, and Skill Management**
- **E2B sandbox backend**: agent shell/code execution can now run on [E2B](https://e2b.dev) cloud sandboxes in addition to the local sandbox. Select the backend with `DIFY_AGENT_RUNTIME_BACKEND`; a new `docker-compose.e2b.yaml` ships the E2B stack, E2B traffic is authenticated, and the E2B template is synced on release (#39480, #39705, #39873, #39996, #40858, #40871, #40891, #40892).
- **Build-time Home Snapshots**: when an agent build is applied (published), the agent's sandbox home directory — installed packages, prepared files, working state — is captured and subsequent runs of the published agent restore their home directory from that snapshot, so the agent starts from the exact filesystem state it had at build time. (#39702, #40876, #40996).
- **Workspace-level Skill management**: Skills are reusable, versioned capabilities packaged with code and tool definitions that agents can discover and invoke. A new workspace-level skills manager with draft → publish → version lifecycle ships alongside a web UI (skill listing, builder panel, file editor).  (#39675, #39798, #39799, #41180).
- **Context-aware history compaction**: long agent conversations no longer blow past the model's context window — Dify resolves each model's effective window and tiers compaction (clear old tool results first, then summarize older history) so runs stay within budget without losing recent context (#40872).

**Reusable LLM Environment Variables in Workflows**
- Define a shared provider/model/mode/parameter configuration once (e.g. `for_summarize`, `for_research`) and reference it from any LLM node. Coordinated model changes now happen in one place instead of drifting node-by-node, and the references survive DSL import/export, snippets, RAG pipelines, and collaborative editing (#39125).

**Human Input in Loops and Iterations**
- Human-in-the-loop forms now work *inside* Loop and Iteration nodes, pausing and resuming correctly across page refreshes for both debug and installed apps — enabling review/approval steps within repeated work (#39243).

**Provider-Neutral Unified Tracing**
- Opt-in unified tracing (`OPS_TRACE_UNIFIED_ENABLED`) assembles the full parent-child span tree (workflows, chatflows, messages, nodes, loops, iterations, nested workflows) once in core and delegates only transport to lightweight adapters. Phoenix and LangSmith adapters ship first; disabled by default and fully backward compatible (#39451).
- New GenAI spans surface LLM TTFT, agent ReAct steps, tool calls, and failed LLM nodes for deeper observability (#39339).

**Cloudflare Turnstile (CAPTCHA) Support**
- Optional Turnstile challenge on sign-in and email-code login to protect authentication endpoints from abuse, with configurable site/secret keys and allowed hostnames (#40494).

**Azure Key Vault / Pluggable KMS**
- Introduces a KMS provider abstraction with Azure Key Vault support for key provisioning, encryption, and decryption, plus key rotation configuration — a step toward externally-managed encryption keys (#39933).

**TiDB Vector Full-Text & Hybrid Search**
- TiDB Vector deployments can now enable full-text and hybrid retrieval (`TIDB_VECTOR_ENABLE_FULLTEXT_SEARCH`, default off), using a multilingual full-text index alongside vector search (#38112).

**Broader Model & File Handling**
- LLM nodes and agents can now pass image files directly to multimodal models, and non-vision attachments are no longer silently dropped from agent chats (#39848, #40179).
- New multimodal retrieval guidance helps users pick embedding models correctly for image-bearing knowledge bases (#40566).
- Audio ASR now accepts `audio/x-m4a`, and audio MIME types are validated more accurately (#40776, #41043).

**Go to Anything (⌘K / Ctrl+K)**
- Press ⌘K (Ctrl+K on Windows/Linux) anywhere in the console to open the command palette and jump to apps, agents, skills, knowledge bases, pl

_[Truncated at 4000 characters — full notes: https://github.com/langgenius/dify/releases/tag/1.17.0]_