CLOVA Studio 운영자6 Posted Tuesday at 06:33 오전 공유하기 Posted Tuesday at 06:33 오전 Postman Flows를 활용해 CLOVA Studio API와 외부 API를 시각적으로 연결하고, 실제 애플리케이션처럼 동작하는 워크플로우를 구현하는 방법을 소개합니다. 최근에는 Dify, n8n 등 GUI 기반의 노코드/로우코드 워크플로우 도구들이 등장하면서, 외부 서비스 연동, 조건 분기, LLM 활용 등 복합적인 작업을 시각적으로 구성할 수 있는 환경이 떠오르고 있습니다. 개발 경험이 없는 사용자도 손쉽게 자동화를 설계하고 실행할 수 있도록 돕는 것이 특징인데요, Postman Flows 역시 이러한 흐름에 맞춘 노코드 도구로, API 요청을 시각적으로 연결해 복잡한 자동화 시나리오를 쉽게 구성할 수 있습니다. 이번 예제에서는 여러 API 호출을 순차적으로 연결해 하나의 자동화 시나리오를 완성해 보겠습니다. 1. 시나리오 소개 이번 예제에서는 회의 기록을 요약해 공유하고, 회의 중 나온 일정 정보를 자동으로 캘린더에 등록하는 흐름을 구성합니다. 이를 위해 CLOVA Studio의 Chat Completions V3 API와 Google Drive, Slack, Google Calendar API를 불러오고, 각 단계를 Postman Flows 상에서 시각적으로 연결하여 자동화를 구현합니다. 전체 흐름은 다음과 같습니다. Google Drive에 저장된 회의록 파일을 불러옵니다. Chat Completions V3 API를 통해 회의록을 요약하고, 동시에 회의 중 언급된 일정 및 액션 아이템을 추출합니다. 요약 결과는 Slack 메시지로 전송합니다. 추출된 일정 정보는 Google Calendar에 등록합니다. 2. 사전 준비 본 예제를 시작하기 전에, Google Drive, Google Calendar, Slack API를 연동하기 위한 인증 정보 발급 및 권한 설정 방법을 안내합니다. 2.1 Google Drive 및 Google Calendar API 준비 Google Drive API와 Google Calendar API를 활용하기 위한 설정 방법입니다. 두 API 모두 설정 방식이 동일하므로, 하나의 절차로 함께 안내합니다. 다음 과정에 대한 자세한 설명은 Google Cloud 가이드를 참고하세요. 먼저 Google API를 사용하려면 Google 계정이 필요하며, Google Cloud Console에 로그인할 수 있어야 합니다. 프로젝트 생성 Google Cloud Console에 접속하여 상단의 [프로젝트 선택] 버튼을 클릭합니다. [새 프로젝트] 버튼을 클릭한 뒤, 필수 정보들을 입력하고 [만들기]를 클릭합니다. API 활성화 좌측 메뉴에서 API 및 서비스 > 라이브러리로 이동합니다. Google Drive API, Google Docs API, Google Calendar API를 하나씩 검색하여 각 페이지에서 [사용] 버튼을 클릭해 활성화합니다. 참고로 Google Docs API는 직접 호출하지 않더라도, Google Drive API를 통해 문서 파일을 불러오기 위해서 함께 활성화가 필요합니다. OAuth 동의 화면 구성 좌측 메뉴에서 API 및 서비스 > OAuth 동의 화면으로 이동합니다. [시작하기] 버튼을 클릭한 뒤, 앱 정보와 대상(반드시 외부로 설정), 연락처 정보를 입력하고 [만들기] 버튼을 클릭합니다. OAuth 클라이언트 ID 생성 클라이언트 메뉴로 이동하여 [+ 클라이언트 만들기] 버튼을 클릭합니다. 애플리케이션 유형은 '웹 애플리케이션'을 선택하고, 하단의 승인된 리디렉션 URI 영역에 'https://oauth.pstmn.io/v1/callback'를 입력한 뒤 [만들기] 버튼을 클릭합니다. 생성된 클라이언트 ID와 보안 비밀번호를 복사해 둡니다. 테스트 사용자 등록 대상 메뉴로 이동하여 [+ Add users] 버튼을 클릭하고, 사용자 이메일(구글 계정)을 추가합니다. 2.2 Slack API 준비 Slack API를 활용하기 위한 설정 방법을 안내합니다. 다음 과정에 대한 자세한 설명은 Slack API 가이드를 참고하세요. Slack API를 사용하려면 Slack 계정이 필요하며, 사전에 워크스페이스와 채널이 생성되어 있어야 합니다. 앱 생성 Slack API에 접속하여 [Create an App] 버튼을 클릭하고, 팝업이 나타나면 [From scratch]을 선택합니다. 필수 정보를 입력한 뒤 [Create App] 버튼을 클릭합니다. OAuth 권한 설정 생성한 앱을 클릭한 뒤, 좌측 메뉴에서 OAuth & Permissions로 이동합니다. Scopes 영역으로 내려가 User Token Scopes에서 [Add an OAuth Scope] 버튼을 클릭한 뒤, 'calls: write' 권한을 추가합니다. OAuth Tokens 영역에서 [Install to Workspace] 버튼을 클릭하고, 발급된 토큰을 복사해 둡니다. Redirect URLs 영역에서 [Add New Redirect URL] 버튼을 클릭하고, 'https://oauth.pstmn.io/v1/callback'를 입력한 뒤 [Add] 버튼, [Save URLs] 버튼을 차례대로 클릭합니다. 3. API 구성 이번 단계에서는 이후 Flow 생성을 위해 Postman에서 Google Drive, Google Calendar, Slack API 요청을 사전에 구성하는 작업을 안내합니다. 아래의 Postman Collection 파일에는 본 예제에 사용되는 API 정보가 포함되어 있습니다. 좌측의 Collections 탭을 선택한 후 [Import] 버튼을 클릭하여 업로드할 수 있습니다. [Cookbook] Postman_example_collection.json 3.1 및 3.2 단계에서 필요한 인증은 아래 공통 절차를 참고하여 구성해 주세요. Quote Google Drive 및 Calendar API 인증 절차 Postman에서 새 Collection 및 Request를 생성한 뒤, Authorization 탭으로 이동합니다. Auth Type을 OAuth 2.0으로 설정합니다. 2.1 Google Drive 및 Google Calendar API 준비 단계에서 발급 받은 Client ID와 Client Secret을 입력합니다. Scope 입력란에 아래 값을 공백으로 구분된 한 줄로 입력합니다. 줄바꿈 없이 공백 하나로만 구분해야 하며, 쉼표나 개행이 포함되면 인증이 실패할 수 있습니다. https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/userinfo.profile [Get New Access Token] 버튼을 클릭하여 인증을 진행합니다. 팝업 화면이 나타나면 [Use Token] 버튼을 클릭하여 요청에 적용합니다. 3.1 Google Drive API 파일 이름을 기준으로 파일 ID를 검색한 뒤, 해당 파일 ID를 이용해 파일 내용을 조회하는 흐름을 구성합니다. API 명세에 대한 자세한 설명은 Google Drive API 가이드에서 확인 할 수 있습니다. 3.1.1 파일 ID 조회 먼저, 파일 이름으로 파일 ID를 조회하는 요청을 구성합니다. Postman 화면의 좌측 메뉴에서 Collections을 클릭한 후, 상단의 [New] 버튼을 클릭하여 새로운 HTTP 요청을 생성합니다. 다음과 같이 요청 정보를 입력합니다: Quote Method GET 요청 URL https://www.googleapis.com/drive/v3/files?q=name contains '{{fileName}}' and mimeType='application/vnd.google-apps.document'&fields=files(id,name,createdTime,modifiedTime) {{fileName}}은 flow에서 앞 단계의 결과로 설정되는 변수이며, 실행 시 실제 값으로 자동 치환되어 요청에 사용됩니다. Authorization Google Drive 및 Calendar API 인증 절차를 따라 적용합니다. 3.1.2 파일 콘텐츠 조회 다음은 조회한 파일 ID를 기반으로 해당 문서의 본문 내용을 불러오는 요청입니다. Postman 화면의 좌측 메뉴에서 Collections을 클릭한 후, 상단의 [New] 버튼을 클릭하여 새로운 HTTP 요청을 생성합니다. 다음과 같이 요청 정보를 입력합니다: Quote Method GET 요청 URL https://www.googleapis.com/drive/v3/files/{{file_ID}}/export?mimeType=text/plain {{fileID}}는 flow에서 앞 단계의 결과로 설정되는 변수이며, 실행 시 실제 값으로 자동 치환되어 요청에 사용됩니다. Authorization Google Drive 및 Calendar API 인증 절차를 따라 적용합니다. 3.2 Google Calendar API Google Calendar에 새 이벤트를 생성하는 요청을 구성합니다. calendarID는 Google Calendar 웹 화면에서 [설정 > 캘린더 통합] 메뉴를 통해 확인할 수 있습니다. API 명세에 대한 자세한 설명은 Google Calendar API 가이드에서 확인 할 수 있습니다. Postman 화면의 좌측 메뉴에서 Collections을 클릭한 후, 상단의 [New] 버튼을 클릭하여 새로운 HTTP 요청을 생성합니다. 다음과 같이 요청 정보를 입력합니다: Quote Method POST 요청 URL https://www.googleapis.com/calendar/v3/calendars/{{calendarID}}/events {{calendarID}}는 이후 flow 블록 내 변수 입력란에서 사용자가 직접 값을 입력해야 합니다. Authorization Google Drive 및 Calendar API 인증 절차를 따라 적용합니다. Body(raw) { "summary": "{{eventSummary}}", "location": "{{eventLocation}}", "description": "{{eventDescription}}", "start": { "dateTime": "{{eventStartTime}}", "timeZone": "Asia/Seoul" }, "end": { "dateTime": "{{eventEndTime}}", "timeZone": "Asia/Seoul" }, "reminders": { "useDefault": true } } 3.3 Slack 메시지 전송 API Slack 채널에 메시지를 전송하는 요청을 구성합니다. API 명세에 대한 자세한 설명은 Slack API 가이드(#chat.postMessage)에서 확인 할 수 있습니다. Postman 화면의 좌측 메뉴에서 Collections을 클릭한 후, 상단의 [New] 버튼을 클릭하여 새로운 HTTP 요청을 생성합니다. 다음과 같이 요청 정보를 입력합니다: Quote Method POST 요청 URL https://slack.com/api/chat.postMessage Authorization Auth Type을 Bearer Token으로 설정한 뒤, 2-2. Slack API 준비 단계에서 발급 받은 토큰을 입력합니다. Body(raw) { "channel": "{{channelID}}", "text": "{{summaryContent}}" } {{channelID}}는 이후 flow 블록 내 변수 입력란에서 사용자가 직접 값을 입력해야 합니다. {{summaryContent}}는 flow에서 앞 단계의 결과로 설정되는 변수이며, 실행 시 실제 값으로 자동 치환되어 요청에 사용됩니다. 3.4 Chat Completions V3 API 회의록 요약을 생성하고 캘린더 일정을 추출하는 LLM 요청을 생성합니다. API 명세에 대한 자세한 설명은 CLOVA Studio API 가이드에서 확인 할 수 있습니다. Postman 화면의 좌측 메뉴에서 Collections을 클릭한 후, 상단의 [New] 버튼을 클릭하여 새로운 HTTP 요청을 생성합니다. 다음과 같이 요청 정보를 입력합니다: Quote Method POST 요청 URL https://clovastudio.stream.ntruss.com/testapp/v3/chat-completions/HCX-005 Authorization CLOVA Studio 테스트 앱 생성 가이드에 따라 인증 정보를 발급 받고 설정합니다. Body(raw) { "messages": [ { "role": "system", "content": "당신은 사용자의 회의록을 요약하고, 해당 내용을 기반으로 다음 회의 일정을 등록해주는 유용한 비서입니다. 아래 지침을 따라 *postSlack*과 *createCalendar* 함수를 반드시 모두 호출하세요.\n\n1단계: 회의록을 요약한 뒤, postSlack 함수를 호출하세요.\n요약 형식은 다음과 같습니다:\n- 첫 줄: '*📌YYYY년 M월 D일 회의록*' 형식의 굵은 텍스트\n- 둘째 줄: '*회의 주제: ○○○*' 형식으로 간단히 주제 요약\n- 셋째 줄부터: '•' 기호로 시작하는 리스트 항목으로 주요 내용을 정리합니다.\n - 각 항목의 첫 줄(주제 제목)은 강조하고, 그 아래에 관련 내용을 이어서 작성하세요.\n - 필요한 경우 담당자를 괄호로 함께 명시하고, 문장은 간결하고 자연스럽게 서술형으로 작성하세요.\n\n2단계: 회의 내용 중 일정 등록이 필요한 항목을 식별하여 createCalendar 함수를 호출하세요.\n\n두 함수는 모두 반드시 호출해야 하며, 순서를 지켜 실행해 주세요." }, { "role": "user", "content": "{{input}}" } ], "topP": 0.8, "topK": 0, "maxTokens": 2048, "temperature": 0.5, "repetitionPenalty": 1.1, "stop": [ ], "includeAiFilters": true, "seed": 42, "tool_choice": "auto", "tools": [ { "type": "function", "function": { "name": "postSlack", "description": "제공된 회의 요약 내용을 슬랙 채널에 메시지로 업로드합니다.", "parameters": { "type": "object", "properties": { "summaryContent": { "description": "슬랙에 메시지로 업로드 될 요약 된 회의 내용 입니다.", "type": "string" } }, "required": ["summaryContent"] } } }, { "type": "function", "function": { "name": "createCalendar", "description": "회의록 내용을 꼼꼼히 참고하여 다음 일정에 대한 Google Calendar 이벤트를 생성합니다.", "parameters": { "type": "object", "properties": { "eventSummary": { "description": "생성하고자하는 이벤트 일정의 제목입니다. (기본값은 '회의' 입니다.)", "type": "string" }, "eventStartTime": { "description": "생성할 이벤트의 시작 시간 입니다(ISO 8601 형식, YYYY-MM-DDTHH:MM:SS+09:00).", "type": "string" }, "eventDescription": { "description": "생성할 이벤트의 상세 내용 입니다.(기본값은 '' 입니다.)", "type": "string" }, "eventEndTime": { "description": "생성할 이벤트의 시작 시간 입니다.(ISO 8601 형식, YYYY-MM-DDTHH:MM:SS+09:00).", "type": "string" }, "eventLocation": { "description": "생성할 이벤트의 장소 입니다. (기본값은 '온라인 미팅' 입니다.)", "type": "string" } }, "required": ["eventStartTime", "eventEndTime"] } } } ] } {{input}}은 flow에서 앞 단계의 결과로 설정되는 변수이며, 실행 시 실제 값으로 자동 치환되어 요청에 사용됩니다. 4. Flow 구현 및 테스트 이제 각 API를 연동하여 전체 자동화 흐름을 구성합니다. Google Drive에서 회의 기록을 불러오고, Chat completions API로 주요 내용을 요약한 뒤, Function calling 기능을 통해 Slack에 메시지를 전송하고 Google Calendar에 일정을 등록하는 흐름을 단계별로 구현합니다. 4.1 Flow 생성 다음 절차에 따라 flow를 생성합니다. Postman을 실행한 후 좌측 메뉴에서 Flows를 클릭한 후, 상단의 [New] 버튼을 클릭합니다. 하단에 [+ Block] 버튼을 클릭하여 원하는 블록을 생성합니다. 본 쿡북 예제에서 사용되는 블록 유형은 다음과 같습니다: 마우스로 드래그하여 블록 간 연결을 구현합니다. 4.2 Flow 실행 화면을 따라서 구현하세요. 연결이 완료되면 우측 Scenarios 메뉴를 클릭한 뒤, [+ Create scenario 버튼]을 클릭하여 회의 기록이 저장된 Google Drive의 파일명을 입력하여 저장합니다. [Run] 버튼을 클릭하여 전체 워크플로우를 실행합니다. 정상적으로 실행되면, 마지막 Display 블록에 성공 문구가 노출됩니다. 4.2 실행 화면 완성된 flow 및 시나리오 테스트 결과입니다. 4.3 실행 결과 시나리오에 활용된 회의 기록 및 Slack 및 Google Calendar 자동 전송 결과입니다. 회의 기록은 임의로 생성한 가상의 데이터입니다. 5. 맺음말 이번 쿡북에서는 LLM과 외부 서비스를 연동해 회의록 요약과 일정 등록 시나리오를 구현해 보았습니다. Postman Flows와 CLOVA Studio API를 활용하면, 실제 업무에 필요한 자동화를 노코드로 손쉽게 만들 수 있다는 점을 확인하셨을 텐데요. 이와 같은 흐름은 다양한 워크플로우로 확장할 수 있습니다. 예를 들어, 라우터와 스킬셋, Chat completions API 등을 조합해 나만의 AI 에이전트를 만들거나, 여러 LLM API를 연결해 응답을 비교·평가하는 인터페이스를 구현할 수 있습니다. 또는 Function calling을 통해 사용자의 자연어 입력을 SQL로 변환한 뒤, 로그 데이터를 조회하고 결과를 차트로 시각화하는 데이터 분석 도구로 확장해 볼 수도 있습니다. 이번 예제를 바탕으로 여러분의 아이디어와 업무 흐름에 맞는 자동화 시나리오를 자유롭게 설계해 보시기 바랍니다! 링크 복사 다른 사이트에 공유하기 More sharing options...
Recommended Posts
게시글 및 댓글을 작성하려면 로그인 해주세요.
로그인