mirror of
https://github.com/langgenius/dify-docs.git
synced 2026-07-21 20:05:22 -04:00
main
902 Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
 Riskey
|
5396c1a1af |
docs: document 16 env vars missing from environments.mdx (#881)
* docs: document 16 env vars missing from environments.mdx - Dify CLI / programmatic API block (OPENAPI_*, ENABLE_OAUTH_BEARER, DEVICE_FLOW_APPROVE_RATE_LIMIT_PER_HOUR) with the two-switch requirement - MODE as an individual heading; Sentry and plugin-daemon direct names beside their documented Compose knobs; MARKETPLACE_URL; ENABLE_LEARN_APP; OPS_TRACE retry pair - en/zh/ja updated in the same pass Middleware-stack vars (EXPOSE_*, *_HOST_VOLUME) are postponed to the deploy docs restructure; post-1.15.0 vars go to the next release sync. * fix: state the unset-MODE fallback beside the shipped default Review follow-up: the Default line showed the worker env file's shipped value while the body said an unset MODE runs the API server; both facts now sit together on the Default line (en/zh/ja). * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> |
||
|
Riskey
|
9ae0d9d9e1 |
fix: converge zh/ja webapp guides with current en (#880)
- Retranslate zh embedding-in-websites from the current en source (cloud + self-host)
- Drop the stale best-practices section from zh/ja workflow-webapp (en removed it in
|
||
|
Riskey
|
9340d22e40 | docs: add disclaimer exception, EE-Tip renderings, NUL-safe checks (#879) | ||
|
Riskey
|
181b02b050 |
docs: extend the UI-repetition rule to discoverable behavior (#878)
The style guide's Repeating-the-UI rule covered visible elements but not interaction mechanics the interface teaches on first contact, so research-heavy rewrites kept re-documenting them. Cover discoverable behavior, add the consequential-fact exception (data loss, permissions, cost), point Information-noise at the rule instead of duplicating its UI clause, and gate the feature-research skill's scope recommendations on the same filter. |
||
|
Riskey
|
17ce877aa5 |
Release/1.16.0 (#848)
* docs: add New Agent user guide and node tab * docs: add ENABLE_AGENT_V2 to environment variable reference * translate: add zh and ja New Agent documentation * docs: add New Agent navigation groups * feat: add limits and quotas rule to style guide * docs: add skill and file upload limits to New Agent guide * fix: redirect new-agent doc paths from UI links to self-host pages * docs: add task examples and refine New Agent pages * docs: update New Agent data security notice per legal * docs: extend security notice coverage and build note explanation Surface the legal data security Warning on the Build page and New Agent node tab (en/zh/ja), and explain the build note as the agent's memory across build chats with an example. * docs: refine New Agent guidance and cross-link from classic Agent Model note gains the older-model sandbox symptom; node opener differentiates from the classic node; Build page restructured (review bullets, Info callout, section links) with zh/ja synced; classic Agent app page (self-host) gains a New Agent Tip. * docs: document memory, permissions, and sandbox facts for New Agent Verified additions: per-conversation memory bounded by the model's context window; Editor-tier permissions for creating and managing agents; unrestricted sandbox network access; version restore excludes the sandbox environment; build note deletion and regeneration behavior. * docs: rename Roster to Agent page across New Agent docs The UI removed the Roster concept; the nav entry is now Agent. Updated pages, node tab titles, image alt text, and the ENABLE_AGENT_V2 reference entry in en/zh/ja. Agent Console button labels are unchanged in the UI and stay verbatim. * docs: add files vs knowledge guidance and restructure page openers Decision aid for uploading as Files vs connecting a knowledge base (read-in-full vs search), knowledge opener gains relevance and workspace-asset framing, overview and build intros restructured. * docs: update docker compose container list and add tool prerequisites (#843) * docs: update docker compose container list and add tool prerequisites - Add api_websocket and init_permissions to the started-container list per the current compose defaults - Remove outdated sample outputs for docker compose up and docker compose ps - Add a callout noting the clone command requires git, curl, and jq, with recovery guidance on command not found errors - Mirror all changes to zh and ja * docs: note expected exited status for init_permissions container * fix: align tools page tab titles across languages and fix anchors Shorten the Swagger and Workflow tab titles ("Swagger API as Tool" -> "Swagger API", "Workflow as Tool" -> "Workflow") in en, zh, and ja so all three languages generate the same tab anchors. Update the inbound links in output.mdx that pointed at the old Workflow-tab anchor (#workflow-as-tool, #工作流作为工具, #ワークフローをツールとして利用) to #workflow. * feat: consolidate and restructure the API reference (Phase 1) (#846) * docs: correct HITL API integration flow and sync translations - Fix the claim that the resume endpoint differs per app type (same endpoint; only the entry endpoint differs) - Tie workflow_run_id guidance to the human_input_required event (chatflow message chunks don't carry it) - Require the same user when resuming the event stream (mismatch returns 404); add include_state_snapshot and continue_on_pause guidance - Note at the capture step that a null form_token means Email delivery - Soften the upload-time validation claim to file size limits - Split long paragraphs; align zh endpoint name with the reference page * fix: correct API references against verified backend behavior Audit of the Service API specs against dify hotfix/1.15.0-fix.1, with every change code-verified and the serious items adversarially confirmed. Applies to en/zh/ja. - Add curl samples for GET endpoints with required query params (Mintlify omits query params from generated snippets) - Document 401 once in every spec's auth scheme description - Correct wrong facts: workflow run detail returns inputs as a JSON string; DELETE /conversations requires a JSON body; audio-to-text accepts audio/{mp3,m4a,wav,amr,mpga} by MIME type; workflow log created_by_account filters by email; triggered_from values are app-run/webhook/schedule/plugin; stop endpoints' user semantics differ per app type - Remove unreachable docs: phantom text_replace SSE event, annotation 403, file preview endpoint in the workflow spec, invented score_threshold bounds - Make upload user optional (DEFAULT-USER fallback), fix upload response example, add missing invalid_param error - Declare text_to_speech.autoPlay in parameters responses (prose values, no response-field enums) * fix: complete API reference audit for knowledge and completion specs * feat: add API spec consolidation pipeline Phase-1 of the API docs consolidation: tooling that merges the five per-app-type Service API specs into one openapi_service.json per language, with every divergence resolved explicitly in resolutions.json and rendering-preserving namespacing for mode-scoped schema families. Includes the audit lint and parity checks (lint taught the new language-prefixed href scheme), hand-merged mode-aware SSE documentation for POST /chat-messages in en/zh/ja, and the New Agent (Beta) virtual nav group with code-verified mode notes. * feat: consolidate API reference into one spec per language Emit {en,zh,ja}/api-reference/openapi_service.json (82 ops, 130 components) from the audit-fixed per-app-type specs; wire docs.json to them with explicit per-app-type endpoint lists, x-mint.href URLs (/{lang}/api-reference/{tag}/{summary} with shared English slugs for in-place language switching), 265 redirects covering the legacy en and CJK URLs, per-app-type overview pages including New Agent (Beta), and rewritten legacy API links in 21 MDX bodies. The old five specs per language stay as pipeline input; they are no longer rendered. * fix: remove dead conversation_completed error from chat specs ConversationCompletedError is never raised anywhere at the verified 1.15.0 ref (7a4252b3de): controllers catch it, but no service code raises it, so the documented 400 conversation_completed can never fire. Remove the bullet and example from the chat and chatflow /chat-messages docs in en/zh/ja. Found and adversarially confirmed during the New Agent (PR #836) verification; filed on the upstream bug list. * feat: add membership matrix and restructure nav config * feat: rename resource tags and update all references * feat: stamp per-operation availability lines * feat: wire three-group API navigation * feat: add app-type page coverage lint * docs: rewrite chatflow overview as app-type API guide * docs: polish chatflow overview zh and ja wording * docs: rewrite workflow overview as app-type API guide * docs: align workflow overview details across languages * docs: expand new agent overview into app-type API guide * docs: use task-oriented heading on new agent overview * docs: rewrite chatbot and agent overview as app-type API guide * docs: rewrite text generator overview as app-type API guide * docs: match end user link text to merged spec summary * docs: rewrite knowledge overview as app-type API guide * docs: move knowledge api guide into api reference * docs: localize ui labels on knowledge overview * docs: refresh pipeline readme for restructure modes * docs: name app-type pages in the guides sidebar * feat: rename zh completion messages tag to match resource framing * docs: prototype endpoints-first layout on chatflow overview * docs: correct detail accuracy on chatflow overview * docs: move human input flow guide into api reference Move the shared HITL API integration walkthrough from its six per-product copies into {en,zh,ja}/api-reference/guides/human-input-flow as the first task guide in the API docs. Guides gains an App Types subgroup (expanded by default) with the flow guide after it; six redirects cover the old paths; the Human Input node docs and the chatflow overview link to the new home. * fix: update spec links to the moved human input guide * fix: let spec lint accept mdx guide pages under api-reference * docs: align chatflow zh and ja overviews to endpoints-first layout * docs: polish chatflow zh and ja mode terms and hitl wording * docs: align workflow overviews to endpoints-first layout * docs: document form expiry path in human input flow guide * docs: align new agent overviews to endpoints-first layout * docs: align chatbot and agent overviews to endpoints-first layout * docs: align text generator overviews to endpoints-first layout * docs: align knowledge overviews to endpoints-first layout * docs: correct built-in metadata examples and agent heading * docs: flatten app-type pages directly under guides * docs: make guide pages self-contained and trim reference detail * docs: add get started guide and retire developing-with-apis * docs: update new agent api behavior for latest main New Agent behavior re-verified against dify origin/main (f3ba2846): agent_thought events now stream through the Service API carrying the model's reasoning steps and tool calls; a new agent_not_published 400 fires on Send Chat Message and Get App Parameters; the files claim is softened to contents-not-processed (raw references now reach the prompt; runtime confirmation pending). Streaming-only, message_end metadata, and the endpoint surface are unchanged. * docs: audit fixes for get started and human input flow guides * docs: fix em dash spacing and ja sentence length in get started * docs: move message_end note to the send endpoint line * docs: update writing guides and API skill for app-type naming - Glossary and zh/ja translation guides: Workflow and Chatflow app types stay English (Workflow 应用 / Chatflow アプリ); lowercase workflow localizes to 工作流 / ワークフロー. - formatting-guide: API reference links use the language prefix with English slugs. - dify-docs-api-reference skill: Spec Structure documents source specs merged into openapi_service.json by the pipeline. * feat: add operation sidebar titles and simplify API redirects - merge_specs stamps x-mint.metadata.sidebarTitle per operation so translated summaries show in the sidebar. - Redirects reduced to a catch-all to the English API home plus three knowledge-base exceptions. - memberships, strings, and SSE overrides carry app-type labels (Workflow/Chatflow English, New Agent, API Overviews group). * docs: correct app-type naming and translations across API specs - English mode enum labels Chatflow and Workflow apps. - zh/ja app references use Workflow/Chatflow; New Agent is 新 Agent / 新しい Agent. - ja knowledge tag データセット becomes ナレッジベース; zh 模型提供商 becomes 模型供应商. - Regenerate merged openapi_service.json with per-operation sidebar titles. * docs: add streaming, errors, and end-user identity API guides - Consume Streaming Responses: response modes, SSE parsing, event dispatch, and reconnect. - Handle Errors and Rate Limits: the error envelope, status classes, and retry guidance. - End User Identity: what the user field scopes and why it stays consistent. - English source with zh and ja translations. * docs: reconcile API guides and apply app-type naming - Reader-test fixes and content audit on get-started and the app-type overview pages. - zh/ja reconciled to the English source. - Workflow/Chatflow and New Agent naming applied in prose. * feat: wire API nav and redirects for consolidated guides - Rename the guides group to API Overviews and register the new guide pages. - Redirects: catch-all to the English API home plus three product-embedded knowledge-base links to the Knowledge guide. * fix: normalize zh model-provider term to 模型供应商 Aligns the POSITION_PROVIDER_* descriptions with the canonical glossary term. * docs: use Info callouts for guide forward-link notes Wrap the authentication, base URL, and `user` field forward-reference in each app-type guide (agent, chat, chatflow, completion, workflow; en/zh/ja) in an `<Info>` callout. * refactor: remove one-time analyze mode and verification compose - Drop the `analyze` mode (design-time spec-overlap analysis) and its helpers; the merge is stable and nothing invokes it. - Delete `compose.swagger.yml`, the throwaway local code-vs-spec verification stack (flagged in review for inline credentials). - README: drop the analyze entry and correct the redirect description. * fix: correct Chatflow naming and reasoning wording in SSE overrides - Use "Chatflow" (English) for the app type in the `/chat-messages` SSE tables instead of 对话流/チャットフロー, and fix the legacy zh chatflow "对话流工作流" description. Standalone table cells were missed by the earlier app-type rename. - Describe `reasoning_chunk` as "reasoning content" in en/ja (matching the `reasoning` field and the zh wording) instead of "chain-of-thought". * docs: refine API guide wording and simplify the human-input example * docs: standardize Workflow and Chatflow app-type capitalization Capitalize Chatflow and Workflow when they name an app type; keep "workflow" lowercase for the general engine, graph, or run sense. * fix: use 供应商 for model provider in the zh Knowledge spec * fix: rename the Knowledge API nav group to "Knowledge APIs" * fix: un-deprecate Update Document by Text in the Knowledge spec * translate: un-deprecate Update Document by Text in zh/ja specs Mirror the en fix ( |
||
|
Riskey
|
13bfad21a6 |
docs: add surface-coverage gate to the feature-research skill (#877)
Research must account for every surface before concluding behavior: new Phase 1 step 6 requires per-surface files-read-or-N/A (backend, frontend UI, i18n labels, flags/env defaults, API, plugin SDK), the Phase 3 template carries the coverage table, and the routing table gains non-node frontend, i18n, and flags/env rows. |
||
|
Riskey
|
753efc15ae |
docs: add permission-gate and writing-skill notes to feature-research (#876)
* docs: feature-research — verify permission gates at the effective (frontend) layer * docs: apply review — name guide files, fold permission note into step 4 |
||
|
Riskey
|
2975506628 |
fix: align reverse invocation App signatures with the plugin SDK (#873)
The Reverse Invocation App page documented App invocation signatures that predate the removal of the top-level `files` argument, so every documented signature, and the Chat example, failed against current Python SDK releases (verified against v0.9.1). Corrected across the English, Chinese, and Japanese pages: drop the removed `files` argument from the Chat, Workflow, and Completion signatures; add the required `query` argument to Chat and to the Chat example; mark `conversation_id` optional; add the optional `user` argument; and show the `response_mode` defaults (`streaming` for Chat, `blocking` for Workflow and Completion). Signatures now match the SDK runtime definitions. Closes #872 Closes DC-27 |
||
|
Riskey
|
00e19bfa0e | fix: redirect unprefixed legacy URLs to their /en pages (#871) | ||
|
Riskey
|
97e3dff52d | docs: forbid bare see-x cross-references in style guide (#870) | ||
|
Riskey
|
23145613cf |
Docs/skills reliability (#869)
* feat: single-source safe codebase sync + complete skill routing * feat: merge format-check twins into path-routed dify-docs-format-check * fix: release-sync — single-spec API track, verified detection tables, public scope signals * fix: env-vars — dual-source verification, safe sync pointer, internal notes moved out * fix: api-reference — one verified AppMode table, wired coverage tooling, batch STOP gate * fix: guides — numbered gated workflow, per-copy IA rules, named check chain * fix: terminology-check — executable lookup recipes * fix: feature-research — single-source ownership routing, verified pin workflow * fix: cli-docs — verified source paths, public-appropriate pointers, concrete checks * fix: reader-test — enforced clean-context dispatch template * fix: style guide — per-copy paid-feature and limits patterns * chore: regenerate termbase from glossary; correct api-pipeline README exit-code claim * docs: state backport eligibility floor in BACKPORT.md * fix: zsh-scope the revspec caveat, complete the callout example, merged-state check * fix: fixed-string term lookups, printed-count gate, unambiguous release refs |
||
|
Riskey
|
d09da04622 |
docs: release-sync — multi-pass scoping, milestone cross-check, release branch targeting (#865)
* docs: release-sync — multi-pass scoping, milestone cross-check, release branch targeting * fix: separate milestone issues from the PR range cross-check * fix: milestone query includes closed milestones; copy-safe placeholders * fix: distinguish merged from closed-unmerged milestone PRs in the cross-check * fix: allow pinned release-branch SHA pre-tag; name the docs integration branch |
||
|
Riskey
|
51be4e7cae |
fix: repair MT-corrupted sentences in the webapp guides (zh/ja) (#866)
Five passages from the revamp-era MT batch had dropped spans or truncated sentences (workflow-webapp and chatflow-webapp, both audience trees). Each is retranslated from the current en source; everything else in the publish/webapp family verified clean against en. |
||
|
Riskey
|
5575764827 |
fix: converge drifted content between the cloud and self-host trees (#862)
* fix: converge drifted content between the cloud and self-host trees Eight pairs had real drift (missed cross-tree syncs, mostly #820's cleanup never carried to cloud): Introduction-heading removals and webhook rewording, the 1.15.0 integrations rename, a missing #mcp anchor, utilize->use, apostrophe and ja terminology/spacing alignment. After this, every mapped pair differs only in deliberate audience-specific content. * fix: plan-gating callouts — add conjunctions, align zh with en, drop audience restatements |
||
|
Riskey
|
00c3cc3913 |
fix: use Workflow/Chatflow for zh/ja app-type terms and correct CLI pause scope (#860)
* fix: use Workflow/Chatflow for zh/ja app-type mentions Converts translated app-type terms (对话流/聊天流/チャットフロー and app-type 工作流/ワークフロー compounds) to the English product names per the writing rules, syncs headings, nav labels, and stale anchors, fixes CJK spacing around the insertions, and codifies the UI-quote exception in the zh/ja formatting guides. * translate: localize human-input form examples in zh/ja form_content and user_actions titles are author-written display strings, so the zh/ja examples now show them in the reader's language, coherent across the get-form, submit, and SSE-event examples. Identifiers, option values, and status enums stay verbatim. * fix: CLI pause docs cover Chatflow apps too difyctl raises the HITL pause for every app mode (the check precedes mode dispatch in cli/src/commands/run/app/sse-collector.ts, and resume is form-token based), so the pause sections now name Workflow and Chatflow apps in en/zh/ja. Also carries the zh/ja app-type term conversion for the CLI pages. * fix: match action_text to localized titles and add bold spacing Copilot review: the localized SSE examples' human_input_form_filled events now carry the localized action title in action_text (the wire field holds the executed action's title, per the web client mapping), and the zh integrate-knowledge bold app-type terms get the required CJK-adjacency spaces. |
||
|
Riskey
|
d0f7f1bbb6 |
feat: rebuild the doc issue form for triage (#861)
* feat: rebuild the doc issue form for triage * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> |
||
|
Riskey
|
267089b359 |
feat: retire the auto-translation pipeline (#854)
* feat: retire the auto-translation pipeline * fix: drop the Dify-API translator and align the navigation guideline * fix: remove unused pipeline-era config and the translation A/B test framework * fix: retire remaining pipeline references in glossary, env-vars skill, termbase tool |
||
|
Riskey
|
6aa0ae4661 |
feat: finish API reference Phase 1: code audit and readability overhaul (#857)
* feat: retire the merge pipeline and delete the legacy source specs openapi_service.json is now the spec of record per language, edited directly. The build/relink modes, resolutions.json, and overrides/ that consolidated the five per-app-type specs are recoverable from git history when Phase 2 rebuilds the spec from the upstream-generated source. * fix: make parity_check exit nonzero on failures * docs: document the direct-edit spec workflow in skills and translation guides * fix: correct the Service API reference against the code-verified audit Applies the confirmed findings of a full per-operation audit against dify 3c8e0e2113 / graphon 0.6.0: 9 factual errors (availability lines, phantom fields, wrong enum values, inert parameters, wrong error messages), ~33 omitted-error and example-accuracy gaps, the rate_limit_error recharacterization, provider-identifier format documentation, and New Agent availability on the endpoints its Chat Features support (verified end-to-end in code). * docs: document New Agent's full endpoint surface in the API guides * translate: propagate the Service API audit fixes to zh and ja * docs: rewrite Upload File as the readability pilot Worked example of the API readability standard: contract-first description, facts on the fields (category size limits with env-var link, blacklist rule), real error triggers (415 corrected to its actual cause), template user sentence, source links on sourceable values, and a hand-written multipart cURL sample. Applied to en/zh/ja. * docs: update spec-conventions for the live link scheme and code samples * docs: apply the readability standard across the Service API reference Rewrites all 82 operations to the agreed standard in en/zh/ja: contract-first descriptions, facts on the fields, trigger-led error bullets, template sentences (user, pagination, provider identifiers), source links on sourceable values, guide links instead of inline concept re-explanations, cURL samples where the playground autogen fails (multipart, SSE), a paragraph ceiling everywhere, and restructured streaming narratives (events-by-app-type map; details stay in the event tables). Also folds in two fact corrections surfaced during review: the legacy securitySchemes text and the stale Cloudflare-timeout claim in response_mode, now using the hedged edge-proxy wording. * docs: codify the readability standard and audit method in the API skill * fix: apply the audit-verified corrections deferred from the readability pass Small factual items evidenced in the audit findings that the readability pass could not touch under its fact-freeze: real wire messages (audio 413, type_mismatch number, dynamic run-by-id 404, werkzeug 500/403 strings, annotation 404 punctuation), schema precision (format: uuid, minimum: 1, six missing Get Available Models response fields), and behavioral completeness (document download/zip/delete 404 message variants, tag_ids silent-ignore note, request-scoped batch-metadata lock wording, reasoning_chunk message_id: null, form default key absent not null). Applied to en/zh/ja; parity 0. * fix: make spec checkers target openapi_service.json explicitly After the legacy specs were deleted, the openapi_*.json globs in parity_check and lint_specs would silently pass (match nothing, report 0 issues, exit 0) if the spec of record went missing, and would pick up unintended future openapi_*.json files. Both now name openapi_service.json per language and exit 1 when it is absent. * fix: address Copilot review on pipeline tooling and example titles Normalizes example summary separators to the dominant "Request Example - Mode" form (the convention doc had drifted, and 4 em-dash outliers existed per language); lint_specs no longer re-reads the spec it already loaded; all spec reads use explicit UTF-8; coverage_matrix and swagger_diff target openapi_service.json explicitly; README and docstring usage resolve DOCS from the git root so the commands work from any directory. * fix: use context managers for all pipeline file reads Copilot flagged unclosed handles in the three checkers; applied consistently across all five pipeline scripts (merge_specs and coverage_matrix had the same pattern unflagged). * fix: report missing spec ops as coverage failures instead of crashing * fix: print the full relative path in the parity missing-file message |
||
|
Riskey
|
476c02b9d7 |
docs: apply the ready-to-use vs custom knowledge rebrand to Cloud docs (#853)
* docs: apply the ready-to-use vs custom knowledge rebrand to Cloud docs
Cloud 1.15.0 ships the same KB creation redesign as CE 1.15.0: the two create entry points are now Create a ready-to-use knowledge base and Build a custom knowledge base, reached through Knowledge > Create. Mirror the self-host rename (
|
||
|
Riskey
|
c0664dacc5 | fix: hedge the Dify Cloud edge-proxy timeout claim in the streaming guide (#851) | ||
|
Riskey
|
63b392da48 |
fix: update New Agent env docs for the bundled development secret key (#849)
* fix: update New Agent secret key docs for the bundled development default feat/agent-v2 now ships a valid development key for DIFY_AGENT_SERVER_SECRET_KEY in .env.example and the Compose fallback, so the backend starts out of the box; the old claim that an invalid placeholder blocks startup no longer holds. Reframe the entry around replacing the publicly known key before production, scope the startup failure to malformed values, and soften the guide callouts from a start prerequisite to production hardening. Replace the stale remaining-variables sentence with a table covering all 11 DIFY_AGENT_* plumbing vars, defaults verified against feat/agent-v2. en/zh/ja. * chore: cover secret-value false positives in the env-var verifier Add DIFY_AGENT_SERVER_SECRET_KEY to the ignored-vars false-positives bucket (docs describe the pre-filled development key instead of reproducing it) and refresh the stale ENABLE_AGENT_V2 entry, now superseded by NEXT_PUBLIC_ENABLE_AGENT_V2 and removed from .env.example on feat/agent-v2. Fix the verifier so the ignore list also applies to the default-mismatch check, which previously bypassed it. |
||
|
Riskey
|
7ccb166cb6 |
Docs/new agent experience (#841)
* docs: add New Agent user guide and node tab
* docs: add ENABLE_AGENT_V2 to environment variable reference
* translate: add zh and ja New Agent documentation
* docs: add New Agent navigation groups
* feat: add limits and quotas rule to style guide
* docs: add skill and file upload limits to New Agent guide
* fix: redirect new-agent doc paths from UI links to self-host pages
* docs: add task examples and refine New Agent pages
* docs: update New Agent data security notice per legal
* docs: extend security notice coverage and build note explanation
Surface the legal data security Warning on the Build page and New Agent node tab (en/zh/ja), and explain the build note as the agent's memory across build chats with an example.
* docs: refine New Agent guidance and cross-link from classic Agent
Model note gains the older-model sandbox symptom; node opener differentiates from the classic node; Build page restructured (review bullets, Info callout, section links) with zh/ja synced; classic Agent app page (self-host) gains a New Agent Tip.
* docs: document memory, permissions, and sandbox facts for New Agent
Verified additions: per-conversation memory bounded by the model's context window; Editor-tier permissions for creating and managing agents; unrestricted sandbox network access; version restore excludes the sandbox environment; build note deletion and regeneration behavior.
* docs: rename Roster to Agent page across New Agent docs
The UI removed the Roster concept; the nav entry is now Agent. Updated pages, node tab titles, image alt text, and the ENABLE_AGENT_V2 reference entry in en/zh/ja. Agent Console button labels are unchanged in the UI and stay verbatim.
* docs: add files vs knowledge guidance and restructure page openers
Decision aid for uploading as Files vs connecting a knowledge base (read-in-full vs search), knowledge opener gains relevance and workspace-asset framing, overview and build intros restructured.
* docs: update docker compose container list and add tool prerequisites (#843)
* docs: update docker compose container list and add tool prerequisites
- Add api_websocket and init_permissions to the started-container list per the current compose defaults
- Remove outdated sample outputs for docker compose up and docker compose ps
- Add a callout noting the clone command requires git, curl, and jq, with recovery guidance on command not found errors
- Mirror all changes to zh and ja
* docs: note expected exited status for init_permissions container
* fix: align tools page tab titles across languages and fix anchors
Shorten the Swagger and Workflow tab titles ("Swagger API as Tool" ->
"Swagger API", "Workflow as Tool" -> "Workflow") in en, zh, and ja so all
three languages generate the same tab anchors. Update the inbound links in
output.mdx that pointed at the old Workflow-tab anchor (#workflow-as-tool,
#工作流作为工具, #ワークフローをツールとして利用) to #workflow.
* feat: consolidate and restructure the API reference (Phase 1) (#846)
* docs: correct HITL API integration flow and sync translations
- Fix the claim that the resume endpoint differs per app type (same
endpoint; only the entry endpoint differs)
- Tie workflow_run_id guidance to the human_input_required event
(chatflow message chunks don't carry it)
- Require the same user when resuming the event stream (mismatch
returns 404); add include_state_snapshot and continue_on_pause
guidance
- Note at the capture step that a null form_token means Email delivery
- Soften the upload-time validation claim to file size limits
- Split long paragraphs; align zh endpoint name with the reference page
* fix: correct API references against verified backend behavior
Audit of the Service API specs against dify hotfix/1.15.0-fix.1, with
every change code-verified and the serious items adversarially
confirmed. Applies to en/zh/ja.
- Add curl samples for GET endpoints with required query params
(Mintlify omits query params from generated snippets)
- Document 401 once in every spec's auth scheme description
- Correct wrong facts: workflow run detail returns inputs as a JSON
string; DELETE /conversations requires a JSON body; audio-to-text
accepts audio/{mp3,m4a,wav,amr,mpga} by MIME type; workflow log
created_by_account filters by email; triggered_from values are
app-run/webhook/schedule/plugin; stop endpoints' user semantics
differ per app type
- Remove unreachable docs: phantom text_replace SSE event, annotation
403, file preview endpoint in the workflow spec, invented
score_threshold bounds
- Make upload user optional (DEFAULT-USER fallback), fix upload
response example, add missing invalid_param error
- Declare text_to_speech.autoPlay in parameters responses (prose
values, no response-field enums)
* fix: complete API reference audit for knowledge and completion specs
* feat: add API spec consolidation pipeline
Phase-1 of the API docs consolidation: tooling that merges the five per-app-type Service API specs into one openapi_service.json per language, with every divergence resolved explicitly in resolutions.json and rendering-preserving namespacing for mode-scoped schema families. Includes the audit lint and parity checks (lint taught the new language-prefixed href scheme), hand-merged mode-aware SSE documentation for POST /chat-messages in en/zh/ja, and the New Agent (Beta) virtual nav group with code-verified mode notes.
* feat: consolidate API reference into one spec per language
Emit {en,zh,ja}/api-reference/openapi_service.json (82 ops, 130 components) from the audit-fixed per-app-type specs; wire docs.json to them with explicit per-app-type endpoint lists, x-mint.href URLs (/{lang}/api-reference/{tag}/{summary} with shared English slugs for in-place language switching), 265 redirects covering the legacy en and CJK URLs, per-app-type overview pages including New Agent (Beta), and rewritten legacy API links in 21 MDX bodies. The old five specs per language stay as pipeline input; they are no longer rendered.
* fix: remove dead conversation_completed error from chat specs
ConversationCompletedError is never raised anywhere at the verified 1.15.0 ref (7a4252b3de): controllers catch it, but no service code raises it, so the documented 400 conversation_completed can never fire. Remove the bullet and example from the chat and chatflow /chat-messages docs in en/zh/ja. Found and adversarially confirmed during the New Agent (PR #836) verification; filed on the upstream bug list.
* feat: add membership matrix and restructure nav config
* feat: rename resource tags and update all references
* feat: stamp per-operation availability lines
* feat: wire three-group API navigation
* feat: add app-type page coverage lint
* docs: rewrite chatflow overview as app-type API guide
* docs: polish chatflow overview zh and ja wording
* docs: rewrite workflow overview as app-type API guide
* docs: align workflow overview details across languages
* docs: expand new agent overview into app-type API guide
* docs: use task-oriented heading on new agent overview
* docs: rewrite chatbot and agent overview as app-type API guide
* docs: rewrite text generator overview as app-type API guide
* docs: match end user link text to merged spec summary
* docs: rewrite knowledge overview as app-type API guide
* docs: move knowledge api guide into api reference
* docs: localize ui labels on knowledge overview
* docs: refresh pipeline readme for restructure modes
* docs: name app-type pages in the guides sidebar
* feat: rename zh completion messages tag to match resource framing
* docs: prototype endpoints-first layout on chatflow overview
* docs: correct detail accuracy on chatflow overview
* docs: move human input flow guide into api reference
Move the shared HITL API integration walkthrough from its six per-product
copies into {en,zh,ja}/api-reference/guides/human-input-flow as the first
task guide in the API docs. Guides gains an App Types subgroup (expanded
by default) with the flow guide after it; six redirects cover the old
paths; the Human Input node docs and the chatflow overview link to the
new home.
* fix: update spec links to the moved human input guide
* fix: let spec lint accept mdx guide pages under api-reference
* docs: align chatflow zh and ja overviews to endpoints-first layout
* docs: polish chatflow zh and ja mode terms and hitl wording
* docs: align workflow overviews to endpoints-first layout
* docs: document form expiry path in human input flow guide
* docs: align new agent overviews to endpoints-first layout
* docs: align chatbot and agent overviews to endpoints-first layout
* docs: align text generator overviews to endpoints-first layout
* docs: align knowledge overviews to endpoints-first layout
* docs: correct built-in metadata examples and agent heading
* docs: flatten app-type pages directly under guides
* docs: make guide pages self-contained and trim reference detail
* docs: add get started guide and retire developing-with-apis
* docs: update new agent api behavior for latest main
New Agent behavior re-verified against dify origin/main (f3ba2846):
agent_thought events now stream through the Service API carrying the
model's reasoning steps and tool calls; a new agent_not_published 400
fires on Send Chat Message and Get App Parameters; the files claim is
softened to contents-not-processed (raw references now reach the prompt;
runtime confirmation pending). Streaming-only, message_end metadata, and
the endpoint surface are unchanged.
* docs: audit fixes for get started and human input flow guides
* docs: fix em dash spacing and ja sentence length in get started
* docs: move message_end note to the send endpoint line
* docs: update writing guides and API skill for app-type naming
- Glossary and zh/ja translation guides: Workflow and Chatflow app types stay English (Workflow 应用 / Chatflow アプリ); lowercase workflow localizes to 工作流 / ワークフロー.
- formatting-guide: API reference links use the language prefix with English slugs.
- dify-docs-api-reference skill: Spec Structure documents source specs merged into openapi_service.json by the pipeline.
* feat: add operation sidebar titles and simplify API redirects
- merge_specs stamps x-mint.metadata.sidebarTitle per operation so translated summaries show in the sidebar.
- Redirects reduced to a catch-all to the English API home plus three knowledge-base exceptions.
- memberships, strings, and SSE overrides carry app-type labels (Workflow/Chatflow English, New Agent, API Overviews group).
* docs: correct app-type naming and translations across API specs
- English mode enum labels Chatflow and Workflow apps.
- zh/ja app references use Workflow/Chatflow; New Agent is 新 Agent / 新しい Agent.
- ja knowledge tag データセット becomes ナレッジベース; zh 模型提供商 becomes 模型供应商.
- Regenerate merged openapi_service.json with per-operation sidebar titles.
* docs: add streaming, errors, and end-user identity API guides
- Consume Streaming Responses: response modes, SSE parsing, event dispatch, and reconnect.
- Handle Errors and Rate Limits: the error envelope, status classes, and retry guidance.
- End User Identity: what the user field scopes and why it stays consistent.
- English source with zh and ja translations.
* docs: reconcile API guides and apply app-type naming
- Reader-test fixes and content audit on get-started and the app-type overview pages.
- zh/ja reconciled to the English source.
- Workflow/Chatflow and New Agent naming applied in prose.
* feat: wire API nav and redirects for consolidated guides
- Rename the guides group to API Overviews and register the new guide pages.
- Redirects: catch-all to the English API home plus three product-embedded knowledge-base links to the Knowledge guide.
* fix: normalize zh model-provider term to 模型供应商
Aligns the POSITION_PROVIDER_* descriptions with the canonical glossary term.
* docs: use Info callouts for guide forward-link notes
Wrap the authentication, base URL, and `user` field forward-reference in each app-type guide (agent, chat, chatflow, completion, workflow; en/zh/ja) in an `<Info>` callout.
* refactor: remove one-time analyze mode and verification compose
- Drop the `analyze` mode (design-time spec-overlap analysis) and its helpers; the merge is stable and nothing invokes it.
- Delete `compose.swagger.yml`, the throwaway local code-vs-spec verification stack (flagged in review for inline credentials).
- README: drop the analyze entry and correct the redirect description.
* fix: correct Chatflow naming and reasoning wording in SSE overrides
- Use "Chatflow" (English) for the app type in the `/chat-messages` SSE tables instead of 对话流/チャットフロー, and fix the legacy zh chatflow "对话流工作流" description. Standalone table cells were missed by the earlier app-type rename.
- Describe `reasoning_chunk` as "reasoning content" in en/ja (matching the `reasoning` field and the zh wording) instead of "chain-of-thought".
* docs: refine API guide wording and simplify the human-input example
* docs: standardize Workflow and Chatflow app-type capitalization
Capitalize Chatflow and Workflow when they name an app type; keep "workflow" lowercase for the general engine, graph, or run sense.
* fix: use 供应商 for model provider in the zh Knowledge spec
* fix: rename the Knowledge API nav group to "Knowledge APIs"
* fix: un-deprecate Update Document by Text in the Knowledge spec
* translate: un-deprecate Update Document by Text in zh/ja specs
Mirror the en fix (
|
||
|
Riskey
|
884f481509 |
fix: correct Agent app knowledge retrieval docs (#838)
Agent apps never exposed the app-level Retrieval Setting control. The Dify frontend has gated it behind `!isAgent` since v0.5.0, and the backend forces single-mode retrieval per knowledge base (each base becomes a DatasetRetrieverTool the agent invokes). The "Configure App-Level Retrieval Settings" section documented a button that does not exist for this app type. Remove that section from the Agent build pages across en/zh/ja, and add a short note explaining that each knowledge base is retrieved independently with its own settings, with no cross-base reranking. The knowledge-base introduction and metadata filtering, which are correct for agents, remain. |
||
|
Riskey
|
2f88f0f7d2 |
docs: sync Cloud documentation for Dify 1.15.0 (#835)
* docs: add Human Input file inputs and Service API to Cloud docs Port the Phase 2 Human Input docs (file inputs and the Service API integration flow) to the Cloud docs, mirroring the self-host pages. - human-input.mdx (en/zh/ja): add the Single File / File List field type and the file-handling notes; the upload-limit callout states Cloud's fixed limits (documents 15 MB, images 10 MB, audio 50 MB, video 100 MB, up to 10 files) instead of self-host env vars. - hitl-api-integration-flow.mdx (en/zh/ja): new; identical to self-host since the Service API is the same. - docs.json: nest the integration-flow under the Human Input group in all three navs. - zh/ja reuse the self-host translations; only the callout and the /self-host/ links changed. * docs: rewrite Cloud model providers around AI Credits * docs: rewrite Cloud subscription management for 1.15.0 * docs: update Cloud code node limits and XLSX image extraction note * docs: rewrite Cloud team members management for 1.15.0 * docs: apply the 1.15.0 Integrations redesign to Cloud docs * docs: fix workflow API reference for run-level logs and streaming * docs: sync self-host use-dify pages and fix translation debt * docs: align shared tutorials and quick start with 1.15.0 * docs: refine difyctl install examples and workspace reference * docs: rewrite hotkeys page to match current shortcuts * fix: correct broken anchor links for badged headings and tabs * fix: correct env link and Human Input resume identifier * feat: handle heading badges in link-checker slugs * fix: repoint publish-mcp cross-links to the merged MCP section * docs: rename plugin dev CLI to Dify Plugin CLI * docs: refine CLI reference readability and expand --agent * feat: stop format checkers flagging indented list-item content * fix: correct zh/ja custom-endpoint spacing and a list blank line * docs: clarify Cloud model provider install and AI Credits coverage |
||
|
Riskey
|
d403e19e7a |
refactor: optimize dify-docs skills and fix CJK anchor checking (#833)
* refactor: optimize dify-docs skills for agent execution Restructure the API-reference and release-sync skills into a workflow plus on-demand references, and tighten the rest, so agents execute them more accurately. - api-reference: SKILL.md is now a 5-step workflow; formatting rules consolidated into one spec-conventions.md (was triplicated across SKILL, audit-checklist, common-mistakes); common-mistakes.md removed - release-sync: detection tables and report template moved to references/; duplicate "Common Mistakes" table dropped; scope-pinning rule promoted to a callout - env-vars: fix the stale "3-section" doc-structure claim; dedup the source-of-truth rule - format-check-en/cjk: collapse the rule catalogs that restated the script; fix SKIP_TEXTS -> SKIP_ING_HEADINGS; reconcile output format with the script - cli-docs: add a workflow spine; surface the origin/main verification rule - feature-research, guides: minor dedup and a softened git-pull line * fix: handle CJK heading anchors in the internal link checker The slugify in tools/check-links.py stripped non-ASCII punctuation, so full-width colons in zh/ja headings were dropped from the computed anchor while Mintlify keeps them, producing false "broken anchor" reports. Keep non-ASCII characters and strip only ASCII punctuation. - document the CJK anchor behavior in formatting-zh.md and formatting-ja.md - fix the real broken anchors the corrected checker surfaced (ja user-input, zh cli error-handling) * docs: clarify slugify behavior and CJK anchor wording per review |
||
|
Riskey
|
5ec724ee6d |
docs: clarify difyctl reference and agent auth wording (#831)
- reference/apps: drop the inaccurate "per-node" qualifier on metadata.reasoning - reference/auth-and-contexts: rename the "sealed-file" fallback to "protected file" - integrate-agents/auth-for-agent-deployments: point the keychain dead-end to sign-in Option 1 |
||
|
Riskey
|
91175d97c9 | fix: remove the duplicated ja text block from the human input node page (#829) | ||
|
Riskey
|
7694a26233 |
docs: document Human Input file inputs and Service API for self-host (#826)
* docs: document Human Input file inputs and API flow for self-host
Cover the Human Input node's file-handling additions in the self-host tree: the Single File and File List field types, how file values render as `[file]` / `[N files]` placeholders in `__rendered_content`, and referencing an upstream file variable in Form Content.
Add an API Integration Flow page for the Service API sequence (run, get form, upload via Upload File, submit, resume listening), register it in the self-host nav, add the Single File and File List glossary entries, and refresh the example images.
Verified against dify 1.15.0 and graphon 0.5.3. Self-host only; the Cloud tree is updated separately.
* docs: align Human Input API with HITL-2 form inputs
Update the Human Input endpoints in the workflow and chatflow Service API specs to dify 1.15.0. Document file-mapping submit inputs, where a `file` or `file-list` value is `{transfer_method: local_file, upload_file_id}` (the id from Upload File) or `{transfer_method: remote_url, url}`, and replace the stale `text_input` type with the real `paragraph`, `select`, `file`, and `file-list` values in both the get-form response and the streaming `human_input_required` event.
Make `expiration_time` nullable, drop the unenforced `action` length and pattern constraints, and align the zh delivery-method term with the product UI (提交方式).
* docs: clarify WORKFLOW_FILE_UPLOAD_LIMIT as a per-field cap
The old description read it as the maximum files per workflow execution. It actually bounds the max-files setting on a single file-upload field, such as a User Input or Human Input File List; the node panel's slider is capped at this value. Reword across en, zh, and ja.
* feat: add code-audit step to api-reference skill
Require an independent subagent audit against the codebase after writing or substantially changing endpoints. The brief pins the dify tag and the pinned graphon version, loads the skill references, and calls out the Service-API-vs-web/console controller distinction so the auditor verifies against the blueprint whose base URL matches the spec's servers.
* docs: document file submission details for Human Input API
Following the in-product docs PR (langgenius/dify#37981) and verified against dify 1.15.0 and graphon 0.5.3: a submitted file object carries a `type` from the field's `allowed_file_types`; a `local_file` upload must use the same `user` as the submit, since uploaded files are scoped to that user; and the get-form and submit examples now cover all four input shapes (paragraph, select, file, file-list).
* feat: harden api-reference audit with data-path and example checks
Add two guards to the post-writing code audit: trace opaque request fields to their resolver for ownership and cross-request rules, and diff the spec against the in-product API templates when the endpoint exists there. Add a mechanical example-and-schema consistency pass that checks example keys against schema fields and that every enum and `oneOf` branch is exercised.
* docs: address PR review feedback on Human Input docs
* docs: clarify Human Input API integration flow
Apply reader-test findings and a code-verified correction to the integration flow page and the workflow/chatflow specs.
- Spell out the submit lifecycle: a successful submit is one-shot (closes the form, resumes the run), a rejected one leaves the form open to retry, and the `action` must be one of the form's actions.
- Note the form's `expiration_time` and that the resumed run streams through to completion.
- Make the remote-file mapping concrete (`{transfer_method: remote_url, url}`).
- Soften the file-upload `user` rule to a consistent-`user` recommendation across the run, upload, and submit (verified: the submit `user` is not matched against the run), in the page and both specs.
- Mirror every change into zh and ja.
* fix: correct field name in zh/ja invalid_form_data examples
The zh/ja error examples still referenced `comment`; the earlier fix only caught the English message. Match the `feedback` request example.
|
||
|
Riskey
|
be7a66a0de |
Merge pull request #825 from langgenius/release/1.15.0
release: promote release/1.15.0 to main |
||
|
RiskeyL
|
707e4eb755 |
docs: clarify difyctl version requirement and unify install options
- Add a prerequisite note: difyctl requires Dify 1.15.0 or later - Reframe version matching around DIFY_VERSION (drop the circular difyctl version check) - Consolidate the three install env vars into one options table |
||
|
RiskeyL
|
722d75c4f4 | fix: fix the web app access broken links | ||
|
RiskeyL
|
2c01e9fd14 | merge main into release/1.15.0 (content already superseded by the restructure) | ||
|
RiskeyL
|
bd386e1f46 | fix: clarify code/template output limits are enforced by api/worker | ||
|
RiskeyL
|
1069ae750e |
fix: keep web-app-access reachable after the docs split
Restore the en/zh/ja pages at the cloud/ path the split redirect targets, so the old /use-dify/ URLs resolve instead of 404ing. Kept out of docs.json so they stay unlisted; temporary until they move to the EE repo. |
||
|
RiskeyL
|
ddf0e1f193 | fix: localize the api-reference link on the zh and ja home pages | ||
|
RiskeyL
|
129870e924 |
translate: sync reasoning docs to zh and ja
Translate the LLM node reasoning section and the reasoning_chunk API additions for zh and ja. Also corrects pre-existing broken hyphenated api-reference cross-links in the zh workflow spec. |
||
|
RiskeyL
|
9ed452fe19 |
docs: document reasoning_chunk streaming event in the API reference
Register the event in the chatflow and workflow specs (schema, enum, discriminator, and inline examples), add resumed-run streaming examples to the Stream Workflow Events endpoints, and make top-level created_at consistent across the chatflow streaming examples. |
||
|
RiskeyL
|
36378e6e2e | docs: document reasoning tag separation on the LLM node | ||
|
RiskeyL
|
80c6e30dd8 |
docs: surface Integrations on the self-host Use overview
The navigation refactor split the workspace section into Integrations and Workspace, but the Use overview still carded only Workspace and listed model providers under it. Add an Integrations card linking to the hub and drop the sparse Workspace card. Self-host only; Cloud keeps its combined Workspace section. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|
Riskey
|
08fb81c42b |
docs: add difyctl CLI documentation (#824)
* docs: add difyctl CLI documentation Adds the difyctl doc set under Self-Host > Developer Resources > CLI (en/cli/), Community Edition only for the CE-first launch; the Cloud nav does not reference the CLI yet. - Aligns the version reference with the 1.15.0 compat window and alpha channel (PR #37794). - Keeps command-reference Examples command-only, with output in the Output section. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * translate: add zh/ja Dify CLI documentation Adds Chinese and Japanese translations of the difyctl CLI doc set (20 pages each) under zh/cli/ and ja/cli/, and registers them in the zh/ja docs.json navigation (CLI under the Self-Host product only, mirroring the English structure). Removes the zh/ja coming-soon placeholders. Hand-translated following tools/translate/formatting-zh.md, formatting-ja.md, and the terminology base, then audited with the format and terminology checks. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * fix: restore version --short row, align zh env-vars flag section - version.mdx (zh/ja): restore the --short flag row removed by accident - environment-variables.mdx (zh): the env list flag section was rendered as 参数 (Arguments); use 标志 (Flags) for the heading and table header, matching the other reference pages --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> |
||
|
RiskeyL
|
27158f3e77 |
feat: add --compare-rev release-diff mode to env-var verifier
Adds a `--compare-rev OLD NEW --repo <dify> [--docs]` mode to verify-env-docs.py: it diffs the full .env.example variable set between two git refs and flags new variables still undocumented and not in ignored-vars.md. Documented in the env-vars skill as the first step of a release sync, to catch variables added by untagged PRs that per-PR detection misses. |
||
|
RiskeyL
|
2bf3b78006 |
docs: document plugin-provider cache and Nacos timeout env vars
Adds three env vars new in 1.15.0 to the self-host reference (en/zh/ja): PLUGIN_MODEL_PROVIDERS_CACHE_TTL (dify #36449) and the two Nacos remote-settings HTTP timeouts DIFY_ENV_NACOS_REQUEST_TIMEOUT / DIFY_ENV_NACOS_CONNECT_TIMEOUT (dify #37444). Only variables present in .env.example are documented. |
||
|
RiskeyL
|
7422ccf3d7 |
fix: update output node links to the renamed Workflow as Tool anchor
The tools page tab was renamed from Workflow Tool to Workflow as Tool in the 1.15.0 Integrations redesign, which changed its anchor. Repoint the self-host Output node pages (en, zh, ja) at the new anchor. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|
RiskeyL
|
136df5a208 |
docs: clean up integrations permissions and updates section
Remove the post-install configuration note, whose 'apply across the workspace' claim no longer holds for per-member tool credentials, and reword the auto-update sentence to lead with the integration rather than the reader since the action is owner/admin-gated. Self-host en/zh/ja. |
||
|
RiskeyL
|
211d563d80 |
docs: document XLSX embedded-image extraction on Knowledge import
Excel (.xlsx) embedded images are now extracted as chunk attachments on import, the same as DOCX. Adds XLSX to the embedded-image list on the self-host Upload Local Files page (en/zh/ja). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|
RiskeyL
|
a0f2c1ae7f |
feat: improve env-var and release-sync doc-sync skills
Load middleware.env.example at lowest precedence in the env-var verifier so the standard-deployment doc no longer reports false-positive default mismatches. Add ENABLE_AGENT_V2 and NEXT_PUBLIC_ENABLE_FEATURE_PREVIEW to the env-var ignore list, record the empty-vs-concrete default example-line rule in the env-var skill, and fold the saas-deploy staging-SHA and feature-flag scoping method into the release-sync skill. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|
RiskeyL
|
070a1a8f8b |
docs: sync self-host env vars for 1.15.0
Add SERVER_CONSOLE_API_URL and the Milvus TLS variables (MILVUS_SECURE, MILVUS_SERVER_PEM_PATH, MILVUS_SERVER_NAME), rename the SSRF sandbox-proxy variables (SSRF_REVERSE_PROXY_PORT to SSRF_SANDBOX_PROXY_PORT and SSRF_SANDBOX_HOST to SSRF_SANDBOX_PROXY_HOST, dify#36332), and add the SSRF private-network allowlist variables (SSRF_PROXY_ALLOW_PRIVATE_IPS and SSRF_PROXY_ALLOW_PRIVATE_DOMAINS). Mirrored to zh and ja. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|
RiskeyL
|
305e3f9f30 |
docs: align self-host knowledge creation with ready-to-use vs custom
Reflect the 1.15.0 onboarding redesign in the self-host knowledge docs. The two create entry points are now Create a ready-to-use knowledge base and Build a custom knowledge base, reached through Knowledge > Create. Update the overview bullets, page titles, nav groups, the in-product create paths, and name-tied prose, and add a bridge from the custom knowledge base page to the underlying knowledge pipeline. Cloud is left unchanged because it keeps the previous UI. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|
RiskeyL
|
8f4368f4d5 |
docs: rename two leftover Plugins references to Integrations
The 1.15.0 Integrations rename missed two spots in the self-host tree: the Extension type on the Integrations overview and the workspace-resources list on the Orchestrate a Node page. Update both to Integrations across en, zh, and ja. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|
RiskeyL
|
f5e73aa5b2 |
feat: add a global contributing footer via custom JS
Replace the per-page "Contributing Section" (previously baked into every plugin-dev page by tools/contributing_in_page.py) with a single custom JS file that Mintlify auto-includes on every page. It derives the GitHub edit URL from the current path at runtime, localizes the labels (en/zh/ja), and injects an "Edit this page | Report an issue" bar above the site footer, so the feature now covers all pages with no per-page markup. - add contributing-footer.js - remove the 117 baked-in Contributing Sections under en/zh/ja/develop-plugin - retire tools/contributing_in_page.py Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |