설명에서 deploy 가능한 패키지까지
흐름을 평소 쓰는 말로 설명하면 Integration Suite로 가져올 수 있는 .zip을 받습니다. Spec 모드에서는 모델이 spec JSON을 만들고, 결정적 builder가 검증된 블록으로 BPMN2 XML을 조립합니다. "아마 맞을" 결과가 아니라 구조상 올바른 결과입니다.
베타 · 실험 진행 중
통합을 설명하세요. iFlow가 나옵니다.
IFlow Assistant는 PC에서 실행되는 Ollama 모델로 SAP Integration Suite용 Integration Flow를 생성하며, 여러분이 가르친 template과 솔루션에서 배웁니다. 평소 쓰는 말로 된 요청부터 deploy 가능한 패키지까지, lint, Security Check, tenant로의 deploy를 함께 제공합니다.
Windows 10/11 64비트 · 무료 오픈 소스 · 자동 업데이트 · 모든 것이 PC에 남습니다
만든 이유
조금 무모한 프로젝트입니다. Ollama로 로컬에서 모델을 훈련하는 일을 시작해 보고 싶었고, 제가 가르친 template과 솔루션을 바탕으로 iFlow 작성을 빠르게 해 주는 도구를 갖고 싶었습니다. 완성된 제품이 아니라 실제로 매일 업무에 쓰고 있는 실험이며, 있는 그대로 공유합니다.
실제로 모델을 다시 훈련하지는 않습니다. 모델은 로컬 knowledge base(RAG)를 통해 "배웁니다". 여기에는 여러분의 export, 분류한 template, 승인한 생성 패키지가 쌓입니다. 새 요청마다 가장 비슷한 조각이 덧붙여져 PC의 Ollama 모델로 전달됩니다. 결과가 좋으면 앱에 알려 주세요. 그때부터 이후 생성에 반영됩니다.
모든 것이 로컬에서 실행됩니다. 클라우드도, 계정도, 텔레메트리도 없습니다. 베타이며 분명한 한계가 있고, 아래에 에두르지 않고 적어 두었습니다.
기능
매일 iFlow를 만드는 사람을 위한 데스크톱 도구: 설명에서 시작해 tenant까지 이어집니다.
여러 차례 주고받는 대화
같은 대화에서 흐름을 다듬으세요: "재시도 추가해 줘", "메일도 보내 줘", "매핑을 local process로 분리해 줘". 차례마다 패키지가 다시 생성됩니다.
여러분의 iFlow에서 배웁니다 (RAG)
직접 추가하거나 tenant에서 가져온 export는 모두 로컬 knowledge base에 인덱싱되어 이후 생성을 이끕니다. "Buono"(좋음) 버튼은 승인한 생성 패키지도 추가합니다.
Lint와 Security Check
모든 패키지는 교차 참조, sequenceFlow, processRef, 선언된 {{...}} 파라미터를 확인하는 lint를 거칩니다. Security Check는 평문 비밀번호와 하드코딩된 개인정보(PII)를 찾으며, 발견한 값은 항상 가려서 보여 줍니다.
tenant에서의 전체 사이클
Design workspace 패키지에 등록, deploy, runtime 상태 대기, 최신 Message Processing Logs에 대한 smoke test까지. 여러 tenant 프로필(dev, test, prod)을 GUI에서 바로 다룹니다.
Explorer와 BPMN 뷰어
zip을 풀지 않고 탐색하고, 강조 표시된 XML을 읽고, 계층형 레이아웃과 각 단계의 속성을 보여 주는 BPMN 캔버스를 엽니다. 모든 프로젝트에서: View, Edit, Lint, Ripacchetta(다시 패키징), Deploy.
Template 우선과 안내 질문
KB 소스를 template으로 분류하면(예: SuccessFactors 또는 SFTP) 그 규칙이 명시적인 제약이 됩니다. "안내 질문"은 생성 전에 빠진 요구 사항을 모읍니다: 매핑, 처리량, 재시도, 멱등성, 보안.
제품 프로필과 분리된 고객 KB
SuccessFactors, S/4HANA OData, LDAP, Zucchetti, SOAP에 제품 문서를 연결하세요. 고객마다 매핑, 규칙, 워크플로를 별도의 KB에 보관하며, 모델은 해당 고객을 선택하고 그 비밀번호로 잠금을 해제했을 때만 그 KB를 사용합니다.
기능 문서와 기술 문서
iFlow에서 Markdown 문서와 PDF로 인쇄할 수 있는 HTML 문서를 생성합니다. 고객에게 전달할 문서와 유지보수 담당자를 위한 문서 모두 만들 수 있습니다.
작동 방식
모델은 명세만 작성합니다. XML은 결정적 코드가 만들기 때문에 모델의 실수는 바로 드러나고 tenant까지 가지 않습니다.
- 1
요청
자연어로 흐름을 설명합니다. template, 제품 프로필, 고객 KB는 선택 사항입니다.
- 2
RAG knowledge base
SQLite + nomic-embed-text: 여러분의 iFlow에서 가장 비슷한 조각이 컨텍스트에 들어갑니다.
- 3
로컬 Ollama 모델
CPI용 system prompt를 갖춘 qwen2.5-coder가 PC에서 실행됩니다.
- 4
Spec JSON
단계, adapter, 파라미터, local process, 오류 처리를 검증된 구조로 담습니다.
- 5
결정적 builder
알려진 블록으로 BPMN2 XML을 조립합니다. "지어낸" XML은 없습니다.
- 6
Lint
교차 참조, 스크립트 존재 여부, 파라미터 선언, XML 유효성.
- 7
Zip
Integration Suite로 가져올 수 있고 BPMN 캔버스에서 볼 수 있는 패키지.
- 8
Tenant
등록, deploy, runtime 상태, 로그에 대한 smoke test.
세 단계로 설치
64비트 Windows 10 또는 11과 모델을 위한 약간의 디스크 공간만 있으면 됩니다.
Ollama 설치
ollama.com에서 내려받아 설치하세요. 모델을 로컬에서 실행하는 엔진입니다.
IFlowAssistant-Setup.exe 실행
설치 프로그램은 관리자 권한 없이 앱을 사용자 폴더에 복사합니다. 또는 포터블 버전을 원하는 곳에 압축 해제하세요.
모델 준비
앱에서: Modello(모델) 메뉴 → Prepara o aggiorna il modello Ollama...(Ollama 모델 준비 또는 업데이트). qwen2.5-coder(CPU용 7B 약 5GB, 12GB NVIDIA GPU용 14B 약 9GB)와 nomic-embed-text를 내려받은 뒤 knowledge base를 인덱싱합니다.
스스로 업데이트됩니다.
앱이 GitHub Releases를 확인해 새 설치 프로그램을 내려받고, SHA-256을 검증한 뒤 조용히 실행합니다. 여러분의 데이터(knowledge base, 프로필, 생성된 iFlow)는 건드리지 않습니다.
포터블 버전: 새 패키지 링크가 담긴 알림을 받고, 언제 교체할지는 직접 정합니다.
데이터는 여러분의 것입니다
짧게 답하면: 여러분의 PC에만 있고, 다른 어디에도 없습니다.
로컬 모델
모델은 여러분의 컴퓨터에 있는 Ollama에서 실행됩니다. 요청, iFlow, knowledge base는 어떤 서비스로도 전송되지 않습니다.
텔레메트리 없음
외부 연결은 업데이트 확인을 위한 GitHub Releases, 그리고 여러분이 요청할 때의 tenant뿐입니다.
마스터 비밀번호
마스터 비밀번호가 로컬 설정과 프로필을 암호화합니다. 비밀번호가 없으면 파일을 읽을 수 없습니다.
Credential Manager에 저장되는 비밀 정보
tenant의 client secret과 비밀번호는 Windows Credential Manager에 저장되며, 파일에는 절대 저장되지 않습니다.
분리된 고객 KB
각 고객의 소스는 일반 검색에서 제외되며, 해당 고객을 선택하고 그 비밀번호로 잠금을 해제했을 때만 모델에 전달됩니다. 비밀번호는 KB 사용을 허용하지만 디스크의 파일을 암호화하지는 않습니다. 파일을 보호하려면 BitLocker 같은 디스크 암호화를 사용하세요.
알려진 한계
제품에 대한 솔직한 이야기: 베타이므로 다운로드 전에 알아 두면 좋은 점들입니다.
-
Spec builder는 가장 흔한 구성 요소를 지원합니다
Timer와 HTTPS 시작, Content Modifier, XSLT, Groovy, Process Call과 선형 local process, Request-Reply HTTP/ProcessDirect/SuccessFactors, Send Mail과 SFTP, OK/KO router 하나, Exception Subprocess. Splitter/Gather, Data Store 또는 여러 router가 필요하면 Markdown 모드로 전환되며, 이 경우 deploy 전에 Web UI에서 패키지를 확인해야 합니다.
-
tenant 클라이언트는 구조적으로만 검증됨
Integration Suite의 공개 OData API를 구현하지만 몇 안 되는 tenant에서만 시험했습니다. 처음 연결할 때는 "Test connessione"(연결 테스트)를 사용하고 차이가 있으면 알려 주세요.
-
CPU에서는 몇 분이 걸립니다
CPU에서 7B 모델을 쓰면 생성 한 번에 몇 분이 걸립니다. NVIDIA GPU와 14B 모델을 쓰면 훨씬 빠르고 품질도 더 좋습니다.
-
Windows 우선
Linux와 macOS에서는 소스에서 앱을 실행할 수 있지만 tenant 비밀 정보가 저장되지 않으므로, deploy하려면 세션마다 비밀 정보를 입력해야 합니다. 설치 프로그램과 자동 업데이트는 Windows에서만 제공됩니다.
프로젝트 후원
IFlow Assistant는 무료이며 앞으로도 무료입니다. 오후 한나절을 아껴 주었다면, 커피 한 잔이 그 사실을 알려 주는 가장 간단한 방법이자 새 모델을 시험하는 GPU를 계속 돌아가게 하는 방법입니다.
PayPal로 커피 한 잔 사 주기GitHub에 잘 작성된 이슈 하나도 큰 도움이 됩니다.
자주 묻는 질문
가장 자주 받는 질문들입니다.
GPU가 필요한가요?
아니요. CPU와 16GB 이상의 RAM이면 7B 모델이 작동하지만 생성에 몇 분이 걸립니다. 12GB 이상의 NVIDIA GPU가 있으면 14B 모델이 수십 초 안에 응답하고 더 정확한 spec을 만듭니다.
제 iFlow가 PC 밖으로 나가나요?
아니요. knowledge base는 로컬 SQLite 파일이고, 모델은 여러분 컴퓨터의 Ollama에서 실행되며, 텔레메트리는 없습니다. 앱은 업데이트를 위해 GitHub Releases에, 그리고 등록, deploy, 가져오기를 시작할 때 여러분의 tenant에만 연결합니다.
다른 모델을 쓸 수 있나요?
네. cpi-iflow-builder 모델은 패키지에 포함된 Modelfile로 만들어집니다. 기본 모델을 바꾸고(예: Ollama에서 쓸 수 있는 다른 coder 모델) Modello(모델) 메뉴 → Ricrea il modello dal Modelfile (ollama create)에서 다시 만들 수 있습니다. CPI system prompt는 그대로 유지됩니다.
제 template은 어떻게 추가하나요?
Knowledge base 탭에서 .zip export를 knowledge base에 추가하거나 tenant에서 바로 가져오세요. 그런 다음 소스를 선택하고 "Template"으로 분류하면, 그때부터 생성 화면의 Template KB 메뉴에 나타나고 그 규칙이 명시적인 제약이 됩니다.
deploy는 정확히 무엇을 하나요?
"Censisci + Deploy"(등록 + Deploy)는 활성 tenant의 Design workspace 패키지에 패키지를 업로드하고, deploy를 시작하고, runtime 상태(STARTED 또는 ERROR)를 기다린 다음, smoke test로 최신 Message Processing Logs를 읽습니다. 다른 아티팩트는 건드리지 않으며 아무것도 삭제하지 않습니다.
Mac이나 Linux에서도 되나요?
부분적으로 됩니다. 코드가 Python과 tkinter로 되어 있어 install/에 있는 스크립트로 소스에서 실행할 수 있습니다. 다만 설치 프로그램, 자동 업데이트, 그리고 현재 Windows Credential Manager를 사용하는 tenant 비밀 정보 저장 기능은 없습니다.
SAP 제품인가요?
아니요. 개인적인 용도로 시작한 독립 오픈 소스 프로젝트(MIT 라이선스)이며, SAP SE와 제휴하거나 SAP SE의 후원 또는 승인을 받지 않았습니다. Integration Suite의 문서화된 공개 API만 사용합니다.