[최신] 벨루가 에이전트 빌더 기능 출시
Show more
Subscribe
벨루가 에이전트 설명서
Chapter 1. 에이전트 빌더
에이전트는 채널이 있는 상태에서만 접근할 수 있습니다
대시보드
•
대시보드로 이동해 주세요.
•
좌측 에이전트 빌더 버튼을 눌러 주세요.
💡 Veluga Agent Tips
만약 만들어둔 채널이 없다면 챗봇 빌더 가이드를 따라서 만들어 보세요.
만약 만들어둔 채널이 없다면 챗봇 빌더 가이드를 따라서 만들어 보세요.
에이전트 빌더에 처음 들어오면 다음과 같은 화면이 있습니다
※ 적용할 채널 선택하기
•
채널을 검색해서 원하는 채널을 선택합니다.
•
적용하기 버튼을 눌러 선택한 채널의
•
에이전트를 관리합니다.
※ 에이전트 만들기
•
선택된 채널에 에이전트를 생성합니다.
에이전트 만들기 버튼을 클릭하면 아래 화면이 나타납니다
주요 기능 설명
•
에이전트 이름 : 에이전트의 이름을 변경할 수 있습니다.
•
에이전트 노드 : 노드를 이어서 원하는 기능을 만들 수 있습니다.
•
에이전트 노드 추가 : 새로운 노드를 추가할 수 있습니다.
•
테스트 : 만들어진 에이전트를 적용하기 전에 테스트할 수 있습니다.
•
저장하기 : 수정한 내용을 저장할 수 있습니다.
•
노드 정렬 : 보기 불편하게 배치된 노드를 정렬할 수 있습니다.
•
화면 정렬 : 모든 노드가 들어오게 화면 크기를 조절합니다.
•
화면 확대 / 축소 : 화면을 확대하거나 축소할 수 있습니다.
•
이전 / 다음 작업 : 이전 작업으로 돌아가거나 다음 작업으로 돌아갈 수 있습니다.
•
가져오기 / 내보내기 : 곧 새로운 기능으로 찾아올 예정입니다. coming soon !!
💡 Veluga Agent Tips
이전 / 다음 작업 기능은 Ctrl + Z와 같은 기능이에요.
이외에도 벨루가 에이전트는 다양한 기능이 있어요!
다양한 기능들을 직접 써보면서 알아가 봐요!
이전 / 다음 작업 기능은 Ctrl + Z와 같은 기능이에요.
이외에도 벨루가 에이전트는 다양한 기능이 있어요!
다양한 기능들을 직접 써보면서 알아가 봐요!
Chapter 2. 에이전트 만들기
에이전트 빌더? 노드?
에이전트 빌더의 하나하나 박스들을 노드(Node)라고 부릅니다.
에이전트 빌더는 원하는 노드들을 이어서 내가 원하는 동작 흐름을 구성할 수 있는 기능입니다.
벨루가의 많은 노드 중 많이 쓰이는 노드들을 먼저 소개하겠습니다.
기본 연결
모든 노드들은 서로 연결할 수 있습니다. 연결된 노드들만이 서로 연결되어 동작합니다.
노드의 연결 방법은 노드의 끝점과 다음 노드 시작점을 이어주면 됩니다.
서로 연결된 노드 사이에는 선으로 연결되어 있습니다.
서로 연결된 노드 사이에는 선으로 연결되어 있어요.
💡 Veluga Agent Tips
만약 잘못 연결해서 취소하고 싶으면 선을 더블 클릭하면 돼요.
만약 잘못 연결해서 취소하고 싶으면 선을 더블 클릭하면 돼요.
테스트
테스트를 위해 AI 노드 등으로 결과를 출력할 수 있습니다.
간단하게 테스트를 진행해 보겠습니다.
테스트를 위해 텍스트 노드는 다음과 같이 설정했습니다.
테스트를 위해 AI 노드의 시스템 프롬프트는 다음과 같이 작성했습니다.
위와 같이 설정하고, 우측에서 테스트가 가능합니다.
실행하기
실행 중일 때는 노드들이 강조되며 에이전트가 어떤 흐름으로 동작하는지 확인할 수 있습니다.
만약 값을 잘못 입력하거나 에러가 난 노드들은 경고를 표시합니다.
💡 Veluga Agent Tips
미리 어떤 에이전트를 만들 건지 충분히 고민하고, 만들기 시작하면 에러를 최소화할 수 있어요.
미리 어떤 에이전트를 만들 건지 충분히 고민하고, 만들기 시작하면 에러를 최소화할 수 있어요.
Chapter 3. 변수 사용하기
변수
벨루가 에이전트 빌더는 변수를 활용할 수 있습니다.
하지만 변수를 안전하게 사용하기 위해서 몇 가지 규칙이 있습니다.
노드 출력 변수명 작성 규칙
1.
시스템 변수는 사용할 수 없습니다.
e.g., {channel_id} 등
e.g., {channel_id} 등
2.
언더스코어(_)를 제외한 특수문자는 사용할 수 없습니다.
3.
공백은 변수명으로 사용할 수 없습니다.
4.
숫자로 시작할 수 없습니다.
e.g., 123veluga, 012345 등 사용 불가
e.g., 123veluga, 012345 등 사용 불가
5.
영문, 숫자, 언더스코어(_) 조합만 사용 가능합니다.
변수 사용 방법
1.
{변수명} : 기본적으로 변수는 모두 중괄호로 묶어서 사용합니다.
2.
AI 출력 변수명['특정 키'] : AI 노드에서 json 출력 시, 특정 값으로 조건분기를 사용할 때의 사용법입니다.
💡 Veluga Agent Tips
변수의 값이 숫자인지 "문자"인지 잘 확인해 보세요.
Tab 키를 누르면 자동완성이 가능해요.
변수의 값이 숫자인지 "문자"인지 잘 확인해 보세요.
Tab 키를 누르면 자동완성이 가능해요.
Chapter 4. 저장하기 및 에이전트 사용하기
저장하기
에이전트 작업이 끝난 후, 우측 상단 저장하기
버튼을 통해 에이전트를 저장할 수 있습니다.
다른 이름으로 저장하기 / 삭제하기
에이전트 작업이 끝난 후, 우측 상단 저장하기
버튼 좌측의 ⁝ 버튼을 눌러 다른 이름으로 저장
하거나 삭제할 수 있습니다.
1개 이상의 에이전트가 생성된 경우, 에이전트 빌더 페이지에 카드형으로 나타나게 됩니다.
해당 카드에서의 기능은 다음과 같습니다.
•
활성화 상태 : 에이전트의 활성화 상태를 나타냅니다.
•
활성화 토글 : 토글을 클릭해 에이전트의 활성화 / 비활성화 상태를 전환할 수 있습니다.
•
노드 수정하기 : 노드를 수정할 수 있는 에이전트 빌더로 이동됩니다.
•
삭제하기 : 에이전트를 삭제할 수 있습니다.
•
마지막 수정일자 : 에이전트의 마지막 수정 일자를 나타냅니다.
에이전트 적용 / 사용하기
에이전트를 사용하기 위해서는 반드시 에이전트를 활성화해야 합니다.
에이전트가 활성화되면, 채널에 바로 적용됩니다. 채팅하기 기능으로 바로 사용할 수 있습니다.
만약 에이전트 적용이 안 된다면 페이지 새로 고침 혹은 채팅창을 새로 열어보세요.
⚠️ 에이전트 주의 사항
에이전트 설계
기본적으로 적용되어 있는 에이전트도 우수하기에 커스텀 과정은 충분한 설계를 가지고 진행하는 것을 추천드립니다.
특히 프롬프트를 짜는 방법에 따라서 결과값이 천차만별입니다.
아래 블로그를 참고하시면 더욱 좋은 결과물을 얻을 수 있습니다.
변수와 함수를 잘못 사용하면 에이전트가 오작동을 일으킵니다.
항상 함수를 사용할 때 변수값을 잘 확인하고 사용해야 합니다.
저장하기
에이전트는 노드가 많아질수록 내용이 복잡해집니다.
저장을 주기적으로 하면 작업 내용이 사라지는 불상사가 없을 것입니다.
개선하기
벨루가는 언제나 여러분의 의견을 존중합니다.
더 좋은 아이디어가 있으면 문의 남겨 주시면 내부 논의 후 적용하도록 하겠습니다.
© Veluga Inc. All Rights Reserved.