Get Started

코드 노드 사용하기 (Python)

Name: Agentria
Brand: Agentria

입문 가이드의 튜토리얼은 에이전트리아(Agentria) 입문자를 위한 가장 기본적이면서도 핵심적인 과정을 다룹니다.

본 튜토리얼에서는 기상 시간을 입력하고, 파이썬(Python) 노드를 활용해 권장 수면 시간을 역산하여 취침 시간을 계산하는 어빌리티(Ability)를 직접 만들고 실행합니다.

사전 준비

시작을 위해, 에이전트리아에서 프로젝트(Project)를 생성한 후, 어빌리티 캔버스(Canvas)로 진입합니다.

캔버스 진입 절차는 3단계 핵심 가이드의 1단계(프로젝트 생성 및 컴포저 선택)를 참고하시기 바랍니다.

본 튜토리얼을 완료하면 다음과 같은 작업을 수행할 수 있습니다.

노드(Node) 추가하기
스타트 노드(Start Node)에서 변수 선언하기
노드 연결하기
파이썬 노드에서 코드 작성하기
파이썬 노드에서 코드 생성기 사용하기
파이썬 노드 출력값을 엔드 노드(End Node)로 전달하기
어빌리티 테스트를 통해 워크플로(Workflow) 실행 결과 확인하기

1단계: 인풋 변수 선언

에이전트리아 캔버스에는 기본적으로 스타트 노드(Start Node)와 엔드 노드(End Node)가 하나씩 배치되어 있습니다.

이때, 스타트 노드는 전체 흐름을 시작하는 역할을 하고, 엔드 노드는 전체 흐름을 종료하는 역할을 합니다.

따라서 ‘수면시간 계산’ 워크플로를 구성하기 위해서는 먼저 스타트 노드에서 필요한 변수를 선언해야 합니다.

스타트 노드를 더블클릭하면 노드 편집기(Node Editor)가 열리며, 여기에서 자료형과 이름, 설명을 설정할 수 있습니다.

본 튜토리얼에서는 기상 시간을 입력값으로 받아야 하므로, 자료형을 String으로 두고 변수명을 WakeUpTime으로 설정하여 변수를 선언하겠습니다.

변수 선언을 완료했다면 다시 캔버스로 돌아갑니다.

2단계: Python 노드 추가

이제 수면 시간을 계산할 파이썬 노드를 추가할 차례입니다.

캔버스 하단의 +노드 추가(Add Node) 버튼을 클릭하고, 코드(Code) 카테고리에서 파이썬 노드를 드래그 앤 드롭(Drag and Drop)으로 캔버스에 배치합니다.

파이썬 노드는 직접 코드를 작성하거나, 짧은 프롬프트로 자동 코드 생성을 지원하는 코드 생성기(Code Generator) 기능을 사용할 수 있습니다.

3단계: 엣지로 노드 연결

스타트 노드에서 입력받은 WakeUpTime 변수를 파이썬 노드에서 사용하기 위해서는 두 노드를 연결해야 합니다.

이 연결선을 엣지(Edge)라고 부릅니다.

스타트 노드의 오른쪽 아웃 핀(Out-Pin)을 파이썬 노드의 왼쪽 인 핀(In-Pin)과 연결하면, 입력값이 파이썬 노드로 전달됩니다.

4단계: 파이썬 코드 작성

파이썬 노드를 더블 클릭하면 노드 편집기가 열립니다.

인풋(Input) 영역에 WakeUpTime 변수가 표시된다면 두 노드가 정상적으로 연결된 것입니다.

이제 파이썬 코드 입력창에 수면 시간을 계산하는 스크립트를 작성합니다.

예시:

wake_up_time = int()
time_minus_9 = (wake_up_time - 9) % 12
time_minus_7 = (wake_up_time - 7) % 12
time_minus_9 = 12 if time_minus_9 == 0 else time_minus_9
time_minus_7 = 12 if time_minus_7 == 0 else time_minus_7
recommended_sleep_time = f"{time_minus_9}시~{time_minus_7}시"
return {"output": recommended_sleep_time}