Development Guide

노드 다루기

노드 다루기

노드 다루기

Agentria의 모든 워크플로우는 노드로부터 시작됩니다.


노드는 사용자 입력값을 기반으로 특정 기능을 수행하고, 결과를 출력하는 기본 실행 단위입니다.


따라서 어벌리티와 에이전트를 개발하고 활용하기 위해서는 노드 다루는 법을 이해하는 것이 필수적입니다.


이 페이지를 통해 사용자는 노드를 추가하고 → 구성하고 → 연결하고 → 테스트하는 전체 흐름을 익힐 수 있습니다.


Agentria는 드래그 앤 드롭 기반의 직관적인 인터페이스를 제공하여, 초보자도 손쉽게 노드를 추가하고 연결할 수 있습니다.


노드 추가하기


캔버스 하단의 Add Node 버튼을 클릭하면 사이드바가 열립니다.



사이드바에서 원하는 노드를 선택합니다.

  • 예시: Python, LLM, PDF Text Reader, Tools 등


선택한 노드를 드래그 앤 드롭으로 캔버스 내 원하는 위치에 배치합니다.


노드 구성하기


워크플로우 전체에는 반드시 INPUT 노드 1개와 OUTPUT 노드 1개가 정의되어야 합니다.

  • INPUT: 사용자 데이터를 받아오는 시작점

  • OUTPUT: 최종 결과를 내보내는 끝점



노드를 더블클릭하면 각 노드의 입력값·출력값 변수나 코드를 편집할 수 있습니다.


<>코드 필드에서 직접 코드를 작성해 원하는 로직을 구현할 수 있습니다.



조건 분기를 통해 워크플로우를 확장하려면 Function을 활용하세요.

프로그래밍에 익숙하지 않아도 괜찮습니다.

  • Agentria는 ✨ Code Generator 기능으로 코드 생성을 지원합니다.



각 노드 내 TEST 버튼을 사용해 실행을 검증할 수 있으며, 문제가 있을 경우 즉시 수정 후 다시 테스트할 수 있습니다.


노드 연결하기


캔버스에 배치된 노드들은 엣지로 연결할 수 있습니다.

  • 시작점을 클릭한 뒤 끌어다 놓는 방식(드래그 앤 드롭)으로 직관적인 연결이 가능합니다.



연결을 통해 노드 간 데이터 흐름이 형성되며, 워크플로우 전체가 완성됩니다.


모든 연결은 INPUT → 중간 노드들 → OUTPUT 순으로 이어져야 정상적으로 작동합니다.


테스트하기


워크플로우 구성이 완료되면, 캔버스 우측하단의 RUN TEST 를 실행할 수 있습니다.


INPUT 노드에 데이터를 넣으면, 연결된 노드를 따라 OUTPUT 노드까지 결과가 전달됩니다.


테스트 결과를 통해 노드 간 데이터 전달 여부, 코드·프롬프트 실행 결과를 확인할 수 있습니다.



문제가 있으면 노드를 수정하고 다시 테스트하여, 점진적으로 워크플로우를 개선할 수 있습니다.