Get Started

캡슐 어빌리티 사용하기 (Capsule Ability)

캡슐 어빌리티 사용하기 (Capsule Ability)

캡슐 어빌리티 사용하기 (Capsule Ability)

캡슐 어빌리티 사용하기

캡슐 어빌리티(Capsule Ability)는 마운트된 노드를 감싸 전처리와 후처리를 강제로 적용하는 래퍼 어빌리티입니다. 슬롯에 마운트된 노드는 캡슐 어빌리티 내부에서 대리 실행되며, 어빌리티 단위의 재사용 가능한 전·후처리 로직을 구성할 수 있습니다.

이 가이드에서는 개인정보 암호화(마스킹) 캡슐 어빌리티를 만들고, 이를 가데이터 생성 어빌리티에 적용하는 전체 과정을 안내합니다. 가데이터가 생성되면 캡슐 어빌리티를 통해 자동으로 암호화되는 두 단계 흐름으로 구성됩니다.

파트 1. 캡슐 어빌리티 만들기

캡슐 어빌리티 생성

어빌리티 생성 화면에서 캡슐 어빌리티(Capsule Ability) 토글을 켜고 어빌리티를 생성합니다.

주의: 캡슐 어빌리티는 생성 이후 일반 어빌리티로 전환할 수 없습니다. 또한 개별 어빌리티로 단독 실행할 수 없으며, 반드시 다른 어빌리티의 캡슐 노드로만 사용할 수 있습니다.

캔버스에 진입하면 캡슐 어댑터 슬롯(Capsule Adapter Slot)이 기본으로 배치되어 있습니다. 이 슬롯 위치에 추후 일반 어빌리티가 노드 형태로 마운트됩니다.

워크플로 구성

전체 워크플로 연결

다음 순서로 노드를 연결합니다.

캡슐 어댑터 슬롯 설정
캡슐 어빌리티의 인풋과 아웃풋 변수는 Object 타입으로 고정되어 있어 설정하거나 수정할 수 없습니다. 어댑터 슬롯의 인풋 핀에 input 값을 드래그 앤 드롭으로 바인딩합니다.
LLM 노드 설정
LLM 노드를 더블 클릭하여 노드 편집기를 열고 시스템 프롬프트와 사용자 프롬프트를 각각 입력합니다. 이후 단계에서 혼동을 방지하기 위해 출력 변수명을 llm_output (String 타입)으로 변경합니다.
  • 시스템 프롬프트
  • 사용자 프롬프트
