Implante o Dify no ACK para criar um assistente de perguntas e respostas com IA escalável, apoiado na base de conhecimento da sua empresa.
Visão geral da solução
|
Exemplo de aplicação de IA personalizada do Dify
|
Exemplo de aplicação de IA integrada à web
|
Configure um assistente dedicado de perguntas e respostas com IA em três etapas:
Instale o componente ack-dify: Crie um cluster ACK e instale o componente ack-dify.
Adicione um assistente de perguntas e respostas com IA: Acesse o service do Dify para adicionar um assistente de perguntas e respostas com IA ao seu site.
Personalize o assistente de perguntas e respostas com IA: Adicione uma base de conhecimento dedicada para melhorar a precisão nas perguntas específicas do domínio.

Interação entre o service do Dify e o cluster ACK:
Introdução ao Dify
O Dify é uma plataforma de desenvolvimento de aplicações de modelos de linguagem grandes (LLM) de código aberto que combina Backend-as-a-service (BaaS) e LLMOps. Ele permite que desenvolvedores e usuários não técnicos criem aplicações de IA generativa prontas para produção sem precisar reinventar componentes essenciais.
Principais componentes da arquitetura do Dify:
Componentes tecnológicos principais: O Dify integra elementos essenciais para a criação de aplicações LLM, incluindo compatibilidade com diversos modelos, uma interface intuitiva para design de prompts, um sistema de Geração Aumentada por Recuperação (RAG) de alto desempenho e uma arquitetura de Agent personalizável.
Orquestração visual e operações: A interface intuitiva do Dify possibilita a orquestração visual de prompts, fluxos de trabalho operacionais simplificados e gestão eficiente de conjuntos de dados. Isso acelera significativamente o desenvolvimento de aplicações de IA, permitindo que os desenvolvedores façam implantações rápidas ou integrem LLMs a sistemas existentes, além de apoiar a otimização contínua das operações.
Modelos de aplicação e framework de orquestração: O Dify oferece aos desenvolvedores modelos de aplicação prontos para uso e um framework de orquestração, permitindo o desenvolvimento rápido de aplicações de IA generativa baseadas em modelos de linguagem grandes. A plataforma também suporta dimensionamento instantâneo e fluido para atender às mudanças nas necessidades do negócio, impulsionando o crescimento empresarial.
Em conjunto, esses componentes fornecem uma plataforma completa para desenvolver e implantar rapidamente aplicações de IA generativa.
1. Instale o componente ack-dify
Implantação com um clique
Se você é novo em clusters ACK e não está familiarizado com o processo de criação, clique em implantação com um clique para criar o ambiente de execução do Dify. Essa opção implanta uma aplicação Dify de instância única por meio do modelo Helm ack-dify no ACK App Marketplace, adequada para desenvolvimento e testes.
Antes de usar a implantação com um clique, certifique-se de que o ACK esteja ativado e autorizado. Para mais informações, consulte Create an ACK managed cluster.
Esta solução utiliza os seguintes recursos de cloud. Para informações sobre faturamento, consulte Billing.
|
Recursos de cloud |
Descrição |
|
1 Virtual Private Cloud (VPC) |
Fornece uma rede privada para recursos de cloud, como instâncias do Elastic Compute Service (ECS) e clusters ACK. |
|
2 vSwitches |
Conecta recursos como instâncias ECS e clusters ACK para comunicação e isolamento de rede. |
|
1 grupo de segurança |
Define regras de rede de entrada e saída para instâncias ECS na VPC. |
|
1 instância de Classic Load Balancer (CLB) |
Fornece acesso à internet para a plataforma Dify. |
|
1 sistema de arquivos NAS |
Armazena dados para services internos do Dify (api e worker). |
|
1 cluster gerenciado ACK |
Implanta o Dify. Selecione pelo menos um nó com 8 vCPUs e 16 GiB de memória (como ecs.u1-c1m2.2xlarge) para evitar falta de recursos. |
Procedimento
Clique em implantação com um clique. No ROS, selecione sua região, como China (Hangzhou). Siga o modelo do ROS para configurar os IDs de zona dos vSwitches, o tipo de instância do pool de nós, a senha, a confirmação de segurança e outras definições. Mantenha os padrões para o restante e clique em Next: Check and Confirm.
A criação do cluster leva cerca de 10 minutos. Após a criação, faça login no console do Container Service for Kubernetes. No painel de navegação à esquerda, escolha Clusters. Clique no cluster desejado. Escolha Workloads > Pods, defina o namespace como dify-system e verifique se o componente ack-dify está instalado no cluster.
(Opcional) Se um pod estiver Pending, o cluster pode estar sem a dependência PVC para o ack-dify. Crie um sistema de arquivos CNFS e uma StorageClass NAS para o cluster. Para mais informações, consulte Manage NAS file systems by using CNFS. Para mais detalhes sobre solução de problemas de exceções em pods, consulte Troubleshoot pod exceptions.
Após a instalação do componente ack-dify, prossiga para a próxima etapa.
Se você já utilizou a implantação com um clique do ROS para instalar o componente ack-dify, o acesso público já está habilitado para o service ack-dify. Você pode pular as etapas em Access the Dify service.
Implantação manual
Se você já conhece o processo de criação de clusters ACK, siga estas etapas para criar um cluster adaptado às suas necessidades.
1.1 Pré-requisitos
-
Um cluster ACK Pro, versão 1.22 ou posterior, deve estar criado. Para mais informações, consulte Create an ACK managed cluster e Upgrade a cluster.
Reserve pelo menos 2 vCPUs e 4 GB de memória. Certifique-se de que o plugin de armazenamento CSI e o sistema de arquivos CNFS estejam configurados.
O kubectl deve estar conectado ao cluster. Consulte Connect to an ACK cluster by using kubectl.
1.2 Implante o componente
Implante o componente ack-dify no seu cluster para o service do Dify.
-
Faça login no console do Container Service for Kubernetes. No painel de navegação à esquerda, escolha Clusters. Clique no cluster desejado. Siga as etapas abaixo para instalar o componente ack-dify.
Não é necessário configurar o Application Name ou o Namespace do componente. Clique em Next. Na caixa de diálogo Confirm que aparece, clique em Yes para aceitar os padrões (ack-dify / dify-system). Em seguida, selecione a Chart Version mais recente e clique em OK para instalar o componente ack-dify.
-
Aguarde cerca de um minuto e verifique se todos os pods no namespace
dify-systemestão no estadoRunning.kubectl get pod -n dify-systemSe algum pod estiver Pending, o cluster pode estar sem a dependência PVC para o ack-dify. Crie um sistema de arquivos CNFS e uma StorageClass NAS. Para mais informações, consulte Manage NAS file systems by using CNFS. Para mais detalhes sobre solução de problemas de exceções em pods, consulte Troubleshoot pod exceptions.
2. Adicione um assistente de perguntas e respostas com IA
2.1 Acesse o service do Dify
-
Habilite o acesso público para o service ack-dify.
NotaO acesso público serve apenas para fins de demonstração. Para garantir a segurança dos dados em um ambiente de produção, ative o recurso Access Control.
No console ACK, escolha Network > Services no painel de navegação à esquerda. No seletor de namespace na parte superior, selecione dify-system, localize o Service ack-dify e clique em Update. Na caixa de diálogo Update Service que aparece, configure os seguintes parâmetros:
Tipo de service: selecione Load Balancer (LoadBalancer).
Tipo de balanceador de carga: Classic Load Balancer (CLB).
Seleção de recurso: New Resource.
Método de acesso: selecione public network access.
Método de faturamento: pay-as-you-go billing method (PayByCLCU).
TrafficPolicy: Local.
Mapeamento de portas: Nome http-dify, porta do Service 80, porta do contêiner dify, protocolo TCP.
Após concluir a configuração, clique em OK.
Após a configuração, escolha Network > Services > ack-dify e defina o namespace como dify-system. Você verá o External IP do service ack-dify. Abra esse IP no navegador para acessar o Dify.
-
Registre uma conta.
Acesse o External IP e siga as instruções para criar uma conta de administrador (e-mail, nome de usuário, senha).
2.2 Crie um assistente de perguntas e respostas com IA
Insira o External IP no navegador e faça login na plataforma Dify.
-
Adicione um modelo de IA (Qwen neste exemplo) e defina a chave de API no Alibaba Cloud Model Studio.
Quando a cota gratuita do Qwen se esgotar, a cobrança será baseada no uso de tokens. Isso reduz os custos iniciais em comparação com a hospedagem própria de um modelo.
Obtenha a chave de API: Escolha Username > Settings > Model Provider > Instale e configure o plugin Qwen > Get API Key From Alibaba Cloud.
Insira a chave de API e clique em Save.
-
Crie um assistente de perguntas e respostas com IA de uso geral.
Escolha Studio > Create from Blank e insira um Name e uma Description para o assistente. Mantenha os demais parâmetros com os valores padrão.
2.3 Verifique o assistente de perguntas e respostas com IA
Teste o assistente fazendo perguntas. O chatbot de uso geral lida com conversas simples, mas ainda não consegue responder a perguntas específicas sobre o Dify.
3. Personalize o assistente de IA
3.1 Crie uma base de conhecimento
Para responder com precisão a perguntas técnicas relacionadas ao Dify, configure uma base de conhecimento dedicada para o assistente.
Este exemplo fornece um arquivo de corpus dify_doc.md. Crie e carregue a base de conhecimento conforme descrito a seguir.
-
Carregue o arquivo de corpus preparado dify_doc.md na base de conhecimento.
Escolha Knowledge > Create Knowledge > Import from file > Select File > Next.
-
Clique em Next. Execute a segmentação e limpeza de texto e salve.
Mantenha os padrões. A base de conhecimento limpa, segmenta e indexa automaticamente o documento para recuperação.
Para entender como os arquivos de corpus acima são organizados em um único arquivo .md, expanda a seção recolhível abaixo para obter detalhes.
3.2 Orquestre e publique o assistente
Configure um prompt e adicione a base de conhecimento ao contexto do assistente.
-
Configure o prompt: Copie o conteúdo a seguir para o campo Instructions. Os prompts melhoram a precisão das respostas por meio de instruções e restrições.
You will act as Dify's AI assistant, dedicated to answering customers' questions about Dify products and their features. Your responses should be based on the existing knowledge base to ensure accuracy. If a question is beyond your knowledge, please honestly inform them that you do not know the answer, in order to maintain the integrity of the information. Please communicate in a friendly and warm tone, and feel free to use emoticons appropriately to enhance the interactive experience. Adicione a base de conhecimento ao contexto: Clique em Add na área Context para adicionar a base de conhecimento, permitindo respostas precisas e profissionais.
Clique em Releases > Update para salvar e aplicar a configuração.
3.3 Verifique os resultados
Com uma base de conhecimento dedicada, o assistente de IA fornece respostas mais precisas e específicas do domínio do que o chatbot de uso geral.
Antes da configuração da base de conhecimento, a resposta para a pergunta "O que é o Dify?" é genérica e imprecisa: a IA lista várias suposições não relacionadas sobre o significado de DIFY. Após a configuração da base de conhecimento, o modelo qwen-turbo fornece uma resposta precisa que descreve os recursos principais da plataforma Dify, como definir aplicações de IA de forma declarativa e descrever prompts e contexto por meio de um arquivo YAML. A resposta cita o documento da base de conhecimento dify_doc.md na área Citations na parte inferior.
Resumo
Recursos principais do Dify:
|
Recurso |
Descrição |
|
LLMOps abrangente |
Monitoramento em tempo real de logs e métricas da aplicação, com otimização contínua de prompts, conjuntos de dados e modelos com base em dados de produção. |
|
Mecanismo RAG |
Pipeline RAG de ponta a ponta, desde a ingestão de documentos até a recuperação. Processa formatos comuns, como PDF e PPT, diretamente. |
|
Agent |
Defina agents usando chamadas de função LLM ou o paradigma ReAct, com mais de 50 ferramentas integradas e suporte para ferramentas personalizadas. |
|
Orquestração de workflow |
Canvas visual para construir workflows de IA arrastando e conectando componentes, com codificação mínima. |
|
Observabilidade |
Acompanhe e avalie a qualidade e o custo das aplicações LLM por meio de um painel de monitoramento. |
|
Recursos empresariais (SSO/controle de acesso) |
As organizações podem reduzir o risco de vazamento de informações e danos aos dados, garantindo a segurança da informação e a continuidade dos negócios. |
Entrando em produção
Quatro opções para implantar o assistente de perguntas e respostas com IA em produção:
-
Site compartilhado publicamente.
A aplicação de IA criada com o Dify pode ser publicada como uma aplicação web acessível na internet, operando com base nas suas configurações de prompt e orquestração. Para mais informações, consulte Publicar como aplicação web pública.
-
Chamadas baseadas em API.
O Dify fornece APIs para todas as aplicações baseadas no conceito de "Backend-as-a-service", permitindo que os desenvolvedores aproveitem o poder dos modelos de linguagem grandes em suas aplicações front-end sem se preocupar com arquiteturas e implantações complexas de back-end. Para mais informações, consulte Desenvolver com APIs.
-
Redesenvolvimento baseado em componentes front-end.
Se você estiver desenvolvendo um novo product do zero ou estiver na fase de design de protótipo, use o Dify para publicar rapidamente um site de IA. Para mais informações, consulte Redesenvolver com base em componentes front-end.
-
Incorporação no seu site empresarial ou pessoal.
O Dify suporta a incorporação da sua aplicação de IA no site da sua empresa. Use essa capacidade para criar um service oficial de atendimento ao cliente com IA, perguntas e respostas de negócios e outras aplicações com seus dados comerciais em minutos. Para mais informações, consulte Incorporar em um site.
Exemplo: Incorporar em um site
Incorpore sua aplicação LLM em um site empresarial ou pessoal.
Este exemplo serve apenas para fins de demonstração. Para garantir a segurança dos dados em um ambiente de produção, ative também o recurso Access Control.
Habilite o acesso público para o service ack-dify e abra o IP externo no navegador. Para mais informações, consulte Access the Dify service.
-
Crie rapidamente uma aplicação web simples no seu cluster ACK para depurar seu assistente de perguntas e respostas com IA.
Isso implanta uma aplicação web no seu cluster ACK para hospedar a aplicação LLM do Dify incorporada.
-
Obtenha o código do service do Dify.
Escolha um método para incorporar o código da aplicação de chat ao seu site.
-
No cluster, crie um Deployment para executar sua aplicação web e crie um Service para expô-la.
Veja a seguir um exemplo simples de YAML que mostra como implantar um servidor Nginx com HTML estático.
-
Faça login no console do Container Service for Kubernetes (ACK). Na página ConfigMaps, defina o namespace como default e clique em Create from YAML. Copie o conteúdo YAML abaixo para o modelo e modifique os parâmetros
window.difyChatbotConfig,srceidcom base no código do service do Dify que você obteve.Consulte o exemplo abaixo.
Verifique o status da implantação. A implantação é bem-sucedida quando ambos os pods estão no estado
Running.-
Habilite o acesso público para o service implantado.
Para garantir a segurança dos dados em um ambiente de produção, recomendamos que você também ative o recurso Access Control.
No painel de navegação à esquerda, escolha Network > Services. Localize o
web-servicee clique em Update. Na caixa de diálogo que aparece, configure os seguintes parâmetros:Tipo de service: Load Balancer (LoadBalancer).
Tipo de balanceador de carga: Classic Load Balancer (CLB) e selecione New Resource.
Método de acesso: public network access.
Método de faturamento: pay-as-you-go billing method (PayByCLCU).
Controle de acesso: opcionalmente selecione Enable conforme suas necessidades.
TrafficPolicy:
Cluster.Mapeamento de portas: Porta do Service 80, porta do contêiner 80, protocolo TCP.
Após concluir a configuração, clique em OK.
Após a configuração, você verá o External IP do service web-service. Abra esse IP no navegador.
ImportanteSe quiser que outros dispositivos acessem o service, certifique-se de que o firewall ou o grupo de segurança do seu cluster permita tráfego na porta 80. Para mais informações, consulte Add a security group rule.
Garanta que seu código e códigos de terceiros sejam seguros para evitar possíveis XSS ou incorporação de código malicioso. Este é um exemplo básico apenas para fins de demonstração; você pode expandi-lo e modificá-lo conforme suas necessidades.
-
Resultado do exemplo.
A página exibe o título Welcome to my website!, o que indica que a aplicação de IA foi incorporada com sucesso ao site.
-
-
Faturamento
O uso deste recurso gera cobranças pelo gerenciamento de clusters ACK Pro e pelo uso de recursos da Alibaba Cloud. Os products da Alibaba Cloud envolvidos incluem Elastic Compute Service (ECS), Classic Load Balancer (CLB), elastic IP address (EIP) e Apsara File Storage NAS. Você será cobrado pelos recursos utilizados de acordo com as regras de preços de cada product. Para mais informações sobre taxas de gerenciamento de cluster e taxas de recursos de products de cloud, consulte Billing overview.
Aviso legal
O Dify no ACK é uma solução de implantação Helm que adapta o projeto open-source Dify para o ambiente Alibaba Cloud ACK para permitir uma implantação rápida. O ACK não garante o desempenho da aplicação Dify nem sua compatibilidade com outros componentes do ecossistema, como plug-ins e bancos de dados. O ACK não fornece services comerciais, como compensação ou indenização, por quaisquer perdas comerciais causadas por defeitos no Dify ou em seus componentes de ecossistema. Para garantir a estabilidade e a segurança do Dify, acompanhe as atualizações da comunidade open-source e corrija proativamente problemas no software open-source.

