3단계로 시작하는 핵심 가이드

3단계로 시작하는 핵심 가이드는 에이전트리아(Agentria)를 가장 빠르고 간단하게 이해할 수 있는 참고서입니다.

복잡한 설정이나 자세한 개념 설명은 생략하고 핵심만 짧고 간결하게 안내해, 첫 워크플로(Workflow)를 빠르게 만들어볼 수 있도록 구성했습니다. 아래 3단계를 따라 하면 워크플로 생성부터 기본적인 노드 연동, 전체적인 작업 흐름까지 자연스럽게 익힐 수 있고, 이후 심화 학습의 기초로도 활용할 수 있습니다.

개발이 처음이거나 더 자세한 설명과 단계별 예제로 깊이 있게 배우고 싶다면, 🔗노드 사용법 페이지에서 난이도에 맞는 튜토리얼을 참고하세요.

1단계: 프로젝트 생성 및 컴포저 선택

먼저 에이전트리아 회원가입과 로그인을 진행합니다.

에이전트리아에 처음 방문하면 샘플 프로젝트인 Welcome to Agentria!가 준비되어 있습니다. 이 프로젝트 안에는 어빌리티(Ability)와 에이전트(Agent) 워크플로를 직접 실행해볼 수 있는 샘플이 들어 있습니다.

새 프로젝트를 만들려면 화면 우측 상단의 +프로젝트 생성(Create Project) 버튼을 클릭하고, 이름과 설명을 입력한 뒤 저장(Save) 버튼을 클릭합니다.

다음으로 프로젝트 안에서 컴포저(Composer)를 선택합니다. 컴포저는 워크플로의 성격과 목적을 정하는 단계로, 다음 두 가지 중에서 선택할 수 있습니다.

• 어빌리티(Ability): 특정 기능이나 작업을 신속하고 정확하게 수행하는 데 초점을 맞춘 워크플로입니다. 번역, 요약, 데이터 처리 등 단일 기능 중심의 업무를 자동화하는 데 유용합니다.

• 에이전트(Agent): 대화 기반으로 작동하며, 메모리 기능으로 맥락을 이해하고 지속적인 상호작용을 지원하는 지능형 워크플로입니다. 고객 응대 챗봇, 상담 지원처럼 장기적인 맥락 관리가 필요한 프로젝트에 적합합니다.

컴포저를 선택했다면 화면 우측 상단의 +어빌리티 생성(Create Ability) 또는 +에이전트 생성(Create Agent) 버튼을 클릭해 어빌리티 또는 에이전트를 생성합니다. 이제 캔버스(Canvas)로 진입해 본격적으로 워크플로를 구성할 수 있습니다.

2단계: 노드 구성하기

에이전트리아의 워크플로는 핵심 요소인 🔗노드(Node)로 이루어져 있습니다. 노드는 각각의 기능을 수행하는 단위이며, 여러 노드를 조합해 하나의 완성된 흐름을 만들어갑니다.

캔버스에는 기본적으로 스타트 노드(Start Node)와 엔드 노드(End Node)가 배치되어 있습니다. 스타트 노드는 전체 흐름을 시작하고, 엔드 노드는 전체 흐름을 종료합니다.

필요한 기능을 구현하려면 캔버스 하단의 +노드 추가(Add Node) 버튼으로 새 노드를 불러옵니다. 노드는 드래그 앤 드롭(Drag and drop)으로 캔버스 위에 자유롭게 배치하고 언제든 위치를 조정할 수 있습니다.

노드를 올바르게 이해하고 연결하는 것이 워크플로의 품질과 효율성을 좌우하므로, 각 노드가 어떤 역할을 하고 다른 노드와 어떻게 상호작용하는지 명확히 파악하는 것이 중요합니다.

노드를 더블 클릭하면 노드 편집기(Node Editor)가 열리며, 이곳에서 입출력 변수를 정의하거나 직접 코드·프롬프트를 작성할 수 있습니다.

다만 일부 노드는 곧바로 사용할 수 없고 사전 준비가 필요합니다.

• 데이터 스토리지(Data Storage) 관련 노드는 데이터 스토리지를 먼저 생성한 뒤 사용할 수 있습니다.

• 외부 API·서비스와 연동되는 노드는 해당 서비스에서 발급받은 토큰(Token)으로 🔗크리덴셜(Credential)을 먼저 등록해야 사용할 수 있습니다.

