노드 사용법 익히기 - 슬립 필드 수정(Slip Field Update) 노드

슬립 필드 수정(Slip Field Update) 노드는 슬립의 제목·요약·본문을 필드 단위로 완전히 덮어쓰는 노드입니다. 전달한 필드는 통째로 새 값으로 교체되므로, 본문 안의 특정 문장이나 단어만 바꾸고 싶다면 이 노드 대신 슬립 텍스트 치환(Slip Text Replace) 노드를 사용해야 합니다.

이 노드는 에이전트에 도구로 연결해 활용하기도 좋지만, 이 튜토리얼에서는 가장 기본적인 사용법을 확인할 수 있도록 어빌리티에서 다룹니다. 에이전트에 연결하는 방법은 별도의 슬립박스 에이전트 통합 가이드에서 다룰 예정입니다.

이 튜토리얼에서는 미리 만들어 둔 '고객 리뷰 대응 봇' 슬립의 제목·요약·본문을 새 내용으로 완전히 교체하는 어빌리티 워크플로를 완성합니다.

사전 준비

이 튜토리얼을 시작하기 전에 프로젝트에 슬립박스가 구축되어 있고, 수정할 대상 슬립이 이미 만들어져 있어야 합니다. 슬립박스 구성 방법은 🔗슬립박스 가이드를 참고하시기 바랍니다.

이 튜토리얼을 완료하면 다음을 수행할 수 있습니다.

1. 슬립 필드 수정 노드로 슬립의 제목·요약·본문을 필드 단위로 교체할 수 있습니다.

2. 슬립 필드 수정 노드의 각 입력 변수를 시작 노드의 입력값과 연결할 수 있습니다.

3. 수정할 슬립이 속한 슬립박스를 지정할 수 있습니다.

4. 노드 테스트와 디버그 로그로 슬립 내용이 정상적으로 수정됐는지 확인할 수 있습니다.

워크플로 개요

이 튜토리얼의 핵심은 슬립 필드 수정 노드입니다.

슬립 필드 수정 노드는 대상 슬립의 공개 UUID(slip_public_uuid)로 수정할 슬립을 지정하고, 전달한 필드(title·body_md·summary·slip_type)만 새 값으로 교체합니다. 전달하지 않은 필드는 기존 값 그대로 유지됩니다.

슬립 필드 수정 노드 기본 정보

슬립 필드 수정 노드는 아래 옵션을 제공합니다.

title·body_md·summary·slip_type처럼 선택 항목인 필드는 값을 그대로 유지하고 싶다면 어댑터 변수 자체를 바인딩하지 않아야 합니다. 바인딩해 둔 채로 빈 문자열을 전달하면, 그 필드는 빈 값으로 덮어써져 기존 내용이 삭제됩니다.

이 튜토리얼에서는 슬립박스 공개 UUID·slip_public_uuid·title·body_md·summary를 바인딩하고, slip_type과 current_version은 바인딩하지 않습니다.

1단계: 어빌리티 생성

새 어빌리티를 생성합니다. 이름에 슬립 필드 수정 노드, 설명에 고객 리뷰 대응 봇 내용 업데이트를 입력합니다. 슬립 필드 수정 노드를 사용해 이미 만들어 둔 '고객 리뷰 대응 봇' 슬립의 내용을 새로 작성하는 워크플로를 이 어빌리티에서 구성합니다.

2단계: 시작 노드 설정

시작 노드를 더블 클릭하여 노드 편집기로 진입합니다. String 타입의 변수 다섯 개와 Int 타입의 변수 한 개를 추가합니다.

• uuid: 수정할 슬립의 공개 UUID를 입력받습니다. (String)

• title: 새 제목을 입력받습니다. (String)

• body: 새 본문을 입력받습니다. (String)

• summary: 새 요약을 입력받습니다. (String)

• type: 새 슬립 분류를 입력받습니다. (String)

• version: 현재 버전 번호를 입력받습니다. (Int)

3단계: 슬립 필드 수정 노드 추가

+노드 추가(Add Node) → 슬립박스(Slipbox) 카테고리에서 슬립 필드 수정 노드를 추가합니다.

4단계: 슬립 필드 수정 노드 설정

슬립 필드 수정 노드를 더블 클릭하여 노드 편집기로 진입합니다. 슬립박스 공개 UUID에서 '고객 리뷰 대응 봇' 슬립이 속한 슬립박스를 선택합니다.

입력 변수 바인딩

