노드 사용법 익히기 - 대기(Wait) 노드

이 튜토리얼에서는 에이전트리아(Agentria) 의 대기(Wait) 노드 사용법을 안내합니다. 대기 노드는 워크플로 실행 중 지정한 시간(초) 동안 실행을 일시 중단하는 노드입니다. 노드 편집기(Node Editor)에서 지연 시간을 초 단위 정수로 설정하면, 워크플로가 해당 노드에 도달할 때 설정한 시간만큼 대기한 뒤 다음 노드로 진행합니다.

대기 노드는 다음과 같은 상황에서 활용할 수 있습니다.

• API를 호출한 뒤 일정 시간 대기하고 결과를 확인할 때

• 외부 시스템의 처리가 완료될 때까지 잠시 대기해야 할 때

• 연속된 요청 사이에 간격을 두어 과부하를 방지할 때

이 튜토리얼에서는 파이썬 노드로 실행 시각을 기록하고, 대기 노드로 10초를 지연한 뒤 다시 실행 시각을 기록하는 '지연 실행 확인' 워크플로를 완성합니다. 두 결과값의 시간 차이를 통해 대기 노드의 동작을 직접 확인할 수 있습니다.

사전 준비

에이전트리아 캔버스 진입 방법은 🔗3단계 핵심 가이드를 참고하시기 바랍니다.

이 튜토리얼을 완료하면 다음을 수행할 수 있습니다.

1. 대기 노드의 지연 시간을 설정하여 워크플로 실행을 일시 중단할 수 있습니다.

2. AI 코드 생성기를 활용하여 파이썬 노드에서 목적에 맞는 코드를 생성할 수 있습니다.

3. 종료 노드에서 여러 아웃풋 변수를 선언하고 바인딩할 수 있습니다.

워크플로 개요

이 튜토리얼의 핵심은 대기 노드입니다.

파이썬 노드 1에서 현재 실행 시각을 기록하고, 대기 노드가 10초 동안 실행을 중단합니다. 이후 파이썬 노드 2에서 다시 실행 시각을 기록합니다. 두 결과값의 시간 차이를 통해 대기 노드가 실제로 실행을 지연시키는 것을 확인합니다.

1단계: 어빌리티 생성

에이전트리아 캔버스에서 새 어빌리티(Ability)를 생성합니다.

2단계: 워크플로 배치 및 연결

캔버스에 아래 노드를 추가하고 이미지와 같이 배치합니다.

• 파이썬(Python) 노드 2개: +노드 추가(Add Node) → 코드 노드 카테고리에서 추가합니다.

• 대기(Wait) 노드 1개: +노드 추가(Add Node) → 흐름 제어 노드 카테고리에서 추가합니다.

배치가 완료되면 아래 순서로 엣지(Edge)를 연결합니다.

1. 시작 노드의 아웃핀(Out-Pin) → 파이썬 노드 1의 인핀(In-Pin)

2. 파이썬 노드 1의 아웃핀 → 대기 노드의 인핀

3. 대기 노드의 아웃핀 → 파이썬 노드 2의 인핀

4. 파이썬 노드 2의 아웃핀 → 종료 노드의 인핀

3단계: 파이썬 노드 1 — AI 코드 생성기 진입

파이썬 노드 1을 더블 클릭하여 노드 편집기(Node Editor)를 엽니다.

편집 영역(Edit Section) 상단의 아이콘을 클릭하면 AI 코드 생성기(Code Generator)를 사용할 수 있습니다. 코드를 직접 입력하거나 AI 코드 생성기로 자동 생성할 수 있습니다.

4단계: 파이썬 노드 1 — 코드 생성 및 적용

AI 코드 생성기 입력란에 원하는 동작을 프롬프트로 입력한 뒤 생성(Generate)을 클릭합니다.

이 튜토리얼에서는 현재 실행 시각을 문자열로 반환하는 코드를 생성합니다.

