Eine Dify-Anwendung importieren — ein Chat-Assistent in der Dify-Installation
Eine Dify-Chatanwendung, im DSL von Dify exportiert, von aggrega import in ein Aggregate, ein Release und ein Manifest importiert, die die Dify-Installation der Standardbibliothek bauen, die sie enthält — für Kubernetes, so wie sie geschrieben sind.
Eine Dify-Anwendung importieren führt Schritt für Schritt hindurch: der Befehl, die Dateien, die er schreibt, der Build und ein Lauf dessen, was er baut. Dieser Ordner enthält jede Stufe dieser Anleitung:
| Ordner | was er enthält |
|---|---|
source/ | die Anwendung, support-assistant.yml; die .aggrega-config.yaml, die den Ordner zu einem Workspace macht; und import-answers.yaml, die Antworten auf das, was keine Anwendung enthalten kann: die Namen der Kubernetes-Secrets mit dem Anwendungsgeheimnis der Installation und dem Passwort des Eigentümers sowie die E-Mail-Adresse des Eigentümerkontos |
draft/ | die Dateien, die aggrega import support-assistant.yml --target helm geschrieben hat, unverändert, und was der Befehl ausgegeben hat: stdout.txt auf der Standardausgabe, import.txt auf der Standardfehlerausgabe |
source/support-assistant.yml ist für dieses Beispiel geschrieben, in der Form, in der Dify eine Anwendung in der DSL-Version 0.7.0 exportiert.
In einem Checkout des Dokumentations-Repositorys führt check.sh den Import erneut aus, vergleicht, was er schreibt und ausgibt, mit draft/, vergleicht die Blöcke, die die Anleitung zitiert, mit diesen Dateien und validiert und baut, was der Import geschrieben hat. Es benötigt den Katalog der Standardbibliothek (woher Sie einen bekommen), neben diesem Repository ausgecheckt, oder dessen Verzeichnis in AGGREGA_CATALOG_DIRS angegeben.
Das Beispiel generieren
Sie können den Import dieses Beispiels mit den folgenden Befehlen ausführen oder ihn von Ihrem KI-Assistenten für Sie ausführen lassen.
Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:
aggrega scaffold --example import-difyDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd import-difyBuild
Der Import entwirft die Aggrega-Dateien neben dem Projekt, in source/, entnimmt import-answers.yaml, was keine Anwendung enthalten kann, und lädt herunter, was der Build benötigt. Er gleicht das Projekt mit dem Katalog der Standardbibliothek ab, den die Standard-Registry des Workspace als signierten Snapshot veröffentlicht: Der erste Import lädt ihn herunter, verifiziert ihn, legt ihn im Inhalts-Cache des Workspace ab und benennt ihn über seinen Digest in der Aufzeichnung, die er neben die Entwürfe schreibt. Ein Workspace, der eigene Katalogordner angibt — in AGGREGA_CATALOG_DIRS oder unter workspace.catalog_dirs —, importiert stattdessen gegen diese:
cd sourceaggrega import support-assistant.yml --target helmaggrega validate --release release.yamlaggrega build --release release.yamlDas Anlegen der Secrets, die die Manifeste des Builds lesen, und deren Ausführung stehen in der oben verlinkten Schritt-für-Schritt-Anleitung.
Mit einem KI-Assistenten
Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.
Verwenden Sie ausschließlich die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `import-dify` enthält, rufen Sie das Tool `scaffold` einmal auf, mit `example` auf `import-dify` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `import-dify`, dessen Ordner `source` enthält, was dieses Beispiel importiert. Rufen Sie dann das Tool `import` auf, mit `workspace_root` auf `import-dify/source`, `source` auf `support-assistant.yml` und `target` auf `helm` gesetzt: Es liest die benötigten Antworten aus `import-answers.yaml` neben `support-assistant.yml`, schreibt seine Entwürfe nach `import-dify/source` und lädt herunter, was diese benötigen. Rufen Sie dann das Tool `validate` auf, mit `workspace_root` auf `import-dify/source` und `release` auf `release.yaml` gesetzt, und das Tool `build`, mit `workspace_root` auf `import-dify/source`, `release` auf `release.yaml` und `write` auf true gesetzt. Nennen Sie mir die Dateien, die der Build geschrieben hat; sie liegen unter `import-dify/source/dist/`.Testen
Mit --target compose importiert und so gestartet, wie es der Abschnitt Auf Docker Compose der Anleitung zeigt, antwortet die Installation auf diesem Rechner: die API unter http://127.0.0.1:5001 und die Konsole unter http://127.0.0.1:3001/signin. Die Anwendung beantwortet eine Nachricht, die mit ihrem eigenen Schlüssel gesendet wird, den die Anleitung nach der Anmeldung erstellt, nachdem sie den OpenAI-Provider aus dem Plug-in-Marketplace von Dify installiert hat, den die Einstellung marketplace_enabled des entworfenen Release für die Installation erreichbar macht, und den Schlüssel des Providers gesetzt hat:
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"}'Der Provider-Schlüssel des Laufs war ein Platzhalter, den Dify beim Setzen mit OpenAIs Incorrect API key provided ablehnte, daher erhielt die Nachricht:
{"code":"provider_not_initialize","message":"Model gpt-4o-mini credentials is not initialized.","status":400}Wie oben für Kubernetes gebaut und so angewendet, wie der Abschnitt Ausführen der Anleitung es anwendet, beantwortet die API dieselben Anfragen unter derselben Adresse, sobald ein lokaler Port an ihren Service weitergeleitet ist; der Lauf erhielt dort dieselben Antworten:
kubectl port-forward -n <namespace> svc/dify-zdapi-default 5001:5001