노드와 노드를 연결해 데이터가 이동하는 경로를 만드는 요소를 엣지(Edge)라고 합니다. 엣지는 단순한 선이 아니라, 워크플로 안에서 데이터가 어떤 순서와 방식으로 전달되는지를 정의하는 통로입니다.

워크플로를 설계할 때는 항상 시작 노드에서 중간 노드들을 거쳐 종료 노드로 이어지도록 구성하며, 이 흐름이 올바르게 연결되려면 각 노드를 엣지로 이어주는 작업이 필수입니다.

엣지를 활용하면 순차적인 노드 연결뿐 아니라 분기 처리, 조건부 흐름, 병렬 실행 등 다양한 데이터 흐름을 구현할 수 있어, 워크플로의 복잡성과 목적에 맞게 설계하는 과정이 필요합니다.

3단계: 테스트 및 개선

워크플로 구성을 마쳤다면 테스트로 동작을 검증합니다.

화면 우측 하단의 테스트 실행(RUN TEST) 버튼을 클릭하면 워크플로가 전체 실행되며, 노드 간 연결과 데이터 흐름이 정상 동작하는지 즉시 확인할 수 있습니다. 테스트 결과는 성공·실패 메시지와 최종 출력 결과로 확인합니다.

예상과 다른 결과가 나오거나 오류가 발생하면, 노드의 변수 설정·명령·연결 상태를 확인하고 수정한 뒤 다시 테스트를 실행하며 개선합니다.

에이전트리아는 컴포저에 따라 테스트 방식이 다릅니다.

어빌리티 테스트

• 어빌리티 테스트(Ability Test): 순차 실행 방식으로 각 노드의 입력과 출력을 단계별로 확인할 수 있어, 기능 단위의 검증과 디버깅(Debugging)에 유용합니다. 테스트를 실행하면 캔버스 위에서 실행 흐름이 시각적으로 표시되어, 워크플로가 올바르게 동작하는지 직관적으로 확인할 수 있습니다.

에이전트 테스트

• 에이전트 테스트(Agent Test): 대화형 테스트 환경에서 실제 대화 시나리오와 유사한 챗봇 방식으로 결과를 검증합니다. 메모리와 맥락 관리 기능까지 포함해 에이전트의 응답 품질을 평가할 수 있습니다.

다음 단계

에이전트리아에서는 단 3단계만으로 아이디어를 현실로 만들 수 있습니다. 복잡한 설정 없이도 프로젝트를 시작할 수 있고, 직관적인 인터페이스로 누구나 쉽고 빠르게 워크플로를 구현할 수 있습니다.

더 깊이 배우고 싶다면 난이도별 튜토리얼과 함께 직접 워크플로를 만들어보세요.

• 🔗노드 사용법 — 노드별 상세 사용법과 단계별 튜토리얼을 확인하세요.

자주 묻는 질문

퀵스타트를 마치는 데 얼마나 걸리나요?

개인차가 있지만, 회원가입부터 첫 워크플로 테스트까지 보통 몇 분이면 충분합니다. 복잡한 설정이나 개념 학습 없이 핵심 흐름만 빠르게 경험하도록 구성되어 있습니다.

어빌리티와 에이전트 중 어떤 걸 먼저 만들어봐야 하나요?

정해진 작업을 빠르고 정확하게 자동화하고 싶다면 어빌리티(Ability)를, 대화 기반으로 맥락을 유지하며 상호작용하는 워크플로가 필요하다면 에이전트(Agent)를 선택하면 됩니다. 두 컴포저 모두 같은 방식으로 노드를 편집하므로, 목적에 맞는 쪽으로 시작해도 무방합니다.

노드 연결에 실패하거나 오류가 나면 어떻게 하나요?

테스트 실행(RUN TEST)으로 확인한 오류 메시지를 바탕으로 문제가 발생한 노드의 변수 설정·명령·연결 상태를 점검하고 수정한 뒤 다시 테스트를 실행합니다. 데이터 스토리지나 외부 서비스 연동 노드는 사전에 스토리지 생성이나 크리덴셜(Credential) 등록이 되어 있는지도 함께 확인합니다.

퀵스타트 이후에는 무엇을 하면 되나요?

난이도별로 제공되는 노드 사용법 튜토리얼을 참고해, 실제 업무에 필요한 워크플로를 직접 만들어보는 것을 추천합니다.