Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

Importar uma aplicação Dify — um assistente de chat na instalação do Dify

Uma aplicação de chat do Dify, exportada na DSL do Dify, importada por aggrega import em um Aggregate, uma Release e um Manifest que compilam a instalação do Dify da biblioteca padrão que a contém, para Kubernetes tal como estão escritos.

Importar uma aplicação Dify percorre o processo passo a passo: o comando, os arquivos que ele escreve, o build e uma execução do que ele compila. Esta pasta contém cada etapa desse passo a passo:

pastao que contém
source/a aplicação, support-assistant.yml; o .aggrega-config.yaml que torna a pasta um espaço de trabalho; e import-answers.yaml, as respostas ao que nenhuma aplicação pode conter: os nomes dos Secrets do Kubernetes que guardam o segredo da aplicação da instalação e a senha do proprietário, e o e-mail da conta do proprietário
draft/os arquivos que aggrega import support-assistant.yml --target helm escreveu, sem alterações, e o que ele imprimiu: stdout.txt na saída padrão, import.txt na saída de erro padrão

source/support-assistant.yml foi escrito para este exemplo, no formato em que o Dify exporta uma aplicação na versão 0.7.0 da DSL.

Em um checkout do repositório da documentação, check.sh executa a importação novamente, compara o que ela escreve e imprime com draft/, compara os blocos que o passo a passo cita com estes arquivos, e valida e compila o que a importação escreveu. Ele precisa do catálogo da biblioteca padrão (onde obter um) em um checkout ao lado deste repositório, ou do diretório dele indicado em AGGREGA_CATALOG_DIRS.

Gerar o exemplo

Você pode executar a importação deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que a execute para você.

Escreva o exemplo em uma nova pasta com o nome dele:

Terminal window
aggrega scaffold --example import-dify

Em seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:

Terminal window
cd import-dify

Build

A importação gera os rascunhos dos arquivos Aggrega ao lado do projeto, em source/, obtém de import-answers.yaml o que nenhuma aplicação pode conter e baixa o que o build precisa. Ela compara o projeto com o catálogo da biblioteca padrão, que o registry padrão do espaço de trabalho publica como um snapshot assinado: a primeira importação o baixa, o verifica, o guarda no cache de conteúdo do espaço de trabalho e o identifica pelo seu digest no registro que escreve ao lado dos rascunhos. Um espaço de trabalho que indica as próprias pastas de catálogo — em AGGREGA_CATALOG_DIRS, ou sob workspace.catalog_dirs — importa em relação a elas:

Terminal window
cd source
aggrega import support-assistant.yml --target helm
aggrega validate --release release.yaml
aggrega build --release release.yaml

A criação dos Secrets que os manifestos do build leem, e a execução deles, estão no passo a passo vinculado acima.

Com um assistente de IA

Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.

Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta do espaço de trabalho ainda não contém uma pasta `import-dify`, chame uma vez a ferramenta `scaffold` com `example` definido como `import-dify` e sem `dir`: ela grava o exemplo em uma nova pasta `import-dify`, cuja pasta `source` contém o que este exemplo importa. Depois chame a ferramenta `import` com `workspace_root` definido como `import-dify/source`, `source` definido como `support-assistant.yml` e `target` definido como `helm`: ela lê as respostas de que precisa de `import-answers.yaml` ao lado de `support-assistant.yml`, grava seus rascunhos em `import-dify/source` e baixa o que eles precisam. Depois chame a ferramenta `validate` com `workspace_root` definido como `import-dify/source` e `release` definido como `release.yaml`, e a ferramenta `build` com `workspace_root` definido como `import-dify/source`, `release` definido como `release.yaml` e `write` definido como true. Diga-me quais arquivos o build gravou; eles estão em `import-dify/source/dist/`.

Teste

Importada com --target compose e iniciada como mostra a seção No Docker Compose do passo a passo, a instalação responde nesta máquina: a API em http://127.0.0.1:5001 e o console em http://127.0.0.1:3001/signin. O aplicativo responde a uma mensagem enviada com sua própria chave, que o passo a passo cria depois de fazer login, instalar o provedor OpenAI a partir do marketplace de plugins do Dify, que o marketplace_enabled da Release em rascunho permite à instalação alcançar, e definir a chave do provedor:

Terminal window
curl -sS http://127.0.0.1:5001/v1/chat-messages \
-H 'Authorization: Bearer <app key>' -H 'Content-Type: application/json' \
-d '{"inputs": {}, "query": "In one short sentence: what does a support plan cover?", "response_mode": "blocking", "user": "test-it"}'

A chave do provedor da execução era um placeholder, que o Dify recusou com a mensagem Incorrect API key provided da OpenAI quando foi definida, então a mensagem recebeu:

{"code":"provider_not_initialize","message":"Model gpt-4o-mini credentials is not initialized.","status":400}

Compilada como acima, para Kubernetes, e aplicada como a seção Executar do passo a passo a aplica, a API responde às mesmas requisições no mesmo endereço assim que uma porta local é encaminhada para o seu Service; a execução obteve ali as mesmas respostas:

Terminal window
kubectl port-forward -n <namespace> svc/dify-zdapi-default 5001:5001