Dify Master SKILL
모듈식, 점진적 공개 방식의 Dify 개발 스킬 체계
빠른 탐색
Dify란?
Dify는 오픈소스 LLMOps 플랫폼으로, 시각적인 워크플로우 오케스트레이션과 강력한 플러그인 시스템을 제공하여 개발자가 AI 애플리케이션을 빠르게 구축하고 배포할 수 있도록 돕습니다.
핵심 기능
- 시각적 워크플로우: 드래그 앤 드롭 방식으로 복잡한 AI 애플리케이션을 코딩 없이 구성
- 플러그인 시스템: 도구, 모델, 데이터 소스 등 다양한 플러그인 유형 지원
- 프로덕션 준비 완료: 로컬 개발부터 대규모 분산 배포까지 완벽 지원
- 오픈소스 생태계: 114K+ GitHub Stars, 활발한 커뮤니티와 풍부한 플러그인 마켓
기술 아키텍처
- Beehive 아키텍처: 모듈식, 확장 가능한 시스템 설계
- 큐 기반 그래프 엔진: 이벤트 기반, 병렬 실행, 고성능
- 다중 런타임 지원: Local, Debug, Serverless 세 가지 실행 모드
- MCP 프로토콜 통합: Claude 등 AI 어시스턴트와의 표준화된 통합
SKILL 체계 개요
Dify Master SKILL은 모듈식 설계를 채택하여 개발부터 배포까지의 전체 프로세스를 포괄하는 6개의 핵심 하위 SKILL로 구성됩니다.
dify-master (총 진입점)
├── 01-workflow # 워크플로우 설계
├── 02-plugin # 플러그인 개발
├── 03-performance # 성능 최적화
├── 04-security # 보안 및 배포
├── 05-integration # 통합 및 확장
└── 06-reference # 참고 자료
설계 철학
- 모듈화: 각 하위 SKILL은 독립적으로 완결되어 단독으로 사용 가능
- 점진적 공개: 개요부터 세부 사항까지 필요에 따라 심층 학습
- 컨텍스트 최적화: 단일 로드 시 콘텐츠 양 최소화
- 실용 중심: 바로 사용 가능한 코드와 설정 제공
빠른 시작
시나리오 1: 첫 번째 워크플로우 만들기
# 간단한 질문-답변 워크플로우
workflow:
graph:
nodes:
- data:
type: start
variables: []
id: start
- data:
type: llm
model:
provider: openai
name: gpt-4
prompt_template:
- role: system
text: "당신은 어시스턴트입니다"
- role: user
text: "{{#sys.query#}}"
id: llm
- data:
type: answer
answer: "{{#llm.text#}}"
id: answer
edges:
- source: start
target: llm
- source: llm
target: answer
다음 단계: 01-workflow SKILL에서 더 많은 노드 유형과 설계 패턴을 학습하세요.
시나리오 2: 첫 번째 플러그인 개발
# 간단한 도구 플러그인
from typing import Any, Generator
from dify_plugin.entities.tool import ToolInvokeMessage
from dify_plugin import Tool
class MyTool(Tool):
def _invoke(
self,
tool_parameters: dict[str, Any]
) -> Generator[ToolInvokeMessage, None, None]:
# 매개변수 가져오기
input_text = tool_parameters.get("text", "")
# 처리 로직
result = input_text.upper()
# 결과 반환
yield self.create_text_message(result)
다음 단계: 02-plugin SKILL에서 전체 플러그인 개발 과정을 학습하세요.
시나리오 3: 워크플로우 성능 최적화
# 병렬 분기를 사용한 성능 향상
- data:
type: parallel
branches:
- nodes: [tool1, process1]
- nodes: [tool2, process2]
- nodes: [tool3, process3]
id: parallel_execution
다음 단계: 03-performance SKILL에서 더 많은 최적화 기술을 학습하세요.
하위 SKILL 색인
01. 워크플로우 설계 SKILL
적용 시나리오: Dify 워크플로우 설계 및 개발
트리거 키워드: 노드, LLM, 에이전트, 워크플로우, 변수, 지식 검색, HTTP 요청, 코드, 조건 분기, 반복, 템플릿, DSL, YAML
핵심 내용:
- 10개 이상의 노드 유형 상세 (Start, LLM, Agent, Knowledge Retrieval, Code, HTTP Request, Tool, If-Else, Iteration, Answer)
- 5가지 설계 패턴 (순차 파이프라인, 조건 분기, 반복 처리, 지식 검색, 다중 소스 집계)
- 바로 사용 가능한 워크플로우 템플릿
- 변수 시스템 및 참조 구문
- 모범 사례 및 자주 묻는 질문
빠른 접근: 01-workflow/SKILL.md
추천 대상: 워크플로우 설계자, AI 애플리케이션 개발자, 제품 관리자
02. 플러그인 개발 SKILL
적용 시나리오: 사용자 정의 도구, 모델, 데이터 소스 플러그인 개발
트리거 키워드: 플러그인, plugin, Tool, Provider, 개발, manifest, OAuth, 데이터 소스, 모델, 확장
핵심 내용:
- 4가지 플러그인 유형 (Tool, Model, Datasource, Extension)
- 전체 개발 프로세스 (초기화, 구현, 테스트, 패키징, 배포)
- 표준 프로젝트 구조 및 설정 파일
- Provider 및 Tool 개발 가이드
- 플러그인 템플릿 및 코드 예제
- 테스트 전략 및 디버깅 팁
빠른 접근: 02-plugin/SKILL.md
추천 대상: 플러그인 개발자, 백엔드 엔지니어, 도구 통합자
03. 성능 최적화 SKILL
적용 시나리오: 워크플로우 및 플러그인 실행 성능 최적화
트리거 키워드: 성능, performance, 최적화, 캐시, 병렬, 지연, 처리량, 모니터링, benchmark
핵심 내용:
- 워크플로우 최적화 (그래프 구조, 병렬 실행, 변수 풀)
- LLM 최적화 (모델 선택, 프롬프트 엔지니어링, 캐싱, 구조화된 출력)
- 플러그인 최적화 (런타임 선택, 리소스 제한, 비동기 처리)
- 모니터링 및 분석 도구
- 성능 벤치마크 테스트
빠른 접근: 03-performance/SKILL.md
추천 대상: 성능 엔지니어, 아키텍트, 운영 담당자
04. 보안 및 배포 SKILL
적용 시나리오: 프로덕션 환경 배포 및 보안 강화
트리거 키워드: 보안, security, 배포, deploy, Docker, Kubernetes, SSL, 인증, 권한 부여, 샌드박스, SSRF
핵심 내용:
- 보안 실무 (SSRF 보호, 샌드박스 격리, 데이터 암호화, 인증 및 권한 부여)
- 배포 가이드 (Docker Compose, Kubernetes, Serverless, 고가용성)
- 운영 실무 (모니터링, 로깅, 백업, 장애 진단)
- 환경 구성 및 리소스 계획
- 모범 사례 및 사례 연구
빠른 접근: 04-security/SKILL.md
추천 대상: DevOps 엔지니어, 보안 엔지니어, 시스템 관리자
05. 통합 및 확장 SKILL
적용 시나리오: 외부 시스템 및 서비스와의 통합
트리거 키워드: 통합, integration, API, Webhook, MCP, 서버, 클라이언트, 데이터베이스, Redis, 메시지 큐, RabbitMQ, Kafka, S3
핵심 내용:
- API 통합 (REST API, Webhook, Streaming)
- MCP 프로토콜 (MCP Server, MCP Client, 양방향 통신)
- 외부 서비스 (데이터베이스, 스토리지, 메시지 큐)
- 통합 사례 및 모범 사례
- 장애 진단 및 디버깅
빠른 접근: 05-integration/SKILL.md
추천 대상: 통합 엔지니어, 풀스택 개발자, 아키텍트
06. 참고 자료 SKILL
적용 시나리오: 구문, API, CLI 등 참고 정보 검색
트리거 키워드: 참조, reference, API, SDK, CLI, DSL, YAML, 명령어, 문서, 구문
핵심 내용:
- DSL 구문 참조 (전체 YAML 구조 및 필드 설명)
- API 참조 (RESTful API 인터페이스 문서)
- SDK 참조 (Python SDK 클래스 및 메서드)
- CLI 참조 (dify 명령줄 도구)
- 자주 묻는 질문 및 해결책
- 학습 자료 및 커뮤니티 링크
빠른 접근: 06-reference/SKILL.md
추천 대상: 모든 Dify 개발자
자주 사용하는 참조
변수 참조 구문
# 시스템 변수
{{#sys.query#}} # 사용자 질의
{{#sys.files#}} # 업로드된 파일
{{#sys.conversation_id#}} # 대화 ID
# 노드 출력
{{#노드ID.출력필드#}} # 노드 출력 참조
{{#llm.text#}} # LLM 텍스트 출력
{{#knowledge.result#}} # 지식 검색 결과
# 대화 변수
{{#conversation.변수명#}} # 대화 수준 변수
# 반복 변수
{{#item#}} # 현재 반복 항목
{{#index#}} # 현재 인덱스
자주 사용하는 노드 설정
# LLM 노드
- data:
type: llm
model:
provider: openai
name: gpt-4
completion_params:
temperature: 0.7
max_tokens: 2000
prompt_template:
- role: system
text: "시스템 프롬프트"
- role: user
text: "{{#sys.query#}}"
context:
enabled: true
variable_selector: ["knowledge", "result"]
# 에이전트 노드
- data:
type: agent
agent_parameters:
instruction:
value: "사용자 요구에 따라 도구 호출"
model:
value:
provider: openai
model: gpt-4
query:
value: "{{#sys.query#}}"
tools:
value:
- enabled: true
provider_name: time
tool_name: current_time
type: builtin
agent_strategy_name: function_calling
# 지식 검색 노드
- data:
type: knowledge-retrieval
dataset_ids: ["dataset-id"]
query_variable_selector: ["start", "sys.query"]
retrieval_mode: single
single_retrieval_config:
model:
provider: openai
name: text-embedding-3-small
top_k: 3
score_threshold: 0.7
플러그인 구성 템플릿
# manifest.yaml
version: 0.0.1
type: plugin
author: your-name
name: plugin-name
label:
en_US: Plugin Name
zh_Hans: 플러그인 이름
description:
en_US: Plugin description
zh_Hans: 플러그인 설명
icon: icon.svg
resource:
memory: 268435456 # 256MB
plugins:
tools:
- provider/provider.yaml
meta:
version: 0.0.1
arch: [amd64, arm64]
runner:
language: python
version: "3.12"
entrypoint: main
tags:
- utilities
CLI 자주 사용하는 명령어
# 플러그인 개발
dify plugin init # 플러그인 프로젝트 초기화
dify plugin run # 로컬에서 플러그인 디버깅
dify plugin package # 플러그인 패키징
dify plugin publish # 플러그인 배포
# 워크플로우 관리
dify workflow export <id> # 워크플로우 내보내기
dify workflow import <file> # 워크플로우 가져오기
dify workflow validate <file> # 워크플로우 검증
# 환경 관리
dify env list # 환경 변수 목록 보기
dify env set <key> <value> # 환경 변수 설정
dify env get <key> # 환경 변수 가져오기
학습 경로
초보자 경로 (0-1주)
- 본 SKILL을 읽고 Dify의 전체적인 모습 이해
- 01-workflow SKILL 학습으로 워크플로우 기초 습득
- 템플릿을 사용하여 첫 번째 워크플로우 생성
- Dify 플랫폼에서 테스트 및 디버깅
중급 경로 (1-4주)
- 01-workflow SKILL의 설계 패턴 심층 학습
- 02-plugin SKILL 학습으로 사용자 정의 플러그인 개발
- 03-performance SKILL 학습으로 성능 최적화
- 실제 프로젝트 구축 및 배포
전문가 경로 (1-3개월)
- 모든 하위 SKILL 내용 마스터
- 04-security SKILL 학습으로 프로덕션 배포
- 05-integration SKILL 학습으로 외부 시스템 통합
- 커뮤니티 기여 및 모범 사례 공유 참여
도움말
공식 리소스
- 공식 문서: https://docs.dify.ai/
- GitHub: https://github.com/langgenius/dify
- 플러그인 마켓: https://marketplace.dify.ai/
- 공식 블로그: https://dify.ai/blog/
커뮤니티 리소스
- Discord: https://discord.gg/FngNHpbcY7
- Reddit: https://reddit.com/r/difyai
- 한국 커뮤니티: https://github.com/langgenius/dify/discussions
SKILL 지원
- 아키텍처 문서: ARCHITECTURE.md
- 문제 피드백: GitHub Issues를 통해 제출
- 기여 가이드: SKILL 콘텐츠 개선 및 확장 참여
버전 정보
- 현재 버전: v1.1.0
- 마지막 업데이트: 2026-03-05
- Dify 호환 버전: 0.15.x - 1.9.x
- 업데이트 내용: 05-integration 및 06-reference SKILL 보완, 필요 시 로딩 메커니즘 추가
- 다음 버전 계획: v1.2.0 (더 많은 템플릿 및 사례 추가)
라이선스
본 SKILL은 MIT 라이선스 하에 오픈소스로 제공되며, 사용, 수정 및 배포가 자유롭습니다.
Dify 개발 여정을 시작하세요! 하위 SKILL을 선택하여 심층 학습하거나, 템플릿을 사용하여 바로 시작해보세요.