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

본 튜토리얼에서는 이름과 생일을 입력하고 간단한 ‘오늘의 운세’를 확인하는 어빌리티를 직접 만들고 실행합니다.

사전 준비

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

캔버스 진입 절차는 3단계 핵심 가이드를 참고하시기 바랍니다.

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

1. 노드 추가하기

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

3. 노드 연결하기

4. LLM 노드에서 프롬프트 작성하기

5. LLM 노드에서 생성한 답변을 Output 노드로 전달하기

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

1단계: Input 변수 선언하기

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

이때, Start 노드는 전체 흐름을 시작하는 역할을 하고, End 노드는 전체 흐름을 종료하는 역할을 합니다.

따라서 ‘오늘의 운세’ 워크플로우를 구성하기 위해서는 먼저 Start 노드에서 필요한 변수를 선언해야 합니다.

Input 노드를 더블클릭하면 노드 편집기가 팝업 형태로 열리며, 이곳에서 자료형과 이름, 설명을 설정하여 변수를 선언할 수 있습니다.

운세를 확인하기 위해 필요한 정보인 ‘이름’과 ‘생일’을 변수로 설정하겠습니다.

첫 번째, 이름 변수는 자료형을 String으로 두고, 변수명을 Name으로 저장합니다.

두 번째, 생일 변수는 자료형을 String으로 두고, 변수명을 BirthDay로 저장합니다.

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

2단계: 드래그 앤 드랍으로 노드 추가하기

이제 운세를 생성할 노드를 추가할 차례입니다.

LLM 노드를 활용하면 간단한 프롬프트 작성만으로 입력값에 기반한 출력값을 생성할 수 있습니다.

캔버스 하단의 +Add Node 버튼을 클릭하여, AI 카테고리에서 LLM 노드를 드래그 앤 드롭 방식으로 배치합니다.

본 튜토리얼에서는 Azure OpenAI LLM을 사용합니다.

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

Input에서 선언한 변수를 LLM 노드에서 사용하기 위해서는 두 노드를 연결해야 합니다.

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

Input 노드 오른쪽의 작은 엣지 커넥터를 LLM 노드의 왼쪽 엣지 커넥터와 연결하면, Input에서 연결한 값이 LLM으로 전달됩니다.

4단계: 시스템 프롬프트 작성하기

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

Input 영역에 Name과 BirthDay가 표시된다면 두 노드가 정상적으로 연결된 것입니다.

LLM 노드에는 크레덴셜 설정, 시스템 프롬프트 작성, 사용자 프롬프트 작성, 성능 및 출력 특성을 조절할 수 있는 세부 설정 영역이 포함되어 있습니다.

시스템 프롬프트 필드에는 AI에게 수행할 역할과 출력 형식을 지시하는 지침 사항을 작성합니다.

AI에게 역할과 출력 규칙을 구체적으로 지시할수록 결과물의 품질이 높아집니다.

예시:

당신은 ‘오늘의 운세 알리미’입니다. 긍정적이고 친절한 어휘를 사용해야 합니다.
이 결과는 재미로만 보는 운세이며 생각보다 더 좋은 일이 기다리고 있을 거라는 마지막 문장을 포함해야 합니다.

<p>형식</p>
<p>오늘의 운세 한 줄 요약<br>오늘의 운세 상세</p>
<p>(금전, 사랑, 건강, 기타)</p>

5단계: 사용자 프롬프트 작성하기

사용자 프롬프트에는 입력값을 건네는 요청을 작성합니다.

즉, Input 노드에서 입력받은 이름과 생일을 AI에게 전달하는 단계입니다.

예시:

이름:<p></p>
<p>생일:</p>
<p>위 정보를 참고해서 오늘의 운세를 100자 내외로 작성하세요.</p>
<p>첫 문장에서 사용자의 이름을 부르세요. 예시: "(이름)님 안녕하세요."<br>생일에 따라 나이와 태어난 계절을 추측하고 어울리는 운세를 출력하세요.</p>

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

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

‘이름: ’ 항목 우측에 Name 변수를 배치하고, ‘생일: ‘ 항목 우측에 BirthDay 변수를 배치합니다.

7단계: LLM 출력 변수 선언하기

최종 출력을 위해 Output 노드와 연결하려면, LLM 노드에서 Output 변수를 선언해야 합니다.

자료형은 String으로 지정하고, 변수명은 Fortune으로 설정하면 LLM 노드의 모든 설정이 완료됩니다.

본 튜토리얼에서 LLM 노드 세부 설정은 기본값을 유지하여 진행합니다.

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

프롬프트 구성을 마친 후에는 Input 영역의 TEST 버튼을 눌러 노드 테스트를 실행합니다.

노드 테스트란

이름과 생일을 입력한 뒤 테스트를 실행했을 때 정상적으로 운세 문장이 출력된다면, LLM 노드가 올바르게 구성된 것입니다.

9단계: Output 노드 연결하기

이제 생성된 오늘의 운세 결과값을 Output 노드로 전달합니다.

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

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

LLM 노드에서 생성한 Fortune 변수를 선택 또는 드래그 앤 드롭 방식으로 Today 변수와 연결합니다.

이로써 ‘오늘의 운세’ 생성 워크플로우가 완성되었습니다.

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

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

단일 테스트와 마찬가지로 이름과 생일을 입력한 뒤 Run test를 실행하면, Output에 오늘의 운세 결과가 표시됩니다.

"Today": "Joy님 안녕하세요. 2000년 1월 1일생으로 겨울의 차분함과 새해의 희망을 품고 태어나셨군요. 오늘은 당신의 긍정 에너지가 빛날 하루가 될 거예요! 😊\n\n- <strong>오늘의 운세 한 줄 요약:</strong> 차분하면서도 밝은 에너지가 당신을 돋보이게 할 하루입니다.\n\n- <strong>오늘의 운세 상세:</strong>  \n  - <strong>금전:</strong> 예상치 못한 작은 행운이 찾아올 수 있으니 기분 좋게 받아보세요.  \n  - <strong>사랑:</strong> 주변 사람들에게 따뜻한 미소를 건네면 좋은 인연이 다가올지도 몰라요.  \n  - <strong>건강:</strong> 겨울에 태어난 당신, 오늘은 특히 따뜻한 차 한 잔으로 몸을 녹여보세요.  \n  - <strong>기타:</strong> 새로운 일에 도전하기 좋은 날입니다. 자신감을 가져보세요!\n\n- <strong>행운의 아이템:</strong> 포근한 스카프  \n- <strong>응원의 한 마디:</strong>

다음 단계

🎉 축하합니다! 첫 번째 Agentria 워크플로우인 오늘의 운세를 완성했습니다.

이제 다양한 입력값을 적용해 결과를 확인해보고, LLM 프롬프트를 수정하며 워크플로우의 성능을 개선해 보세요.

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

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

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