from datetime import datetime
result = datetime.now().strftime("%H:%M:%S")

from datetime import datetime
result = datetime.now().strftime("%H:%M:%S")

from datetime import datetime
result = datetime.now().strftime("%H:%M:%S")

코드가 생성되면 적용 버튼을 클릭하여 노드에 반영합니다.

아웃풋 영역(Output Section)에 출력 변수가 자동으로 추가됩니다. 추가되지 않은 경우 result(String) 변수를 직접 추가합니다.

5단계: 대기 노드 설정

대기 노드를 더블 클릭하여 노드 편집기를 엽니다.

대기 노드는 아래 항목을 제공합니다.

지연 시간 입력란에 10을 입력합니다. 대기 노드에는 별도의 아웃풋이 없으며, 설정한 시간이 경과하면 자동으로 다음 노드로 진행합니다.

6단계: 파이썬 노드 2 설정

파이썬 노드 2를 더블 클릭하여 노드 편집기를 엽니다.

3~4단계와 동일한 방법으로 코드를 작성합니다. 파이썬 노드 1과 동일하게 현재 실행 시각을 반환하는 코드를 입력합니다.

from datetime import datetime
result = datetime.now().strftime("%H:%M:%S")

from datetime import datetime
result = datetime.now().strftime("%H:%M:%S")

from datetime import datetime
result = datetime.now().strftime("%H:%M:%S")

적용 버튼을 클릭하여 노드에 반영하고, 아웃풋 영역에 result(String) 변수가 있는지 확인합니다.

7단계: 시작 노드 확인

이 튜토리얼에서는 입력값이 필요하지 않으므로 시작 노드에 별도의 인풋(Input) 변수를 선언하지 않습니다. 시작 노드는 기본 상태 그대로 유지합니다.

8단계: 종료 노드 설정

종료 노드를 더블 클릭하여 노드 편집기를 엽니다.

아웃풋 영역(Output Section)에 아래 변수를 추가합니다.

파이썬 노드 1의 아웃풋 값을 드래그 앤 드롭으로 time1에, 파이썬 노드 2의 아웃풋 값을 time2에 바인딩합니다.

9단계: 어빌리티 테스트 실행

캔버스 오른쪽 하단의 테스트 실행 버튼을 클릭합니다. 테스트 실행 → 테스트 실행 → 실행 순서로 진행하면 전체 런테스트가 실행됩니다.

이 튜토리얼에서는 입력값이 없으므로 별도의 인풋 입력 없이 바로 실행됩니다.

파이썬 노드 1에서 실행 시각을 기록하고, 대기 노드가 10초 동안 대기한 뒤, 파이썬 노드 2에서 다시 실행 시각을 기록합니다. 지연 시간을 10초로 설정했으므로 time1과 time2의 시간 차이가 10초인 것을 확인합니다.

10단계: 실행 결과 확인

테스트 실행창의 실행 모니터에서 각 노드의 실행 결과를 단계별로 확인할 수 있습니다.

다음 단계

🎉 축하합니다! 에이전트리아를 사용해 '지연 실행 확인' 워크플로를 완성했습니다.

지연 시간을 조정하거나 다양한 노드와 조합하면 아래와 같은 워크플로를 구성할 수 있습니다.

• API를 호출한 뒤 일정 시간 대기하고 결과를 확인하는 워크플로

• 외부 시스템의 처리 완료를 기다리는 워크플로

• 연속된 요청 사이에 간격을 두어 과부하를 방지하는 워크플로

에이전트리아는 아이디어를 현실로 바꾸는 가능성의 공간입니다.

당신의 상상력으로 워크플로는 무한히 확장될 수 있습니다.

• 더 많은 어빌리티 예제가 궁금하다면 🔗어빌리티 가이드 페이지를 확인하세요.

• 에이전트 예제를 원한다면 🔗에이전트 가이드 페이지를 확인하세요.