릴리즈일: 2026-09-10 | GitHub 원본 릴리즈 노트 →
Dify 1.17.1 버전이 릴리즈되었습니다. 번들 Weaviate가 1.39.2로 업데이트되었으며 특정 데이터셋에 한정된 지식 베이스 API 키 생성과 캔버스 노드 키보드 이동 기능이 추가되었습니다. 아울러 CSV, Notion, PDF 문서 파싱 관련 다수의 오류 수정과 Agent 구동 시 Redis 메모리 부하 개선이 이루어졌습니다.
Breaking Changes
• 번들 Weaviate 단계적 업그레이드 필수: 자체 호스팅 환경에서 번들 Weaviate를 사용하는 경우 1.27.0에서 1.39.2로 바로 건너뛸 수 없습니다. 마이너 버전을 순차적으로 거치는 수동 업그레이드를 완료해야 하며, 강제 종료 시 HNSW 벡터 인덱스가 손상될 수 있으므로 주의가 필요합니다.
• Agent 실행 로그 보존 기간 단축: Agent 실행 스트림 기본 보존 기간(DIFY_AGENT_RUN_RETENTION_SECONDS)이 3일에서 2시간으로 변경되었습니다. 장기 보존이 필요하다면 환경변수 사전 설정이 필요합니다.
주요 신기능
• 데이터셋 전용 지식 베이스 API 키: 기존 워크스페이스 전체 권한 대신 특정 지식 베이스에만 접근 가능한 API 키를 발급할 수 있습니다. 지정되지 않은 데이터셋 요청 시 403 오류를 반환합니다.
• 워크플로우 노드 및 주석 키보드 이동: 캔버스 내 노드, 다중 선택 영역, 주석을 방향키(Shift 조합으로 큰 이동)로 자유롭게 재배치할 수 있습니다.
• 마켓플레이스 크리에이터 프로필 및 홈 개편: 플러그인 제작자 전용 프로필 페이지가 추가되고 탐색 배너, 태그, 언어 필터가 적용된 새 홈페이지가 제공됩니다.
• Markdown 폼 필드명 길이 설정 지원: 고정되어 있던 Markdown 폼 필드 이름 길이 한도를 MARKDOWN_FORM_FIELD_NAME_MAX_LENGTH 환경변수로 유연하게 조정할 수 있습니다.
버그픽스 및 개선
• 지식 베이스 파서 대폭 수정: CSV 숫자 앞 0 누락 및 nan 변환, Notion 테이블 다중 서식 컬럼 왜곡, .xls 따옴표 파싱 문제, URL 기반 PDF 로드 시 발생하던 AssertionError 등 다수의 문서 추출 오류가 해결되었습니다.
• Agent 및 챗플로우 메모리 안정화: Chatflow Agent V2에서 대화 간 기억 유실 오류를 수정하고 추론 모델의 닫히지 않은 think 태그를 정상 처리하도록 보완했습니다.
• Human Input 및 워크플로우 오류 교정: 루프/반복 노드 내 Human Input 배치 허용, 타임아웃 분기 오작동 수정, 대용량 그래프 동기화를 위한 WEBSOCKET_MAX_HTTP_BUFFER_SIZE 환경변수 추가가 반영되었습니다.
• 성능 최적화: Agent 이벤트 스트림 압축 및 TTL 단축을 통해 Redis 메모리 점유율을 크게 낮추었으며, 웹 앱 사이드바 가상화 복원으로 대규모 앱 목록 탐색 시 렌더링 성능을 개선했습니다.
• 웹 접근성 및 런타임 업그레이드: 키보드 제어 지원 강화, 폼 검증 피드백 보완과 함께 React 19.3, Next.js 16.3.3, Node.js 24 LTS, pnpm 12.3.4 환경으로 도구 체인을 갱신했습니다.
운영 시 참고사항
• 번들 Weaviate 업그레이드 절차: 기존 데이터를 보존한 채 업그레이드하려면 1.27부터 1.39까지 단계별 마이너 컨테이너를 순차 실행 후 정상 정지하는 가이드를 반드시 따라야 합니다. 외부 Weaviate나 타 벡터 DB는 영향이 없습니다.
• 구형 모델 타입 자동 마이그레이션: 1.15 이전 버전에서 업그레이드 시 필요했던 legacy-model-types 수동 명령어가 이제 flask db upgrade 실행 시 자동으로 처리됩니다. 되돌릴 수 없는 마이그레이션이므로 DB 백업을 먼저 수행하세요.
• 기존 문서 재색인 권장: 이번 패치에 포함된 텍스트 추출 엔진 수정 사항은 기등록된 문서에 소급 적용되지 않으므로, 누락이나 왜곡이 발생했던 파일은 재업로드가 필요합니다.