Dify Master SKILL
Um sistema de habilidades de desenvolvimento Dify modular e de revelação progressiva
Navegação Rápida
- O que é Dify
- Visão Geral do Sistema de Habilidades
- Início Rápido
- Índice de Sub-habilidades
- Referências Comuns
O que é Dify
Dify é uma plataforma LLMOps de código aberto que oferece orquestração visual de workflows e um sistema de plugins robusto, ajudando desenvolvedores a criar e implantar aplicações de IA de forma rápida.
Características Principais
- Workflow Visual: Orquestração por arrastar e soltar, permitindo construir aplicações de IA complexas sem codificação.
- Sistema de Plugins: Suporta vários tipos de plugins, como ferramentas, modelos e fontes de dados.
- Pronto para Produção: Suporte completo, do desenvolvimento local à implantação distribuída em larga escala.
- Ecossistema Open Source: Mais de 114.000 estrelas no GitHub, comunidade ativa e um rico mercado de plugins.
Arquitetura Técnica
- Arquitetura Beehive: Design de sistema modular e extensível.
- Mecanismo de Grafo Orientado a Filas: Orientado a eventos, execução paralela e alta performance.
- Suporte a Múltiplos Runtimes: Três modos de execução: Local, Debug e Serverless.
- Integração com Protocolo MCP: Integração padronizada com assistentes de IA como Claude.
Visão Geral do Sistema de Habilidades
O Dify Master SKILL adota um design modular, contendo 6 sub-habilidades centrais que cobrem todo o processo, do desenvolvimento à implantação.
dify-master (ponto de entrada principal)
├── 01-workflow # Design de workflow
├── 02-plugin # Desenvolvimento de plugins
├── 03-performance # Otimização de desempenho
├── 04-security # Segurança e implantação
├── 05-integration # Integração e extensão
└── 06-reference # Materiais de referência
Filosofia de Design
- Modular: Cada sub-habilidade é independente e completa, podendo ser usada isoladamente.
- Revelação Progressiva: Da visão geral aos detalhes, aprofunde-se conforme necessário.
- Otimização de Contexto: Minimiza a quantidade de conteúdo carregado por vez.
- Orientado à Prática: Fornece código e configurações prontos para uso.
Início Rápido
Cenário 1: Criar seu primeiro workflow
# Workflow simples de perguntas e respostas
workflow:
graph:
nodes:
- data:
type: start
variables: []
id: start
- data:
type: llm
model:
provider: openai
name: gpt-4
prompt_template:
- role: system
text: "Você é um assistente."
- role: user
text: "{{#sys.query#}}"
id: llm
- data:
type: answer
answer: "{{#llm.text#}}"
id: answer
edges:
- source: start
target: llm
- source: llm
target: answer
Próximo passo: Aprenda mais tipos de nós e padrões de design com a sub-habilidade 01-workflow
Cenário 2: Desenvolver seu primeiro plugin
# Plugin de ferramenta simples
typing import Any, Generator
dify_plugin.entities.tool import ToolInvokeMessage
dify_plugin import Tool
class MyTool(Tool):
def _invoke(
self,
tool_parameters: dict[str, Any]
) -> Generator[ToolInvokeMessage, None, None]:
# Obter parâmetros
input_text = tool_parameters.get("text", "")
# Lógica de processamento
result = input_text.upper()
# Retornar resultado
yield self.create_text_message(result)
Próximo passo: Aprenda o processo completo de desenvolvimento de plugins com a sub-habilidade 02-plugin
Cenário 3: Otimizar o desempenho do workflow
# Usar branches paralelas para melhorar o desempenho
- data:
type: parallel
branches:
- nodes: [tool1, process1]
- nodes: [tool2, process2]
- nodes: [tool3, process3]
id: parallel_execution
Próximo passo: Aprenda mais técnicas de otimização com a sub-habilidade 03-performance
Índice de Sub-habilidades
01. Sub-habilidade de Design de Workflow
Cenários de uso: Projetar e desenvolver workflows no Dify
Palavras-chave de ativação: nó, LLM, Agente, workflow, variável, recuperação de conhecimento, Requisição HTTP, Código, If-Else, Iteração, template, DSL, YAML
Conteúdo principal:
- Explicação detalhada de mais de 10 tipos de nós (Start, LLM, Agent, Knowledge Retrieval, Code, HTTP Request, Tool, If-Else, Iteration, Answer)
- 5 padrões de design (Pipeline sequencial, Ramificação condicional, Processamento iterativo, Recuperação de conhecimento, Agregação de múltiplas fontes)
- Templates de workflow prontos para uso
- Sistema de variáveis e sintaxe de referência
- Melhores práticas e perguntas frequentes
Acesso rápido: 01-workflow/SKILL.md
Recomendado para: Designers de workflow, desenvolvedores de aplicações de IA, gerentes de produto
02. Sub-habilidade de Desenvolvimento de Plugins
Cenários de uso: Desenvolver plugins personalizados para ferramentas, modelos e fontes de dados
Palavras-chave de ativação: plugin, Tool, Provider, desenvolvimento, manifest, OAuth, fonte de dados, modelo, extensão
Conteúdo principal:
- 4 tipos de plugins (Tool, Model, Datasource, Extension)
- Fluxo completo de desenvolvimento (inicialização, implementação, teste, empacotamento, publicação)
- Estrutura de projeto padrão e arquivos de configuração
- Guia de desenvolvimento de Provider e Tool
- Templates de plugins e exemplos de código
- Estratégias de teste e dicas de depuração
Acesso rápido: 02-plugin/SKILL.md
Recomendado para: Desenvolvedores de plugins, engenheiros backend, integradores de ferramentas
03. Sub-habilidade de Otimização de Desempenho
Cenários de uso: Otimizar o desempenho de execução de workflows e plugins
Palavras-chave de ativação: desempenho, performance, otimização, cache, paralelo, latência, throughput, monitoramento, benchmark
Conteúdo principal:
- Otimização de workflows (estrutura do grafo, execução paralela, pool de variáveis)
- Otimização de LLMs (seleção de modelos, engenharia de prompt, cache, saída estruturada)
- Otimização de plugins (seleção de runtime, limites de recursos, processamento assíncrono)
- Ferramentas de monitoramento e análise
- Testes de benchmark de desempenho
Acesso rápido: 03-performance/SKILL.md
Recomendado para: Engenheiros de desempenho, arquitetos, pessoal de operações
04. Sub-habilidade de Segurança e Implantação
Cenários de uso: Implantação em produção e reforço de segurança
Palavras-chave de ativação: segurança, security, implantação, deploy, Docker, Kubernetes, SSL, autenticação, autorização, sandbox, SSRF
Conteúdo principal:
- Práticas de segurança (proteção SSRF, isolamento em sandbox, criptografia de dados, autenticação/autorização)
- Guias de implantação (Docker Compose, Kubernetes, Serverless, Alta disponibilidade)
- Práticas de operação (monitoramento, logs, backup, solução de problemas)
- Configuração de ambiente e planejamento de recursos
- Melhores práticas e casos de uso
Acesso rápido: 04-security/SKILL.md
Recomendado para: Engenheiros DevOps, engenheiros de segurança, administradores de sistemas
05. Sub-habilidade de Integração e Extensão
Cenários de uso: Integração com sistemas e serviços externos
Palavras-chave de ativação: integração, integration, API, Webhook, MCP, Servidor, Cliente, banco de dados, Redis, fila de mensagens, RabbitMQ, Kafka, S3
Conteúdo principal:
- Integração de API (REST API, Webhook, Streaming)
- Protocolo MCP (Servidor MCP, Cliente MCP, comunicação bidirecional)
- Serviços externos (bancos de dados, armazenamento, filas de mensagens)
- Casos de integração e melhores práticas
- Solução de problemas e depuração
Acesso rápido: 05-integration/SKILL.md
Recomendado para: Engenheiros de integração, desenvolvedores full-stack, arquitetos
06. Sub-habilidade de Referências
Cenários de uso: Consultar informações de referência como sintaxe, API, CLI, etc.
Palavras-chave de ativação: referência, reference, API, SDK, CLI, DSL, YAML, comando, documentação, sintaxe
Conteúdo principal:
- Referência de sintaxe DSL (estrutura YAML completa e descrição de campos)
- Referência de API (documentação da interface RESTful)
- Referência de SDK (classes e métodos do Python SDK)
- Referência de CLI (ferramentas de linha de comando do dify)
- Perguntas frequentes e soluções
- Recursos de aprendizado e links da comunidade
Acesso rápido: 06-reference/SKILL.md
Recomendado para: Todos os desenvolvedores Dify
Referências Comuns
Sintaxe de Referência de Variáveis
# Variáveis do sistema
{{#sys.query#}} # Consulta do usuário
{{#sys.files#}} # Arquivos enviados
{{#sys.conversation_id#}} # ID da conversa
# Saída de nós
{{#ID_do_nó.campo_de_saída#}} # Referenciar saída de nó
{{#llm.text#}} # Saída de texto do LLM
{{#knowledge.result#}} # Resultado da recuperação de conhecimento
# Variáveis da conversa
{{#conversation.nome_da_variável#}} # Variável de nível de conversa
# Variáveis de iteração
{{#item#}} # Item atual da iteração
{{#index#}} # Índice atual
Configuração Comum de Nós
# Nó LLM
- data:
type: llm
model:
provider: openai
name: gpt-4
completion_params:
temperature: 0.7
max_tokens: 2000
prompt_template:
- role: system
text: "Prompt do sistema"
- role: user
text: "{{#sys.query#}}"
context:
enabled: true
variable_selector: ["knowledge", "result"]
# Nó Agente
- data:
type: agent
agent_parameters:
instruction:
value: "Chame ferramentas conforme a necessidade do usuário"
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
# Nó de Recuperação de Conhecimento
- data:
type: knowledge-retrieval
dataset_ids: ["id-do-dataset"]
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
Template de Configuração de Plugin
# manifest.yaml
version: 0.0.1
type: plugin
author: your-name
name: plugin-name
label:
en_US: Plugin Name
pt_BR: Nome do Plugin
description:
en_US: Plugin description
pt_BR: Descrição do Plugin
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
Comandos CLI Comuns
# Desenvolvimento de plugins
dify plugin init # Inicializar projeto de plugin
dify plugin run # Depurar plugin localmente
dify plugin package # Empacotar plugin
dify plugin publish # Publicar plugin
# Gerenciamento de workflows
dify workflow export <id> # Exportar workflow
dify workflow import <arquivo> # Importar workflow
dify workflow validate <arquivo> # Validar workflow
# Gerenciamento de ambiente
dify env list # Listar variáveis de ambiente
dify env set <chave> <valor> # Definir variável de ambiente
dify env get <chave> # Obter variável de ambiente
Caminho de Aprendizado
Caminho para Iniciantes (0-1 semana)
- Leia este SKILL para ter uma visão geral do Dify.
- Aprenda a sub-habilidade 01-workflow para dominar os fundamentos de workflow.
- Use um template para criar seu primeiro workflow.
- Teste e depure na plataforma Dify.
Caminho Intermediário (1-4 semanas)
- Aprofunde-se nos padrões de design da sub-habilidade 01-workflow.
- Aprenda a sub-habilidade 02-plugin para desenvolver plugins personalizados.
- Aprenda a sub-habilidade 03-performance para otimizar o desempenho.
- Construa um projeto real e implante-o.
Caminho para Especialistas (1-3 meses)
- Domine o conteúdo de todas as sub-habilidades.
- Aprenda a sub-habilidade 04-security para implantações em produção.
- Aprenda a sub-habilidade 05-integration para integrar sistemas externos.
- Participe de contribuições da comunidade e compartilhe melhores práticas.
Obter Ajuda
Recursos Oficiais
- Documentação oficial: https://docs.dify.ai/
- GitHub: https://github.com/langgenius/dify
- Marketplace de plugins: https://marketplace.dify.ai/
- Blog oficial: https://dify.ai/blog/
Recursos da Comunidade
- Discord: https://discord.gg/FngNHpbcY7
- Reddit: https://reddit.com/r/difyai
- Comunidade em português: https://github.com/langgenius/dify/discussions
Suporte do SKILL
- Documentação de arquitetura: ARCHITECTURE.md
- Relatar problemas: Submeta via GitHub Issues
- Guia de contribuição: Participe da melhoria e expansão do conteúdo do SKILL
Informações da Versão
- Versão atual: v1.1.0
- Última atualização: 2026-03-05
- Versões compatíveis do Dify: 0.15.x - 1.9.x
- Novidades: Sub-habilidades 05-integration e 06-reference aprimoradas, adicionado mecanismo de carregamento sob demanda.
- Próxima versão planejada: v1.2.0 (mais templates e casos de uso)
Licença
Este SKILL é de código aberto sob a licença MIT. Sinta-se à vontade para usar, modificar e distribuir.
Comece sua jornada de desenvolvimento com Dify! Escolha uma sub-habilidade para aprender em profundidade ou use um template para começar rapidamente.