Development Guide
Agentria에서 어빌리티는 특정 기능을 수행하도록 설계된 하나의 완성된 워크플로우입니다.
이 페이지에서는 프로젝트 생성부터 노드 배치, 로직 구현, 테스트까지 어빌리티를 만드는 과정을 단계별로 안내합니다.
1단계: 프로젝트 생성
메인 페이지 우측 상단의 Create Project
버튼을 눌러 새 프로젝트를 만듭니다.

필드 좌측 핀 버튼을 눌러 상단에 고정하면 빠르게 접근할 수 있습니다.

2단계: 어빌리티 선택
프로젝트 내부 사이드바에서 Ability 또는 Agent 중 하나를 선택할 수 있습니다.
이번 가이드에서는 Ability를 선택합니다.

3단계: 어빌리티 추가
프로젝트 내부에서 우측 상단 Create
버튼을 눌러 어빌리티를 생성합니다.

4단계: 캔버스 진입
생성된 어빌리티를 클릭하면 캔버스 에디터로 이동합니다.
캔버스는 워크플로우를 설계하는 공간입니다.
5단계: 기본 노드 확인
기본적으로 INPUT 노드와 OUTPUT 노드가 하나씩 배치되어 있습니다.
이 노드들은 워크플로우의 시작점과 끝점을 정의합니다.

필요 시 임의의 노드를 INPUT / OUTPUT 노드로 설정할 수 있으며, 설정된 노드는 삭제할 수 없습니다.

6단계: 노드 추가
캔버스 하단 메뉴에서 Add node
버튼을 눌러 사이드바를 열 수 있습니다.

필요한 노드를 드래그 앤 드롭으로 캔버스에 배치합니다.
(참고: 노드의 종류는 [노드 레퍼런스]를 확인하세요.)

7단계: 노드 구성
노드를 더블 클릭하면 편집 모달이 열립니다.
입력 노드에서 기능 구현에 필요한 Input 요소를 필요한 만큼 추가하세요.

8단계: 로직 구현
엣지를 끌어당겨 다음 단계가 될 노드와 연결하세요.

연결된 노드를 더블 클릭하면 Input 노드로부터 변수가 연동된 것을 확인할 수 있습니다.

코드작성 방법
개발자라면, 코드 필드에 직접 코드를 작성할 수 있습니다.

프로그래밍을 몰라도 괜찮습니다. ✨ Code Generator
로 손쉽게 코드를 생성할 수 있습니다.

Input 요소를 코드 필드로 끌어다 놓으면(드래그 앤 드롭) 코드에서 바로 활용할 수 있습니다.

만약 조건 분기가 필요하다면 함수를 추가해 사용하세요.

함수를 추가하면 노드에 함수용 엣지가 생성됩니다.
새로운 노드와 연결해 활용하면 워크플로우의 성능 향상에 도움이 됩니다.

9단계: LLM 노드 활용
LLM 노드를 추가하면 복잡한 작업이나 AI 기반 처리를 수행할 수 있습니다.
(참고: 노드의 종류는 [노드 레퍼런스]를 확인하세요.)

LLM 노드는 프롬프트를 활용해 모델이 어떤 방식으로 작업을 처리할지 세밀하게 제어할 수 있습니다.

10단계: 어빌리티 테스트
각 노드에서 개별 테스트를 실행할 수 있으며, INPUT부터 OUTPUT까지 연결된 하나의 워크플로우는 RUN TEST
버튼으로 실행할 수 있습니다.
오류가 발생하면 오류 메시지를 통해 원인을 확인하고 수정 후 다시 테스트할 수 있습니다.
