Implante o Dify no ACK para criar um assistente de perguntas e respostas com IA escalável, apoiado pela 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 serviço 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 respostas a perguntas específicas do domínio.

Interação entre o serviço 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 formam 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ê está começando agora com clusters ACK e não conhece 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, ideal 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 Criar um cluster gerenciado pelo ACK.
Esta solução utiliza os seguintes recursos de nuvem. Para informações sobre faturamento, consulte Faturamento.
|
Recursos de nuvem |
Descrição |
|
1 Virtual Private Cloud (VPC) |
Fornece uma rede privada para recursos de nuvem, 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 serviços internos do Dify (API e worker). |
|
1 cluster gerenciado pelo 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 ROS para configurar IDs de zona do vSwitch, tipo de instância do pool de nós, senha, 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 algum pod estiver com status Pending, o cluster pode estar sem a dependência PVC necessária para o ack-dify. Crie um sistema de arquivos CNFS e uma StorageClass NAS para o cluster. Para mais informações, consulte Gerenciar sistemas de arquivos NAS usando CNFS. Para mais detalhes sobre solução de problemas de exceções em pods, consulte Solucionar exceções de pods.
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 serviço ack-dify. Pule as etapas em Acessar o serviço Dify.
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
-
Crie um cluster ACK Pro, versão 1,22 ou superior. Para mais informações, consulte Criar um cluster gerenciado pelo ACK e Atualizar um 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.
Conecte o kubectl ao cluster. Consulte Conectar-se a um cluster ACK usando kubectl.
1.2 Implantar o componente
Implante o componente ack-dify no seu cluster para o serviço 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 numeradas na figura 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, 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 com status Pending, o cluster pode estar sem a dependência PVC necessária para o ack-dify. Crie um sistema de arquivos CNFS e uma StorageClass NAS. Para mais informações, consulte Gerenciar sistemas de arquivos NAS usando CNFS. Para mais detalhes sobre solução de problemas de exceções em pods, consulte Solucionar exceções de pods.
2. Adicionar um assistente de perguntas e respostas com IA
2.1 Acessar o serviço Dify
-
Habilite o acesso público para o serviço ack-dify.
NotaO acesso público serve apenas para fins de demonstração. Para garantir a segurança dos dados em ambiente de produção, ative o recurso Access Control.

-
Após a configuração, escolha Network > Services > ack-dify e defina o namespace como dify-system. O External ip do serviço ack-dify será exibido. 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 Criar 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 configure a chave de API obtida na Alibaba Cloud. Veja a figura abaixo:
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.
Obter 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 Verificar 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. Personalizar o assistente de IA
3.1 Criar 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 mais detalhes.
3.2 Orquestrar e publicar o assistente
Configure um prompt e adicione a base de conhecimento ao contexto do assistente.
-
Configure o prompt: Copie o conteúdo abaixo 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 incluir a base de conhecimento, permitindo respostas precisas e profissionais.
Clique em Releases > Update para salvar e aplicar a configuração.
A configuração é mostrada na figura a seguir:

3.3 Verificar 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.
Resumo
Principais recursos 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 diretamente formatos comuns como PDF e PPT. |
|
Agent |
Defina agentes usando chamadas de função LLM ou o paradigma ReAct, com mais de 50 ferramentas integradas e suporte para ferramentas personalizadas. |
|
Orquestração de fluxo de trabalho |
Canvas visual para construir fluxos de trabalho 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.
Publique a aplicação de IA criada com o Dify 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 produto 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 site da sua empresa 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 serviço oficial de atendimento ao cliente com IA, perguntas e respostas comerciais 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 ambiente de produção, ative também o recurso Access Control.
-
Habilite o acesso público para o serviço ack-dify e abra o ip externo no navegador. Para mais informações, consulte Acessar o serviço Dify.

-
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 serviço Dify.
Conforme mostrado na figura, 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.
Abaixo está 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 serviço Dify obtido.Veja 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 serviço implantado.
Para garantir a segurança dos dados em ambiente de produção, recomendamos que você também ative o recurso Access Control.

Após a configuração, o External ip do serviço web-service será exibido. Abra esse ip no navegador.
ImportanteSe quiser que outros dispositivos acessem o serviço, certifique-se de que o firewall ou grupo de segurança do seu cluster permita tráfego na porta 80. Para mais informações, consulte Adicionar uma regra de grupo de segurança.
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.

-
-
Faturamento
O uso deste recurso gera cobranças pelo gerenciamento de clusters ACK Pro e pelo uso de recursos da Alibaba Cloud. Os produtos 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 produto. Para mais informações sobre taxas de gerenciamento de cluster e custos de recursos de produtos de nuvem, consulte Visão geral do faturamento.
Aviso legal
O Dify no ACK é uma solução de implantação Helm que adapta o projeto open-source Dify para o ambiente ACK da Alibaba Cloud, permitindo 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 plugins e bancos de dados. O ACK não fornece serviços 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.