Json 데이터를 보고 개인정보로 의심되는 정보를 아래 형식에 맞게 암호화 처리를 위한 '*'로 처리해줘. 출력 형식은 마크다운으로 해줘.
- 형식
1. 이름 : 성만 남겨두고 나머지 모두 '*' (예시: 김**)
2. 주민등록번호 : 뒷자리 모두 '*' (예시: 010101-******)
3. 계좌번호 : 앞자리 4자리 빼고 모두 '*' (1111-***-**


Json 데이터를 보고 개인정보로 의심되는 정보를 아래 형식에 맞게 암호화 처리를 위한 '*'로 처리해줘. 출력 형식은 마크다운으로 해줘.
- 형식
1. 이름 : 성만 남겨두고 나머지 모두 '*' (예시: 김**)
2. 주민등록번호 : 뒷자리 모두 '*' (예시: 010101-******)
3. 계좌번호 : 앞자리 4자리 빼고 모두 '*' (1111-***-**


Json 데이터를 보고 개인정보로 의심되는 정보를 아래 형식에 맞게 암호화 처리를 위한 '*'로 처리해줘. 출력 형식은 마크다운으로 해줘.
- 형식
1. 이름 : 성만 남겨두고 나머지 모두 '*' (예시: 김**)
2. 주민등록번호 : 뒷자리 모두 '*' (예시: 010101-******)
3. 계좌번호 : 앞자리 4자리 빼고 모두 '*' (1111-***-**


파이썬 노드 설정
파이썬(Python) 노드를 더블 클릭하고 LLM이 반환한 llm_output 값을 "Encryption" 키에 저장하는 코드를 작성합니다. 파이썬 노드는 최종적으로 {"python_output": {"Encryption": "..."}} 형태로 반환합니다.

아웃풋 영역에서 출력 변수명을 python_output (Object 타입)으로 설정합니다.
테스트 및 버저닝
런 테스트
JSON 형식의 입력값을 넣고 테스트 실행(RUN TEST)을 클릭합니다. 암호화된 결과값이 반환되면 정상 동작입니다.
{
    "phone": "010-1234-5678",
    "name": "Joy",
    "num": "010101-4123456",
    "address": "Jung-gu, Seoul"
}
{
    "phone": "010-1234-5678",
    "name": "Joy",
    "num": "010101-4123456",
    "address": "Jung-gu, Seoul"
}
{
    "phone": "010-1234-5678",
    "name": "Joy",
    "num": "010101-4123456",
    "address": "Jung-gu, Seoul"
}
디버거에서 노드별 실행 내역을 확인합니다.
버전 추가
캡슐 어빌리티를 다른 어빌리티의 캡슐 노드로 사용하려면 반드시 버전이 등록되어 있어야 합니다. 상단 컨트롤러에서 버전(Version)을 클릭하고 + 버튼을 눌러 버전을 추가합니다.
버전이 등록되면 이후 버전 단위로 롤백할 수 있습니다.
파트 2. 일반 어빌리티에 캡슐 어빌리티 적용하기
일반 어빌리티 생성
캔버스에서 나가 어빌리티 목록으로 돌아갑니다. + 새 어빌리티 버튼을 클릭하고, 캡슐 어빌리티 토글을 켜지 않은 상태로 일반 어빌리티를 생성합니다.
워크플로 구성
기본 워크플로를 다음과 같이 구성합니다.
인풋 노드를 더블 클릭하여 노드 편집기를 열고 input 변수를 String 타입으로 선언합니다.
캡슐 어빌리티 노드 연결
캡슐 어빌리티 노드 추가
노드 패널의 나의 어빌리티 카테고리에서 앞서 만든 캡슐 어빌리티를 캔버스로 드래그 앤 드롭합니다.
캡슐 어빌리티 노드는 사용할 어빌리티와 버전을 선택해야 활성화됩니다. 파트 1에서 버저닝이 필요했던 이유가 여기에 있습니다.
LLM 노드에 캡슐 장착
캡슐 어빌리티 노드를 LLM 노드 위로 드래그 앤 드롭합니다. LLM 노드가 캡슐 어빌리티 안에 감싸지는 형태가 됩니다.
노드 설정
LLM 노드 출력 변수 설정
LLM 노드를 더블 클릭하여 노드 편집기를 열고 출력 변수명을 Encryption (String 타입)으로 변경합니다. 캡슐 어빌리티의 아웃풋 변수명이 Encryption으로 선언되어 있기 때문에 이름을 맞춰야 합니다.
시스템 프롬프트와 사용자 프롬프트를 작성합니다. 이 예제에서는 나라명을 입력하면 해당 국가의 인적사항 가데이터(개인정보 샘플)를 생성하는 프롬프트를 사용합니다.
  • 시스템 프롬프트






  • 사용자 프롬프트






아웃풋 노드 설정
아웃풋 노드를 더블 클릭하여 노드 편집기를 열고 output 변수를 선언한 뒤 Encryption 변수를 드래그 앤 드롭으로 바인딩합니다.
런 테스트 및 결과 확인
입력창에 한국을 입력하고 테스트 실행(RUN TEST)을 클릭합니다. 가데이터가 생성된 뒤 캡슐 어빌리티를 통해 암호화된 개인정보가 출력됩니다.
디버거에서 캡슐 어빌리티가 정상적으로 동작했음을 확인합니다.
다음 단계
설정이 완료되었습니다.
이제 캡슐 어빌리티를 활용해 어떤 어빌리티에도 전처리·후처리 로직을 일관되게 적용할 수 있습니다. 보안이 필요한 데이터 처리, 공통 유효성 검사, 로깅 등 다양한 시나리오에 재사용해 보시기 바랍니다.