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 para 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 ficheiros que escreve, a compilação e uma execução do que compila. Esta pasta contém cada etapa desse guia:
| pasta | o 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 de aplicação da instalação e a palavra-passe do proprietário, e o e-mail da conta do proprietário |
draft/ | os ficheiros que aggrega import support-assistant.yml --target helm escreveu, inalterados, e o que 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.
Num checkout do repositório da documentação, check.sh volta a executar a importação, compara o que esta escreve e imprime com draft/, compara os blocos que o guia cita com estes ficheiros, e valida e compila o que a importação escreveu. Precisa do catálogo da biblioteca padrão (onde obter um) num checkout ao lado deste repositório, ou do respetivo diretório indicado em AGGREGA_CATALOG_DIRS.
Gerar o exemplo
É possível executar a importação deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que a execute por si.
Escreva o exemplo numa nova pasta com o nome dele:
aggrega scaffold --example import-difyDepois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:
cd import-difyCompilação
A importação cria os rascunhos dos ficheiros Aggrega ao lado do projeto, em source/, obtém de import-answers.yaml o que nenhuma aplicação pode conter e descarrega aquilo de que a compilação precisa. Compara o projeto com o catálogo da biblioteca padrão, que o registry predefinido do espaço de trabalho publica como um instantâneo assinado: a primeira importação obtém-no, verifica-o, guarda-o na cache de conteúdo do espaço de trabalho e identifica-o pelo seu digest no registo que escreve ao lado dos rascunhos. Um espaço de trabalho que indica as suas próprias pastas de catálogo — em AGGREGA_CATALOG_DIRS, ou sob workspace.catalog_dirs — importa antes em relação a essas:
cd sourceaggrega import support-assistant.yml --target helmaggrega validate --release release.yamlaggrega build --release release.yamlA criação dos Secrets que os manifestos do build leem, e a sua execução, encontram-se no guia passo a passo indicado acima.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.
Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por iniciativa própria. Se a pasta do espaço de trabalho ainda não contiver uma pasta `import-dify`, chame uma vez a ferramenta `scaffold` com `example` definido como `import-dify` e sem `dir`: esta escreve o exemplo numa nova pasta `import-dify`, cuja pasta `source` contém o que este exemplo importa. Em seguida, chame a ferramenta `import` com `workspace_root` definido como `import-dify/source`, `source` definido como `support-assistant.yml` e `target` definido como `helm`: esta lê as respostas de que precisa a partir de `import-answers.yaml`, ao lado de `support-assistant.yml`, escreve os seus rascunhos em `import-dify/source` e obtém aquilo de que precisam. Em seguida, 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. Indique-me que ficheiros o build escreveu; encontram-se em `import-dify/source/dist/`.Testar
Importada com --target compose e iniciada como mostra a secção No Docker Compose do guia, a instalação responde nesta máquina: a API em http://127.0.0.1:5001 e a consola em http://127.0.0.1:3001/signin. A aplicação responde a uma mensagem enviada com a sua própria chave, que o guia cria depois de iniciar sessão, instalar o fornecedor 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 fornecedor:
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 fornecedor da execução era um marcador de posição, que o Dify recusou com a mensagem Incorrect API key provided da OpenAI quando foi definida, pelo que a mensagem obteve:
{"code":"provider_not_initialize","message":"Model gpt-4o-mini credentials is not initialized.","status":400}Compilada como acima, para Kubernetes, e aplicada tal como a secção Executá-lo do guia a aplica, a API responde aos mesmos pedidos no mesmo endereço assim que uma porta local é reencaminhada para o seu Service; a execução obteve aí as mesmas respostas:
kubectl port-forward -n <namespace> svc/dify-zdapi-default 5001:5001