Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Importare un’applicazione Dify — un assistente di chat nell’installazione Dify

Un’applicazione di chat Dify, esportata nel DSL di Dify, importata da aggrega import in un Aggregate, una Release e un Manifest che compilano l’installazione Dify della libreria standard che la contiene, per Kubernetes così come sono scritti.

Importare un’applicazione Dify lo illustra passo per passo: il comando, i file che scrive, la compilazione e un’esecuzione di ciò che compila. Questa cartella contiene ogni fase di quella procedura guidata:

cartellacosa contiene
source/l’applicazione, support-assistant.yml; il .aggrega-config.yaml che rende la cartella un workspace; e import-answers.yaml, le risposte a ciò che nessuna applicazione può contenere: i nomi dei Secret Kubernetes che contengono il segreto applicativo dell’installazione e la password del proprietario, e l’email dell’account proprietario
draft/i file che aggrega import support-assistant.yml --target helm ha scritto, invariati, e ciò che ha stampato: stdout.txt sullo standard output, import.txt sullo standard error

source/support-assistant.yml è scritto per questo esempio, nella forma in cui Dify esporta un’applicazione alla versione DSL 0.7.0.

In un checkout del repository della documentazione, check.sh esegue di nuovo l’importazione, confronta ciò che scrive e stampa con draft/, confronta i blocchi citati dalla procedura guidata con questi file, e convalida e compila ciò che l’importazione ha scritto. Richiede il catalogo della libreria standard (dove procurarselo) estratto accanto a questo repository, oppure la sua directory indicata in AGGREGA_CATALOG_DIRS.

Generare l’esempio

Puoi eseguire l’importazione di questo esempio con i comandi qui sotto, oppure far sì che il tuo assistente AI la esegua per te.

Scrivi l’esempio in una nuova cartella che porta il suo nome:

Terminal window
aggrega scaffold --example import-dify

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd import-dify

Build

L’importazione crea le bozze dei file Aggrega accanto al progetto, in source/, prende da import-answers.yaml ciò che nessuna applicazione può contenere e scarica ciò che serve alla compilazione. Valuta il progetto rispetto al catalogo della libreria standard, che il registry predefinito del workspace pubblica come snapshot firmato: la prima importazione lo scarica, lo verifica, lo conserva nella cache dei contenuti del workspace e lo indica tramite il suo digest nel record che scrive accanto alle bozze. Un workspace che indica le proprie cartelle di catalogo — in AGGREGA_CATALOG_DIRS, o sotto workspace.catalog_dirs — importa invece rispetto a quelle:

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

La creazione dei Secret letti dai manifest della build, e la loro esecuzione, si trovano nella guida passo passo collegata sopra.

Con un assistente AI

Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.

Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella dell’area di lavoro non contiene ancora una cartella `import-dify`, chiama una volta lo strumento `scaffold` con `example` impostato a `import-dify` e senza `dir`: scrive l’esempio in una nuova cartella `import-dify`, la cui cartella `source` contiene ciò che questo esempio importa. Poi chiama lo strumento `import` con `workspace_root` impostato a `import-dify/source`, `source` impostato a `support-assistant.yml` e `target` impostato a `helm`: legge le risposte di cui ha bisogno da `import-answers.yaml` accanto a `support-assistant.yml`, scrive le sue bozze in `import-dify/source` e scarica ciò di cui hanno bisogno. Poi chiama lo strumento `validate` con `workspace_root` impostato a `import-dify/source` e `release` impostato a `release.yaml`, e lo strumento `build` con `workspace_root` impostato a `import-dify/source`, `release` impostato a `release.yaml` e `write` impostato a true. Dimmi quali file ha scritto la build; si trovano in `import-dify/source/dist/`.

Eseguire il test

Importata con --target compose e avviata come mostra la sezione Su Docker Compose della guida, l’installazione risponde su questa macchina: l’API su http://127.0.0.1:5001 e la console su http://127.0.0.1:3001/signin. L’applicazione risponde a un messaggio inviato con la propria chiave, che la guida crea dopo l’accesso, dopo aver installato il provider OpenAI dal marketplace dei plugin di Dify, che il marketplace_enabled della Release in bozza consente all’installazione di raggiungere, e dopo aver impostato la chiave del provider:

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"}'

La chiave del provider usata nell’esecuzione era un segnaposto, che Dify ha rifiutato con il messaggio di OpenAI Incorrect API key provided quando è stata impostata, quindi il messaggio ha ricevuto:

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

Compilata come sopra, per Kubernetes, e applicata come la applica la sezione Eseguilo della guida, l’API risponde alle stesse richieste allo stesso indirizzo una volta inoltrata una porta locale al suo Service; l’esecuzione ha ottenuto lì le stesse risposte:

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