콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

n8n 워크플로 가져오기 — 채팅 메시지에 답하는 AI 에이전트

채팅 트리거, AI Agent, OpenAI Chat Model, Simple Memory로 이루어진 n8n 워크플로를 aggrega import로 Aggregate, Release, Manifest로 가져오며, 이들은 작성된 그대로 Docker Compose용으로 빌드됩니다.

n8n 워크플로 가져오기에서는 명령, 그 명령이 작성하는 파일, 빌드, 그리고 빌드한 결과의 실행을 단계별로 안내합니다. 이 폴더에는 그 안내의 각 단계가 들어 있습니다:

폴더내용
source/워크플로 support-agent.json, 폴더를 워크스페이스로 만드는 .aggrega-config.yaml, 그리고 Kubernetes용 가져오기가 요구하는, 어떤 워크플로도 담을 수 없는 내용에 대한 답인 import-answers.yaml
draft/aggrega import support-agent.json --target compose 명령이 작성한 파일(변경 없음)과 출력한 내용: 표준 출력은 stdout.txt, 표준 오류는 import.txt

source/support-agent.json 파일은 이 예제를 위해 n8n이 워크플로를 내보내는 형태로 작성되었습니다.

문서 저장소의 체크아웃에서 check.sh는 가져오기를 다시 실행하고, 작성하고 출력한 내용을 draft/와 비교하고, 안내에서 인용하는 블록을 이 파일들과 비교한 뒤, 가져오기가 작성한 내용을 검증하고 빌드합니다. 표준 라이브러리 카탈로그(얻는 곳)가 이 저장소 옆에 체크아웃되어 있거나, 그 디렉터리가 AGGREGA_CATALOG_DIRS에 지정되어 있어야 합니다.

예제 생성하기

이 예제의 가져오기는 아래 명령으로 실행하거나 AI 어시스턴트에게 대신 실행하게 할 수 있습니다.

예제 이름을 딴 새 폴더에 예제를 씁니다:

Terminal window
aggrega scaffold --example import-n8n

그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:

Terminal window
cd import-n8n

빌드

import는 프로젝트 옆의 source/에 Aggrega 파일 초안을 작성하고, 빌드에 필요한 것을 가져옵니다. import는 프로젝트를 표준 라이브러리 카탈로그와 비교하며, 이 카탈로그는 워크스페이스의 기본 레지스트리가 서명된 스냅숏으로 게시합니다. 첫 번째 import가 이를 가져와 검증하고, 워크스페이스의 콘텐츠 캐시에 보관하며, 초안 옆에 기록하는 레코드에 다이제스트로 지정합니다. 자체 카탈로그 폴더를 AGGREGA_CATALOG_DIRS 또는 workspace.catalog_dirs에 지정한 워크스페이스는 대신 그 폴더들을 기준으로 import합니다:

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

빌드가 작성한 결과를 실행하는 방법은 위에 링크된 안내에 있습니다.

AI 어시스턴트 사용

Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.

Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. 작업 공간 폴더에 아직 `import-n8n` 폴더가 없으면 `example`에 `import-n8n` 값을 지정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 예제가 새 `import-n8n` 폴더에 작성되며, 그 안의 `source` 폴더에는 이 예제가 가져오는 내용이 들어 있습니다. 그런 다음 `workspace_root` 값은 `import-n8n/source`, `source` 값은 `support-agent.json`, `target` 값은 `compose`로 설정하여 `import` 도구를 호출하십시오. 이 도구는 필요한 답변을 `support-agent.json` 옆의 `import-answers.yaml`에서 읽고, 초안을 `import-n8n/source`에 작성하며, 초안에 필요한 것을 가져옵니다. 그런 다음 `workspace_root` 값은 `import-n8n/source`, `release` 값은 `release.yaml`로 설정하여 `validate` 도구를 호출하고, `workspace_root` 값은 `import-n8n/source`, `release` 값은 `release.yaml`, `write` 값은 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 작성한 파일을 알려 주십시오. 파일은 `import-n8n/source/dist/` 아래에 있습니다.

테스트하기

단계별 안내에서 실행한 것처럼 스택이 실행 중인 상태에서(자격 증명이 저장되고 워크플로가 활성화된 상태) http://127.0.0.1:5678 주소를 열어 n8n 편집기를 확인하고, 채팅 트리거가 저장하는 사용자와 비밀번호로 메시지를 보내십시오. 사용자와 비밀번호는 curl의 표준 입력을 통해 CHAT_USER와 CHAT_PASSWORD에서 읽습니다:

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

이 실행에서는 OpenAI 키에 자리 표시자를 저장했으므로 워크플로는 모델 호출에서 멈췄고, 편집기의 해당 실행에는 OpenAI의 거부 메시지가 표시됩니다: Incorrect API key provided: sk-place*****************-key.

--target helm으로 가져와 Kubernetes에 적용한 경우에도, 단계별 안내에 나온 것처럼 실행 중인 인스턴스에서 자격 증명을 저장하고 워크플로를 활성화한 뒤 로컬 포트를 해당 Service로 전달하면 n8n은 같은 주소에서 같은 메시지를 받습니다. 실행에서도 그곳에서 같은 응답을 얻었습니다:

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