# 벨루가 에이전트 설명서 ## Chapter 1. 에이전트 빌더 ### 에이전트는 채널이 있는 상태에서만 접근할 수 있습니다 ### 대시보드 - 대시보드로 이동해 주세요. - 좌측 에이전트 빌더 버튼을 눌러 주세요. ![Image](https://upload.cafenono.com/image/slashpageHome/20260212/131935_x0t7Mbjg97FnEmCKHl?q=80&s=1280x180&t=outside&f=webp) > 💡 _Veluga Agent Tips_ > 만약 만들어둔 채널이 없다면 챗봇 빌더 가이드를 따라서 만들어 보세요. > --- ### 에이전트 빌더에 **처음** 들어오면 다음과 같은 화면이 있습니다 ![Image](https://upload.cafenono.com/image/slashpageHome/20260211/145112_34VcxiCJxx3oTRsYlk?q=80&s=1280x180&t=outside&f=webp) ### ※ 적용할 채널 선택하기 - 채널을 검색해서 원하는 채널을 선택합니다. - 적용하기 버튼을 눌러 선택한 채널의 - 에이전트를 관리합니다. ### ※ 에이전트 만들기 - 선택된 채널에 에이전트를 생성합니다. --- ### 에이전트 만들기 버튼을 클릭하면 아래 화면이 나타납니다 ![Image](https://upload.cafenono.com/image/slashpageHome/20260211/150137_8vlImt3TSl0VRXoCgG?q=80&s=1280x180&t=outside&f=webp) ### 주요 기능 설명 - **에이전트 이름** : 에이전트의 이름을 변경할 수 있습니다. - **에이전트 노드** : 노드를 이어서 원하는 기능을 만들 수 있습니다. - **에이전트 노드 추가** : 새로운 노드를 추가할 수 있습니다. - **테스트** : 만들어진 에이전트를 적용하기 전에 테스트할 수 있습니다. - **저장하기** : 수정한 내용을 저장할 수 있습니다. - **노드 정렬** : 보기 불편하게 배치된 노드를 정렬할 수 있습니다. - **화면 정렬** : 모든 노드가 들어오게 화면 크기를 조절합니다. - **화면 확대 / 축소** : 화면을 확대하거나 축소할 수 있습니다. - **이전 / 다음 작업** : 이전 작업으로 돌아가거나 다음 작업으로 돌아갈 수 있습니다. - **가져오기 / 내보내기** : 곧 새로운 기능으로 찾아올 예정입니다. coming soon !! > 💡 _Veluga Agent Tips_ > **이전 / 다음 작업** 기능은 Ctrl + Z와 같은 기능이에요. > 이외에도 벨루가 에이전트는 다양한 기능이 있어요! > 다양한 기능들을 직접 써보면서 알아가 봐요! --- ## Chapter 2. 에이전트 만들기 ### 에이전트 빌더? 노드? 에이전트 빌더의 하나하나 박스들을 노드(Node)라고 부릅니다. 에이전트 빌더는 원하는 노드들을 이어서 내가 원하는 동작 흐름을 구성할 수 있는 기능입니다. 벨루가의 많은 노드 중 많이 쓰이는 노드들을 먼저 소개하겠습니다. [https://slashpage.com/velugadoc/91kwev268x1r12y46jpg](https://slashpage.com/velugadoc/91kwev268x1r12y46jpg) --- ### 기본 연결 모든 노드들은 서로 연결할 수 있습니다. 연결된 노드들만이 서로 연결되어 동작합니다. 노드의 연결 방법은 노드의 끝점과 다음 노드 시작점을 이어주면 됩니다. 서로 연결된 노드 사이에는 선으로 연결되어 있습니다. [Video](https://vz-127031db-d43.b-cdn.net/2b4861fc-246f-4cf4-9a02-631511d55636/playlist.m3u8) 서로 연결된 노드 사이에는 선으로 연결되어 있어요. > 💡 _Veluga Agent Tips_ > 만약 잘못 연결해서 취소하고 싶으면 선을 더블 클릭하면 돼요. --- ### 테스트 테스트를 위해 AI 노드 등으로 결과를 출력할 수 있습니다. ![Image](https://upload.cafenono.com/image/slashpageHome/20260211/151638_tydSqUqSf4rWNo2wNy?q=80&s=1280x180&t=outside&f=webp) 간단하게 테스트를 진행해 보겠습니다. 테스트를 위해 **텍스트 노드**는 다음과 같이 설정했습니다. ![Image](https://upload.cafenono.com/image/slashpageHome/20260211/151935_P4zuXLhB2ogKB0zZEA?q=80&s=1280x180&t=outside&f=webp) --- 테스트를 위해 **AI 노드**의 시스템 프롬프트는 다음과 같이 작성했습니다. ![Image](https://upload.cafenono.com/image/slashpageHome/20260211/151738_Pr2Ca2vbbqFkgLm4Sq?q=80&s=1280x180&t=outside&f=webp) ![Image](https://upload.cafenono.com/image/slashpageHome/20260211/151817_rvFl8duHTp1HyNiCMb?q=80&s=1280x180&t=outside&f=webp) 위와 같이 설정하고, 우측에서 테스트가 가능합니다. --- ### 실행하기 실행 중일 때는 노드들이 강조되며 에이전트가 어떤 흐름으로 동작하는지 확인할 수 있습니다. [Video](https://vz-127031db-d43.b-cdn.net/419be9d3-ac07-4e63-874d-3b8904f57ea3/playlist.m3u8) 만약 값을 잘못 입력하거나 에러가 난 노드들은 경고를 표시합니다. ![Image](https://upload.cafenono.com/image/slashpageHome/20260212/104724_8zjt8lxpaxEdbNsrxE?q=80&s=1280x180&t=outside&f=webp) > 💡 _Veluga Agent Tips_ > 미리 어떤 에이전트를 만들 건지 충분히 고민하고, 만들기 시작하면 에러를 최소화할 수 있어요. --- ## Chapter 3. 변수 사용하기 ### 변수 벨루가 에이전트 빌더는 변수를 활용할 수 있습니다. 하지만 변수를 안전하게 사용하기 위해서 몇 가지 규칙이 있습니다. ### 노드 출력 변수명 작성 규칙 1. 시스템 변수는 사용할 수 없습니다. 1. e.g., {channel_id} 등 2. 언더스코어(_)를 제외한 특수문자는 사용할 수 없습니다. 3. 공백은 변수명으로 사용할 수 없습니다. 4. 숫자로 시작할 수 없습니다. 4. e.g., 123veluga, 012345 등 사용 불가 5. 영문, 숫자, 언더스코어(_) 조합만 사용 가능합니다. ### 변수 사용 방법 1. {변수명} : 기본적으로 변수는 모두 중괄호로 묶어서 사용합니다. 2. AI 출력 변수명['특정 키'] : AI 노드에서 json 출력 시, 특정 값으로 조건분기를 사용할 때의 사용법입니다. > 💡 _Veluga Agent Tips_ > 변수의 값이 숫자인지 "문자"인지 잘 확인해 보세요. > Tab 키를 누르면 자동완성이 가능해요. --- ## Chapter 4. 저장하기 및 에이전트 사용하기 ### 저장하기 에이전트 작업이 끝난 후, 우측 상단 저장하기 버튼을 통해 에이전트를 저장할 수 있습니다. ### 다른 이름으로 저장하기 / 삭제하기 에이전트 작업이 끝난 후, 우측 상단 저장하기 버튼 좌측의 ⁝ 버튼을 눌러 다른 이름으로 저장 하거나 삭제할 수 있습니다. ![Image](https://upload.cafenono.com/image/slashpageHome/20260212/104824_WjOMyGH1HURicgFYWi?q=80&s=1280x180&t=outside&f=webp) 1개 이상의 에이전트가 생성된 경우, 에이전트 빌더 페이지에 카드형으로 나타나게 됩니다. ![Image](https://upload.cafenono.com/image/slashpageHome/20260212/103713_TrS1BTr2dqUuOBcUPQ?q=80&s=1280x180&t=outside&f=webp) 해당 카드에서의 기능은 다음과 같습니다. - **활성화 상태** : 에이전트의 **활성화 상태**를 나타냅니다. - **활성화 토글** : 토글을 클릭해 에이전트의 **활성화** / **비활성화** 상태를 전환할 수 있습니다. - **노드 수정하기** : 노드를 수정할 수 있는 에이전트 빌더로 이동됩니다. - **삭제하기** : 에이전트를 삭제할 수 있습니다. - **마지막 수정일자** : 에이전트의 마지막 수정 일자를 나타냅니다. --- ### 에이전트 적용 / 사용하기 에이전트를 사용하기 위해서는 반드시 에이전트를 활성화해야 합니다. 에이전트가 활성화되면, 채널에 바로 적용됩니다. 채팅하기 기능으로 바로 사용할 수 있습니다. 만약 에이전트 적용이 안 된다면 페이지 새로 고침 혹은 채팅창을 새로 열어보세요. > 💡 _Veluga Agent Tips_ > 에이전트는 1개만 활성화할 수 있어요. > 만약 에이전트 실행이 안 된다면 [contact@veluga.io](mailto:contact@veluga.io)로 문의해 주세요. --- ## ⚠️ 에이전트 주의 사항 ### 에이전트 설계 기본적으로 적용되어 있는 에이전트도 우수하기에 커스텀 과정은 충분한 설계를 가지고 진행하는 것을 추천드립니다. 특히 프롬프트를 짜는 방법에 따라서 결과값이 천차만별입니다. 아래 블로그를 참고하시면 더욱 좋은 결과물을 얻을 수 있습니다. Staff_Veluga프롬프트 작성법 | 벨루가 - velugadoc 변수와 함수를 잘못 사용하면 에이전트가 오작동을 일으킵니다. 항상 함수를 사용할 때 변수값을 잘 확인하고 사용해야 합니다. ### 저장하기 에이전트는 노드가 많아질수록 내용이 복잡해집니다. 저장을 주기적으로 하면 작업 내용이 사라지는 불상사가 없을 것입니다. ### 개선하기 벨루가는 언제나 여러분의 의견을 존중합니다. 더 좋은 아이디어가 있으면 문의 남겨 주시면 내부 논의 후 적용하도록 하겠습니다. --- © Veluga Inc. All Rights Reserved. For the site tree, see the [root Markdown](https://slashpage.com/velugadoc.md).