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

Importare un workflow n8n — un agente AI che risponde ai messaggi di chat

Un workflow n8n — un trigger di chat, un AI Agent, un OpenAI Chat Model e una Simple Memory — importato da aggrega import in un Aggregate, una Release e un Manifest che si compilano per Docker Compose così come sono scritti.

Importare un workflow n8n 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/il workflow, support-agent.json; il .aggrega-config.yaml che rende la cartella un workspace; e import-answers.yaml, la risposta a ciò che nessun workflow può contenere, richiesta da un import per Kubernetes
draft/i file che aggrega import support-agent.json --target compose ha scritto, invariati, e ciò che ha stampato: stdout.txt sullo standard output, import.txt sullo standard error

source/support-agent.json è scritto per questo esempio, nella forma in cui n8n esporta un workflow.

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-n8n

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

Terminal window
cd import-n8n

Build

L’import scrive le bozze dei file Aggrega accanto al progetto, in source/, e scarica ciò che serve alla compilazione. Confronta il progetto con il catalogo della libreria standard, che il registry predefinito del workspace pubblica come un’istantanea firmata: il primo import la scarica, la verifica, la conserva nella cache dei contenuti del workspace e la indica tramite il suo digest nel registro che scrive accanto alle bozze. Un workspace che indica le proprie cartelle di catalogo — in AGGREGA_CATALOG_DIRS, o sotto workspace.catalog_dirs — esegue invece l’import rispetto a quelle:

Terminal window
cd source
aggrega import support-agent.json --target compose
aggrega validate --release release.yaml
aggrega build --release release.yaml

Come eseguire ciò che la compilazione scrive è spiegato nella procedura guidata indicata 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 del workspace non contiene ancora una cartella `import-n8n`, chiama una volta lo strumento `scaffold` con `example` impostato su `import-n8n` e senza `dir`: scrive l’esempio in una nuova cartella `import-n8n`, la cui cartella `source` contiene ciò che questo esempio importa. Poi chiama lo strumento `import` con `workspace_root` impostato su `import-n8n/source`, `source` impostato su `support-agent.json` e `target` impostato su `compose`: legge le risposte di cui ha bisogno da `import-answers.yaml` accanto a `support-agent.json`, scrive le sue bozze in `import-n8n/source` e scarica ciò di cui hanno bisogno. Poi chiama lo strumento `validate` con `workspace_root` impostato su `import-n8n/source` e `release` impostato su `release.yaml`, e lo strumento `build` con `workspace_root` impostato su `import-n8n/source`, `release` impostato su `release.yaml` e `write` impostato su true. Dimmi quali file ha scritto la build; si trovano in `import-n8n/source/dist/`.

Eseguire il test

Con lo stack in esecuzione come lo esegue la guida passo passo — le credenziali memorizzate e il workflow attivo — apri http://127.0.0.1:5678 per l’editor di n8n e invia al trigger della chat un messaggio con l’utente e la password che memorizza, letti da CHAT_USER e CHAT_PASSWORD sullo standard input di curl:

Terminal window
printf 'user = "%s:%s"\n' "$CHAT_USER" "$CHAT_PASSWORD" | curl --config - -sS -i -X POST \
http://127.0.0.1:5678/webhook/a3c9e1f2-4b5d-4e6f-8a7b-9c0d1e2f3a04/chat -H 'Content-Type: application/json' \
-d '{"action": "sendMessage", "sessionId": "s1", "chatInput": "In one short sentence: what does a support plan cover?"}'
HTTP/1.1 500 Internal Server Error
[… omitted: the response's other headers]
{"message":"Error in workflow"}

L’esecuzione ha memorizzato un segnaposto per la chiave OpenAI, quindi il workflow si è fermato alla sua chiamata al modello, e la sua esecuzione nell’editor riporta il rifiuto di OpenAI: Incorrect API key provided: sk-place*****************-key.

Importato con --target helm e applicato a Kubernetes, n8n accetta lo stesso messaggio allo stesso indirizzo una volta memorizzate le credenziali e attivato il workflow sull’istanza in esecuzione, come mostra la guida passo passo, e inoltrata una porta locale al suo Service; l’esecuzione ha ottenuto lì la stessa risposta:

Terminal window
kubectl port-forward -n <namespace> svc/n8n-default 5678:5678