Dify 애플리케이션 가져오기 — Dify 설치 안의 채팅 어시스턴트
Dify DSL로 내보낸 Dify 채팅 애플리케이션을 aggrega import로 Aggregate, Release, Manifest로 가져옵니다. 이들은 그 애플리케이션을 담은 표준 라이브러리의 Dify 설치를 작성된 그대로 Kubernetes용으로 빌드합니다.
Dify 애플리케이션 가져오기에서는 명령, 그 명령이 작성하는 파일, 빌드, 그리고 빌드한 결과의 실행을 단계별로 안내합니다. 이 폴더에는 그 안내의 각 단계가 들어 있습니다:
| 폴더 | 내용 |
|---|---|
source/ | 애플리케이션 support-assistant.yml; 폴더를 워크스페이스로 만드는 .aggrega-config.yaml; 그리고 어떤 애플리케이션도 담을 수 없는 내용에 대한 답변인 import-answers.yaml: 설치의 애플리케이션 시크릿과 소유자 비밀번호를 담은 Kubernetes Secret의 이름, 그리고 소유자 계정의 이메일 |
draft/ | aggrega import support-assistant.yml --target helm 명령이 작성한 파일(변경 없음)과 출력한 내용: 표준 출력은 stdout.txt, 표준 오류는 import.txt |
source/support-assistant.yml 파일은 이 예제를 위해 Dify가 DSL 버전 0.7.0에서 애플리케이션을 내보내는 형태로 작성되었습니다.
문서 저장소의 체크아웃에서 check.sh는 가져오기를 다시 실행하고, 작성하고 출력한 내용을 draft/와 비교하고, 안내에서 인용하는 블록을 이 파일들과 비교한 뒤, 가져오기가 작성한 내용을 검증하고 빌드합니다. 표준 라이브러리 카탈로그(얻는 곳)가 이 저장소 옆에 체크아웃되어 있거나, 그 디렉터리가 AGGREGA_CATALOG_DIRS에 지정되어 있어야 합니다.
예제 생성하기
이 예제의 가져오기는 아래 명령으로 실행하거나 AI 어시스턴트에게 대신 실행하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example import-dify그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd import-dify빌드
가져오기는 프로젝트 옆의 source/에 Aggrega 파일 초안을 작성하고, 어떤 애플리케이션도 담을 수 없는 내용을 import-answers.yaml에서 가져오며, 빌드에 필요한 항목을 풀합니다. 프로젝트를 표준 라이브러리 카탈로그와 비교하는데, 이 카탈로그는 워크스페이스의 기본 레지스트리가 서명된 스냅샷으로 게시합니다. 첫 번째 가져오기에서 이를 가져와 검증하고, 워크스페이스의 콘텐츠 캐시에 보관하며, 초안 옆에 작성하는 기록에 그 다이제스트로 이름을 남깁니다. 자체 카탈로그 폴더를 지정한 워크스페이스는 — AGGREGA_CATALOG_DIRS에서 또는 workspace.catalog_dirs 아래에서 — 대신 그 폴더를 기준으로 가져옵니다:
cd sourceaggrega import support-assistant.yml --target helmaggrega validate --release release.yamlaggrega build --release release.yaml빌드의 매니페스트가 읽는 Secret을 만드는 방법과 매니페스트를 실행하는 방법은 위에 링크된 단계별 안내에 있습니다.
AI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고, 폴더를 직접 만들지 마십시오. 작업 영역 폴더에 아직 `import-dify` 폴더가 없으면 `example`를 `import-dify`로 설정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 이 도구는 예제를 새 `import-dify` 폴더에 작성하며, 그 `source` 폴더에는 이 예제가 가져오는 내용이 들어 있습니다. 그런 다음 `workspace_root`를 `import-dify/source`로, `source`를 `support-assistant.yml`로, `target`을 `helm`으로 설정하여 `import` 도구를 호출하십시오. 이 도구는 `support-assistant.yml` 옆의 `import-answers.yaml`에서 필요한 답변을 읽고, 초안을 `import-dify/source`에 작성하며, 초안에 필요한 것을 가져옵니다. 그런 다음 `workspace_root`를 `import-dify/source`로, `release`를 `release.yaml`로 설정하여 `validate` 도구를 호출하고, `workspace_root`를 `import-dify/source`로, `release`를 `release.yaml`로, `write`를 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 작성한 파일을 알려 주십시오. 파일은 `import-dify/source/dist/` 아래에 있습니다.테스트하기
--target compose로 가져오고 단계별 안내의 Docker Compose에서에 나온 대로 시작하면, 설치는 이 머신에서 응답합니다. API는 http://127.0.0.1:5001에서, 콘솔은 http://127.0.0.1:3001/signin에서 응답합니다. 애플리케이션은 자체 키로 보낸 메시지에 응답하며, 이 키는 단계별 안내에서 로그인하고, 초안 Release의 marketplace_enabled로 설치 환경이 접근할 수 있게 된 Dify 플러그인 마켓플레이스에서 OpenAI 공급자를 설치하고, 공급자의 키를 설정한 후에 만듭니다:
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"}'이 실행의 공급자 키는 자리 표시자였고, 설정할 때 Dify가 OpenAI의 Incorrect API key provided로 거부했으므로 메시지는 다음 응답을 받았습니다:
{"code":"provider_not_initialize","message":"Model gpt-4o-mini credentials is not initialized.","status":400}위와 같이 Kubernetes용으로 빌드하고 단계별 안내의 실행하기에서 적용하는 대로 적용하면, 로컬 포트를 해당 Service로 전달한 뒤 API가 같은 주소에서 같은 요청에 응답합니다. 이 실행에서도 그곳에서 같은 응답을 받았습니다:
kubectl port-forward -n <namespace> svc/dify-zdapi-default 5001:5001