Tutorial Dify Completo para Iniciantes (2026)
Este tutorial passo a passo vai te levar do zero a um chatbot de IA funcionando com o Dify. Nenhum conhecimento prévio é necessário. No final, você terá um chatbot publicado alimentado pelo seu LLM preferido — pronto para compartilhar.
O que é o Dify?
O Dify é uma plataforma open source para criar aplicações alimentadas por LLM. Ele oferece uma interface visual para criar chatbots, agentes de IA e aplicações RAG — sem escrever código. Pense nele como um kit completo para desenvolvimento de apps de IA: gerenciamento de modelos, bases de conhecimento, orquestração de workflows e publicação de apps em um só lugar.
O Dify suporta todos os principais provedores de IA (OpenAI, Anthropic, Google Gemini, Mistral) além de modelos locais via Ollama. Você controla os prompts, os dados e onde tudo é hospedado.
Pré-requisitos
Antes de começar, certifique-se de ter o seguinte:
O que você precisa
Uma conta ou servidor Dify
Dify Cloud (gratuito) ou um VPS com Docker instalado
Uma chave de API de LLM
OpenAI, Anthropic ou Google Gemini — uma é suficiente
Um navegador web
Chrome, Firefox, Safari — qualquer navegador moderno funciona
Conhecimento básico de terminal
Necessário apenas para auto-hospedagem. Não é preciso para o Dify Cloud.
Colocar o Dify para funcionar
Você tem duas opções. Escolha a que se adapta à sua situação:
Opção A: Dify Cloud
- Acesse cloud.dify.ai
- Clique em "Get Started" e crie uma conta gratuita
- Pronto — sem configuração necessária
Plano gratuito: 200 créditos de mensagens/mês. Ótimo para testar.
Opção B: Auto-hospedagem no Hetzner
- Contratar servidor Hetzner CX22 (~€3,79/mês)
- Fazer login via SSH e executar:
git clone https://github.com/langgenius/dify.git && cd dify/docker && docker compose up -d - Abrir a porta 80 — o Dify está no ar
Conectar seu LLM
O Dify precisa ser conectado a um LLM antes de você poder criar qualquer coisa. Isso leva menos de 2 minutos:
Clique no seu avatar (canto superior direito) → Configurações
Vá para "Provedores de Modelo" na barra lateral esquerda
Clique em OpenAI (ou no seu provedor preferido)
Cole sua chave de API e clique em Salvar
Obtenha sua chave OpenAI em platform.openai.com/api-keys
Clique em "Testar" para verificar se a conexão funciona
Criar seu primeiro chatbot
Vamos construir um chatbot simples de suporte ao cliente. Isso leva cerca de 5 minutos:
Abrir o Studio
Clique em "Studio" na barra de navegação superior.
Criar app
Clique no botão "+ Criar App" no canto superior direito.
Escolher Chatbot
Selecione "Chatbot" nas opções de tipo de app. Clique em Avançar.
Nomear o app
Dê um nome como "Bot de Suporte ao Cliente". Clique em Criar.
Selecionar modelo
No seletor de modelo (canto superior direito do canvas), escolha GPT-4o ou seu modelo preferido.
Escrever o prompt do sistema
No campo de texto "Instruções", digite: "Você é um assistente de suporte ao cliente prestativo. Seja preciso, amigável e preciso. Se não souber a resposta, diga isso."
Clicar em Publicar
Pressione o botão azul "Publicar" no canto superior direito. Seu chatbot está no ar.
Testar e Compartilhar
Agora vamos garantir que funciona e compartilhar com outras pessoas:
Painel de prévia
No lado direito do Studio há uma prévia de chat. Digite uma mensagem e pressione Enter para testar seu bot. Mudanças no prompt do sistema têm efeito imediato no modo de prévia.
Link de compartilhamento
Após publicar, vá para Visão Geral → clique em "Executar" para abrir a página pública de chat. Copie a URL e compartilhe com qualquer pessoa — elas podem conversar com seu bot sem fazer login no Dify.
Incorporar em um site
Vá para Visão Geral → Incorporar → copie o iframe ou a tag de script. Cole em qualquer site para adicionar um widget de chat. Cores e posição totalmente personalizáveis.
Acesso via API
Cada app Dify recebe automaticamente uma API REST. Vá para Referência de API para obter sua chave de API e chamá-la de qualquer aplicação, incluindo n8n, Zapier ou código próprio.
Criar uma base de conhecimento (RAG)
O RAG (Retrieval-Augmented Generation) permite que seu chatbot responda perguntas a partir dos seus documentos. Este é um dos recursos mais poderosos do Dify:
Clique em "Conhecimento" na navegação superior
Clique em "+ Criar Conhecimento"
Faça upload dos seus documentos (PDF, Word, TXT, Markdown, páginas web)
Escolha as configurações de chunking (o padrão funciona bem para a maioria dos casos)
Clique em "Salvar e Processar" — o Dify divide e faz embed dos seus documentos automaticamente
Volte para seu chatbot no Studio → seção Contexto → clique em "+ Adicionar" → selecione sua base de conhecimento
Publique novamente. Seu bot agora pode responder a partir dos seus documentos.
Criar um Workflow
Os workflows do Dify permitem construir pipelines de IA em múltiplas etapas com um editor visual baseado em nós. Isso é mais poderoso que um chatbot simples — você pode encadear chamadas de LLM, fazer requisições HTTP, executar código e ramificar com base em condições.
Início
O ponto de entrada. Define variáveis de entrada (ex.: user_query).
Nó LLM
Chama seu modelo de IA com um prompt. Pode usar variáveis de nós anteriores.
Requisição HTTP
Faz uma chamada de API para qualquer serviço externo. Use para buscar dados.
Nó de Código
Execute Python ou JavaScript para transformar dados entre etapas.
SE/SENÃO
Ramifique o workflow com base em condições. Direcione para diferentes caminhos.
Fim
O nó de saída. Define o que é retornado ao usuário.
Próximos passos
Você criou seu primeiro chatbot Dify. Aqui está o que explorar a seguir:
Migrar do Cloud para auto-hospedagem
Mover para um VPS para créditos ilimitados e controle total dos dados. A partir de €3,79/mês.
Guia de auto-hospedagem →Comparar custos de hospedagem
Entender o quadro completo de custos — VPS vs. Dify Cloud vs. plano gratuito.
Guia de preços →Explorar os melhores provedores
Comparar Hetzner, Hostinger, DigitalOcean e mais para auto-hospedar o Dify.
Comparar provedores →Dify vs. alternativas
Veja como o Dify se compara ao Flowise, n8n, LangFlow e OpenWebUI.
Ver alternativas →Hospedar o Dify no seu próprio servidor
O Dify Cloud é ótimo para aprender, mas a verdadeira força está na auto-hospedagem: créditos ilimitados, privacidade total dos dados e sem taxas mensais de SaaS. Comece por apenas €3,79/mês no Hetzner.