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

본 튜토리얼에서는 Gmail 노드를 활성화하고, Google 계정을 연동하여 메일을 전송하는 어빌리티를 직접 만들고 실행합니다.

사전 준비

시작을 위해, Agentria에서 프로젝트를 생성한 후, 어빌리티 에디터 캔버스로 진입합니다.

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

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

1. 노드 추가하기

2. Start 노드에서 변수 선언하기

3. 노드 연결하기

4. Gmail 크리덴셜 등록하기

5. Google 계정 연동하기

6. Gmail 노드에서 크리덴셜 설정하기

7. Gmail 노드로 메일 세팅하기

8. Run Test를 통해 워크플로우 실행 결과 확인하기

1단계: 구글 OAuth 생성하기

Gmail 노드를 사용하기 위해서는 Google에서 제공하는 인증키를 기반으로 크리덴셜을 설정해야 합니다.

구글의 액세스 토큰은 OAuth 플로우를 거쳐야 발급할 수 있습니다.

Google OAuth 생성이 처음이라면 구글 크리덴셜 사용 가이드를 참고하세요.

2단계: Gmail 크리덴셜 등록하기

크리덴셜은 시스템이나 서비스에 접근하기 위해 사용자를 인증하는 데 필요한 자격 증명 정보입니다.

본 튜토리얼 진행을 위해 크리덴셜 등록 시 템플릿을 Google Gmail로 설정합니다.

구글 크리덴셜 사용 가이드를 따라 진행하며 Gmail 크리덴셜을 등록했다면 2단계로 넘어갑니다.

3단계: Gmail 노드 추가하기

캔버스 하단의 +Add Node 버튼을 클릭하고 사이드바 Tools 카테고리에서 Gmail 노드를 선택해 드래그 앤 드롭 방식으로 배치합니다.

노드 위에 마우스를 올려 편집 아이콘을 눌러 옵션 창을 띄웁니다.

노드의 이름을 Send Gmail Node로 수정합니다.

Gmail 노드는 Send, Get, List, Delete 등을 선택할 수 있기 때문에 운영 설정에 따라 노드 명을 수정해서 사용하는 것이 좋습니다.

4단계: Input 변수 선언하기

Agentria 캔버스에는 기본적으로 Start 노드와 End 노드가 하나씩 배치되어 있습니다.

• Start 노드는 전체 흐름을 시작합니다.

• End 노드는 전체 흐름을 종료합니다.

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

본 튜토리얼에서는 메일을 전송해야 하므로, 자료형을 String으로 두고 변수명을 다음과 같이 설정합니다.

• To

• Subject

• MessageBody

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

5단계: 엣지로 노드 연결하기

Start 노드에서 입력받은 변수를 Gmail 노드에서 사용하기 위해서는 엣지를 사용해 두 노드를 연결해야 합니다.

Start 노드의 오른쪽 엣지 커넥터(Out-Connector)를 Python 노드의 왼쪽 엣지 커넥터(In-Connector)와 연결합니다.

이렇게 하면 Start 노드의 입력값이 Gmail 노드로 전달됩니다.

6단계: Gmail 노드 설정하기

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

노드를 사용하기 위해 등록해 둔 Gmail 크리덴셜을 선택해 불러옵니다.

Gmail 노드는 Operation 설정을 통해 메일을 어떤 방식으로 사용할지 선택할 수 있습니다.

본 튜토리얼은 메일 전송하기를 목표로 하므로, Send Message를 선택합니다.

메일을 전송하기 위해 Start 노드에서 받는 이(To), 제목(Subject), 메시지 내용(MessageBody)을 변수로 선언했습니다.

입력값을 받아서 사용하기 위해 어댑터 변수를 선택해야 합니다.

Show Optional Variables 버튼을 클릭하고 +Add Optional Variables 를 클릭하면 메일에 사용할 수 있는 다양한 옵션을 확인할 수 있습니다.

to, subject, message_body를 선택합니다.

Gmail 노드는 기본적으로 JSON 형식의 Output을 반환합니다.

7단계: 드래그 앤 드롭으로 변수 바인딩하기

Agentria에서는 별도의 코드를 작성하지 않고, 드래그 앤 드롭 방식으로 변수를 손쉽게 불러올 수 있습니다.

Input 영역에 있는 변수와 어댑터 변수를 이름에 맞게 연결합니다.

to: To

subject: Subject

message_body: MessageBody

8단계: 노드 테스트 실행하기

설정을 완료한 후, 편집기 내 Input 영역의 TEST 버튼을 눌러 노드 점검을 진행할 수 있습니다.

노드 테스트란 노드 편집기에서 개별적으로 진행할 수 있는 점검 작업입니다.

이를 통해 노드가 올바르게 구성되어 있음을 확인하고 다른 노드와 연결하면 오류를 최소화하고 흐름을 안정적으로 이어 나갈 수 있습니다.

입력창에 받는 이(메일 주소), 제목, 메시지 내용을 입력한 뒤 Test를 실행하면, result 결과에 전송 정보가 표시됩니다.

브라우저로 Gmail에 접속하여 보낸 메일함을 확인하거나 받는 이의 메일함을 확인하면 메일이 정상적으로 전송되었음을 알 수 있습니다.

9단계: End 노드 연결하기

Mail 전송 결괏값을 End 노드로 전달합니다.

다시 캔버스로 돌아와서 Gmail 노드와 End 노드를 엣지로 연결합니다.

End 노드를 더블클릭하여 노드 편집기를 열고, JSON 타입의 Mail 변수를 추가합니다.

Gmail 노드에서 결괏값을 담은 result 변수를 선택 또는 드래그 앤 드롭 방식으로 Mail 변수와 연결합니다.

이로써 ‘Gmail 전송’ 워크플로우가 완성되었습니다.

10단계: Run Test로 워크플로우 전체 실행하기

캔버스 우측 하단에서 Run Test 버튼을 클릭하여 완성된 전체 워크플로우를 실행할 수 있습니다.

입력창에 맞게 받는 이(메일 주소), 제목, 메시지 내용을 입력한 뒤 Run Test를 실행하면, Mail 결과에 전송 정보가 표시됩니다.

브라우저로 Gmail에 접속하여 보낸 메일함을 확인하거나 받는 이의 메일함을 확인하면 메일이 정상적으로 전송되었음을 알 수 있습니다.

다음 단계

🎉 축하합니다! 세 번째 Agentria 워크플로우인 ‘Gmail 전송’을 완성했습니다.

이제 다양한 운영 설정을 적용해 결과를 확인해 보고, 운영 변수를 추가하며 워크플로우를 확장해 보세요.

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

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

더 많은 입문 예제가 궁금하다면 입문 가이드 페이지를 확인하세요.