나머지 항목에는 아래와 같이 시작 노드의 입력값을 드래그 앤 드롭으로 바인딩합니다.

slip_type과 current_version은 이 튜토리얼에서 비워둡니다.

노드가 정상 실행되면 error_code, error_message를 출력합니다.

5단계: 종료 노드 설정

종료 노드를 더블 클릭하여 노드 편집기로 진입합니다. String 타입의 result 출력변수를 추가하고 슬립 필드 수정 노드의 error_code를 드래그 앤 드롭으로 바인딩합니다. 이렇게 하면 슬립 내용이 정상적으로 수정됐는지 실패했는지를 출력값으로 확인할 수 있습니다.

6단계: 수정할 슬립의 UUID 복사

슬립박스에서 '고객 리뷰 대응 봇' 슬립을 클릭하고, 우측 정보 패널에서 슬립의 공개 UUID를 복사해둡니다. 이 값은 노드 테스트에서 uuid 입력값으로 사용합니다.

7단계: 노드 테스트 실행

uuid에는 앞서 복사한 슬립의 공개 UUID를 붙여넣습니다. 기존에 작성된 내용을 완전히 새로 작성하기 위해 title에는 리뷰 대응 매뉴얼, summary와 body에는 각각 새로 작성 예정을 입력합니다. version과 type은 비워둔 채로 테스트 실행(RUN TEST)을 클릭합니다. result 출력값으로 SUCCESS가 나오면 성공입니다.

8단계: 디버그 로그 확인

슬립 필드 수정 노드의 디버그 로그를 확인하면 error_code가 SUCCESS로 반환된 세부 내역을 확인할 수 있습니다.

9단계: 슬립박스에서 수정 결과 확인

슬립박스로 이동해 '고객 리뷰 대응 봇' 슬립을 열어보면, 제목이 리뷰 대응 매뉴얼로, 요약과 본문이 새로 작성 예정으로 바뀐 것을 확인할 수 있습니다.

다음 단계

🎉 축하합니다! 에이전트리아를 사용해 '고객 리뷰 대응 봇 내용 업데이트' 워크플로를 완성했습니다.

이 노드를 에이전트 루프 노드에 도구로 연결하면, 에이전트가 대화 중 필요하다고 판단할 때 슬립 내용을 스스로 갱신하는 워크플로로도 확장할 수 있습니다.

에이전트리아는 아이디어를 현실로 바꾸는 가능성의 공간입니다.

당신의 상상력으로 워크플로는 무한히 확장될 수 있습니다.

• 더 많은 노드 활용 예제가 궁금하다면 🔗노드 사용법 페이지를 확인하세요.

자주 묻는 질문

슬립 필드 수정 노드는 무엇을 하는 노드인가요?

슬립 필드 수정 노드는 슬립박스(Slipbox)에 저장된 슬립의 제목·요약·본문·유형을 필드 단위로 덮어쓰는 노드입니다. 대상 슬립을 공개 UUID로 지정하고, 전달한 필드만 새 값으로 교체됩니다.

슬립 필드 수정 노드와 슬립 텍스트 치환 노드는 어떻게 다른가요?

슬립 필드 수정 노드는 제목·요약·본문 같은 필드 전체를 통째로 새 값으로 교체합니다. 반면 본문 안에서 특정 문장이나 단어 일부만 바꾸고 싶다면, 고유하게 일치하는 텍스트를 찾아 부분적으로 치환하는 슬립 텍스트 치환 노드를 사용해야 합니다.

일부 필드만 수정할 수도 있나요?

네, 가능합니다. 다만 값을 유지하고 싶은 필드는 어댑터 변수 자체를 바인딩하지 않아야 합니다. 예를 들어 요약만 수정하고 싶다면 summary에만 값을 바인딩하고 title·body_md는 바인딩하지 않은 채로 둡니다. 필드를 바인딩해 둔 상태로 빈 문자열을 전달하면 그 필드는 빈 값으로 덮어써져 기존 내용이 삭제되므로 주의해야 합니다.

current_version은 어떤 경우에 사용하나요?

여러 워크플로나 사용자가 같은 슬립을 동시에 수정할 수 있는 환경에서, 마지막으로 확인한 버전 번호를 current_version에 함께 전달하면 그 사이에 다른 곳에서 먼저 수정되어 버전이 달라졌는지 확인할 수 있습니다. 비워두면 버전 확인 없이 바로 수정됩니다.