Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Importar una aplicación Dify — un asistente de chat en la instalación de Dify

Una aplicación de chat de Dify, exportada en el DSL de Dify, importada por aggrega import en un Aggregate, una Release y un Manifest que compilan la instalación de Dify de la biblioteca estándar que la contiene, para Kubernetes tal como están escritos.

Importar una aplicación Dify lo recorre paso a paso: el comando, los archivos que escribe, la compilación y una ejecución de lo que compila. Esta carpeta contiene cada etapa de ese recorrido:

carpetaqué contiene
source/la aplicación, support-assistant.yml; el .aggrega-config.yaml que convierte la carpeta en un espacio de trabajo; y import-answers.yaml, las respuestas a lo que ninguna aplicación puede contener: los nombres de los Secrets de Kubernetes que guardan el secreto de aplicación de la instalación y la contraseña del propietario, y el correo electrónico de la cuenta propietaria
draft/los archivos que escribió aggrega import support-assistant.yml --target helm, sin cambios, y lo que imprimió: stdout.txt en la salida estándar, import.txt en la salida de error estándar

source/support-assistant.yml está escrito para este ejemplo, con la forma en que Dify exporta una aplicación en la versión 0.7.0 del DSL.

En un checkout del repositorio de la documentación, check.sh vuelve a ejecutar la importación, compara lo que escribe e imprime con draft/, compara los bloques que cita el recorrido con estos archivos, y valida y compila lo que escribió la importación. Necesita el catálogo de la biblioteca estándar (dónde conseguir uno) descargado junto a este repositorio, o su directorio indicado en AGGREGA_CATALOG_DIRS.

Generar el ejemplo

Puedes ejecutar la importación de este ejemplo con los comandos de abajo, o hacer que tu asistente de IA la ejecute por ti.

Escribe el ejemplo en una carpeta nueva con su nombre:

Terminal window
aggrega scaffold --example import-dify

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd import-dify

Compilación

La importación genera los borradores de los archivos Aggrega junto al proyecto, en source/, toma de import-answers.yaml lo que ninguna aplicación puede contener y descarga lo que necesita la compilación. Contrasta el proyecto con el catálogo de la biblioteca estándar, que el registro predeterminado del espacio de trabajo publica como una instantánea firmada: la primera importación lo descarga, lo verifica, lo guarda en la caché de contenido del espacio de trabajo y lo identifica por su digest en el informe que escribe junto a los borradores. Un espacio de trabajo que indica sus propias carpetas de catálogo — en AGGREGA_CATALOG_DIRS, o bajo workspace.catalog_dirs — importa en cambio contra ellas:

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

La creación de los Secrets que leen los manifiestos del build, y su ejecución, están en la guía paso a paso enlazada arriba.

Con un asistente de IA

Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.

Usa solo las herramientas de Aggrega y no crees ninguna carpeta por tu cuenta. Si la carpeta del espacio de trabajo todavía no contiene una carpeta `import-dify`, llama una vez a la herramienta `scaffold` con `example` establecido en `import-dify` y sin `dir`: escribe el ejemplo en una nueva carpeta `import-dify`, cuya carpeta `source` contiene lo que importa este ejemplo. Luego llama a la herramienta `import` con `workspace_root` establecido en `import-dify/source`, `source` establecido en `support-assistant.yml` y `target` establecido en `helm`: lee las respuestas que necesita de `import-answers.yaml` junto a `support-assistant.yml`, escribe sus borradores en `import-dify/source` y descarga lo que estos necesitan. Luego llama a la herramienta `validate` con `workspace_root` establecido en `import-dify/source` y `release` establecido en `release.yaml`, y a la herramienta `build` con `workspace_root` establecido en `import-dify/source`, `release` establecido en `release.yaml` y `write` establecido en true. Dime qué archivos escribió la compilación; están en `import-dify/source/dist/`.

Probarlo

Importada con --target compose e iniciada como muestra la sección En Docker Compose de la guía, la instalación responde en esta máquina: la API en http://127.0.0.1:5001 y la consola en http://127.0.0.1:3001/signin. La aplicación responde a un mensaje enviado con su propia clave, que la guía crea después de iniciar sesión, de instalar el proveedor OpenAI desde el marketplace de plugins de Dify, al que el marketplace_enabled de la Release en borrador permite llegar a la instalación, y de establecer la clave del proveedor:

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 clave del proveedor de la ejecución era un marcador de posición, que Dify rechazó con el mensaje Incorrect API key provided de OpenAI cuando se estableció, así que el mensaje obtuvo:

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

Compilada como arriba, para Kubernetes, y aplicada como la aplica la sección Ejecutarlo de la guía, la API responde a las mismas solicitudes en la misma dirección una vez que se reenvía un puerto local a su Service; la ejecución obtuvo allí las mismas respuestas:

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