새로운 Gemini API 설명서와 커뮤니티 포럼을 확인하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Gemini로 AI 슬라이드 검토자 빌드

이 코드 프로젝트를 사용하여 Google Workspace 프레젠테이션의 슬라이드 검토자 부가기능을 조합, 실행, 맞춤설정하세요. 일주일에 한 번씩 또는 1년에 한 번씩 발표하는 경우 대부분의 경우 제대로 하는 데 약간의 도움을 받을 수 있습니다. 슬라이드에 너무 많은 내용을 넣는 편인가요? 시각 자료로 프레젠테이션을 나누는 것을 잊었나요? 조직으로부터 효과적인 프레젠테이션에 관한 가이드라인이 있을 수도 있습니다. 최근에 읽어 보셨나요?

Slides Advisor 프로젝트는 필요할 때마다 인공지능 (AI) 기술을 사용하여 프레젠테이션을 검토하고 피드백을 제공하는 오픈소스 Google Workspace 부가기능입니다. 이 프로젝트에서는 Google의 Gemini API 이미지 및 텍스트 처리 기능을 사용하여 Google Slides를 일련의 가이드라인에 따라 분석하고 가이드라인을 얼마나 잘 따르고 있는지 확인할 수 있습니다. 또한 조직의 권장사항에 따라 가이드라인을 맞춤설정할 수도 있고, 직접 정의한 규칙을 기반으로 프레젠테이션을 개선하도록 알릴 수도 있습니다.

프로젝트 관련 동영상 개요와 프로젝트를 빌드하는 담당자의 유용한 정보를 비롯한 프로젝트 확장 방법은 AI Slides Reviewer - Build with Google AI를 확인하세요. 그 외의 경우 다음 안내에 따라 프로젝트 확장을 시작할 수 있습니다.

Google Slides의 사이드바로 실행되는 Slides Advisor 부가기능 그림 1. 사이드바 패널로 실행되는 Google Slides용 Slides 관리자 부가기능

프로젝트 설정

이 안내는 개발 및 테스트를 위해 Slides Advisor 프로젝트를 가져오는 방법을 안내합니다. 일반적인 단계로 Google Apps Script 프로젝트를 만들고, API 액세스를 위한 Google Cloud 프로젝트를 설정하고, 프로젝트의 일부 스크립트 속성을 설정합니다.

Apps Script 프로젝트 만들기

이 Slides Advisor 프로젝트는 Google Slides의 부가기능으로 실행됩니다. Google Slides 웹 인터페이스를 사용하여 프로젝트를 설정하고 코드를 위한 Apps Script 프로젝트를 만듭니다.

새 Apps Script 프로젝트를 만들려면 다음 단계를 따르세요.

Google Workspace용 Slides 웹 앱으로 이동합니다.
기존 프레젠테이션을 열거나 새 프레젠테이션을 만듭니다.
Slides 프레젠테이션에서 확장 프로그램 > Apps Script를 선택합니다.

이 단계를 완료하면 Apps Script 웹 사용자 인터페이스에 제목 없는 프로젝트가 새로 생성됩니다. 이 프로젝트는 시작한 프레젠테이션에 연결됩니다. 쉽게 찾을 수 있도록 프로젝트 이름을 지정합니다.

Apps Script 프로젝트의 이름을 지정하려면 다음 단계를 따르세요.

Apps Script 웹 인터페이스에서 제목 없는 프로젝트 텍스트를 선택합니다.
Rename Project 대화상자에서 My Slides Advisor를 입력한 후 Rename을 선택합니다.

프로젝트 파일 준비

Slides Advisor 프로젝트에는 5개의 코드 파일이 있으며 새 Apps Script 프로젝트에 코드를 복사하려면 먼저 이 파일을 설정해야 합니다. 이 섹션에서는 프로젝트를 준비하고 코드를 가져오는 방법을 설명합니다.

프로젝트 파일을 준비하려면 다음 안내를 따르세요.

내 슬라이드 관리자 프로젝트가 포함된 Apps Script 웹 인터페이스를 엽니다.
왼쪽 메뉴에서 < > Editor 뷰를 선택합니다.
Code.gs 코드 파일 이름으로 마우스를 가져간 후 컨텍스트 메뉴에서 Rename을 선택하고 main을 입력하여 Code.gs 파일 이름을 main.gs로 바꿉니다. 인터페이스에서 .gs 확장자가 자동으로 추가됩니다.
왼쪽 사이드 메뉴에서 톱니바퀴 아이콘 (프로젝트 설정)을 선택하고 'appscript.json' 매니페스트 파일 표시 옵션을 사용 설정하여 프로젝트의 appscript.json 매니페스트 파일을 표시합니다.
Apps Script 웹 인터페이스의 왼쪽 메뉴에서 < > 편집기 뷰를 선택합니다.
Files 헤더 오른쪽에 있는 + (더하기) 아이콘을 선택하고 Script를 선택한 다음 ui를 입력하여 ui.gs 코드 파일을 만듭니다.
이전 단계를 반복하여 slides.gs 및 ai.gs 코드 파일을 만듭니다.

이제 Apps Script 프로젝트에 다음과 같이 대부분 비어 있는 코드 파일 5개가 포함됩니다.

appscript.json
main.gs
ui.gs
slides.gs
ai.gs

다음 단계를 위해 저장소에서 프로젝트 코드를 가져와 Apps Script 프로젝트에 복사합니다.

프로젝트 코드 가져오기

Slides Advisor 프로젝트의 코드는 코드 저장소에 호스팅됩니다. 이 코드로 작업하려면 이 코드를 Apps Script 프로젝트에 복사해야 합니다. 이 섹션에서는 프로젝트 코드를 가져오는 방법을 설명합니다.

프로젝트 코드를 가져오는 방법은 다음과 같습니다.

프로젝트 매니페스트 파일 appsscript.json의 프로젝트 코드 저장소로 이동합니다.
이 코드 파일의 내용을 클립보드에 복사합니다.
Apps Script 웹 인터페이스로 돌아가서 appsscript.json 파일 이름을 선택하고 코드를 코드 편집기 패널에 붙여넣어 이전 코드를 모두 바꿉니다.
다른 코드 파일 4개에 대해서도 이 절차를 반복합니다.
- main.js 코드를 main.gs 파일에 복사합니다.
- ui.js 코드를 ui.gs 파일에 복사합니다.
- slides.js 코드를 slides.gs 파일에 복사합니다.
- ai.js 코드를 ai.gs 파일에 복사합니다.

Google Cloud 프로젝트 연결

이 프로젝트는 Google Cloud 프로젝트를 사용하여 Gemini AI 모델에 액세스합니다. Google Cloud는 특정 데이터 개인 정보 보호 정책과 함께 Slides Advisor와 같이 애플리케이션을 빌드하는 데 유용한 여러 소프트웨어 서비스를 제공합니다. AI API 액세스 권한이 있는 Cloud 프로젝트를 만들고, 프로젝트의 서비스 계정을 만들고, 서비스 계정의 키를 만들고, 부가기능 프로젝트에 키를 설치하여 부가기능 코드를 Gemini API에 연결합니다.

Cloud 프로젝트 구성

Gemini API에 연결하는 데 사용하는 Cloud 프로젝트에 Vertex AI API 서비스가 사용 설정되어 있어야 하며 Slides Advisor 부가기능에서 이 프로젝트로 인증된 연결을 만들어야 합니다. 또한 Vertex AI API를 사용하려면 Vertex AI API를 사용하는 프로젝트에 결제를 사용 설정해야 합니다

Vertex AI API 액세스로 Cloud 프로젝트를 구성하려면 다음 안내를 따르세요.

Google Cloud 콘솔로 이동하여 필요한 경우 로그인합니다.
Google Cloud 콘솔에서 기존 Cloud 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
프로젝트의 콘솔 대시보드 페이지의 API 패널에서 API 개요로 이동을 선택하거나 https://console.cloud.google.com/apis/로 이동합니다.
API 및 서비스 페이지 상단에서 + API 및 서비스 사용 설정을 선택합니다.
API 라이브러리 페이지에서 vertex ai api를 검색하고 Vertex AI API 옵션을 선택한 다음 사용 설정 버튼을 선택합니다.
아직 활성화되지 않은 경우 Google Cloud 프로젝트에 대해 결제를 사용 설정한 후 Vertex AI API 콘솔 페이지에서 사용 설정 버튼을 선택하여 AI API를 사용 설정해야 합니다.
프로젝트의 API 및 서비스 페이지로 이동하여 Vertex AI API가 사용 설정되어 있는지 확인합니다. 이제 이 페이지에 Vertex AI API가 나열됩니다.

서비스 계정 만들기

Slides Advisor 부가기능에서 Vertex AI API 및 Gemini 모델에 액세스하려면 Cloud 프로젝트에 대한 인증된 연결이 필요합니다. Cloud 프로젝트에서 Vertex AI API에 액세스할 수 있는 서비스 계정을 먼저 생성하여 이 연결을 만듭니다. Slides Advisor 프로젝트는 이 서비스 계정을 사용하여 연결됩니다.

Slides 상담사 부가기능의 서비스 계정을 만들려면 다음 안내를 따르세요.

Google Cloud 콘솔에서 Cloud 프로젝트의 API 및 서비스 페이지로 이동합니다.
페이지 왼쪽에서 사용자 인증 정보를 선택합니다.
페이지 상단에서 + 사용자 인증 정보 만들기 > 서비스 계정을 선택합니다.
서비스 계정 만들기 페이지의 서비스 계정 세부정보 섹션에서 서비스 계정 이름, ID, 설명을 입력합니다.
만들고 계속하기를 선택하여 서비스 계정을 만듭니다.
이 서비스 계정에 프로젝트에 대한 액세스 권한 부여 섹션에서 역할 제어를 선택합니다.
필터 필드 검색에서 Vertex AI 사용자 권한 집합을 선택한 다음 계속을 선택합니다.
완료를 선택하여 서비스 계정 만들기를 완료합니다.

서비스 계정 만들기에 대한 자세한 내용은 Google Cloud 서비스 계정 만들기 문서를 참조하세요.

서비스 계정 키 만들기 및 설치

Slides Advisor 프로젝트는 이전 절차에서 만든 서비스 계정에 인증할 수 있어야 합니다. 서비스 계정의 키를 만들고 Slides Advisor Apps Script 프로젝트에서 이 키를 스크립트 속성으로 구성하여 인증을 사용 설정할 수 있습니다. 다음 절차에서는 키를 만들고 프로젝트에서 구성하는 방법을 설명합니다.

서비스 계정 키를 만들고 구성하려면 다음 안내를 따르세요.

Google Cloud 콘솔에서 Cloud 프로젝트의 API 및 서비스 페이지로 이동합니다.
페이지 왼쪽에서 사용자 인증 정보를 선택합니다.
서비스 계정 섹션에서 만든 서비스 계정을 찾고 계정 이메일 주소 또는 연필 아이콘을 선택하여 수정합니다.
서비스 계정 편집 창의 페이지 상단에서 키 탭 제목을 선택합니다.
키 섹션에서 키 추가 > 새 키 만들기를 선택합니다.
비공개 키 만들기 대화상자에서 JSON을 선택한 다음 만들기를 선택합니다. 이 단계에서는 projectid-hashcode.json이라는 키 파일을 만들어 컴퓨터에 자동으로 다운로드합니다.
다운로드한 projectid-hashcode.json 파일을 열고 콘텐츠를 복사합니다.
My Slides Advisor 프로젝트가 포함된 Apps Script 웹 인터페이스를 열고 왼쪽 메뉴에서 설정 뷰를 선택합니다.
스크립트 속성 섹션에서 스크립트 속성 수정 버튼을 선택한 후 스크립트 속성 추가 버튼을 선택합니다.
새 속성 필드에 SERVICE_ACCOUNT_KEY를 입력하고 값 필드에 다운로드한 projectid-hashcode.json 파일의 콘텐츠를 복사합니다.
스크립트 속성 저장 버튼을 선택하여 새 속성을 저장합니다.

서비스 계정 키 만들기에 대한 자세한 내용은 Google Cloud 서비스 계정 키 만들기 및 삭제 문서를 참조하세요.

부가기능 프로젝트 테스트

Slides 상담사 아이콘이 있는 Google Workspace 슬라이드 패널 Slides Advisor 프로젝트를 테스트하려면 부가기능 코드의 테스트 배포를 만들고 해당 테스트 배포를 설치해야 합니다. 이 테스트 구성에서는 프로젝트에서 Apps Script 부가기능을 시작한 Google Slides 프레젠테이션에서만 프로젝트를 사용할 수 있으며 다른 Slides 프레젠테이션에서는 사용할 수 없습니다. 더 폭넓은 사용을 위해 부가기능을 배포하는 방법에 대한 자세한 내용은 Google Workspace Apps Script 문서의 배포 만들기 및 관리 주제를 참조하세요.

Apps Script 프로젝트 코드를 배포하고 테스트하려면 다음 안내를 따르세요.

Apps Script 웹 인터페이스 상단에서 배포 > 배포 테스트를 선택합니다.
배포 테스트 대화상자에서 유형 선택 옆에 있는 톱니바퀴 아이콘과 Google Workspace 부가기능을 선택합니다.
애플리케이션: 슬라이드 제목 옆의 설치 버튼을 선택합니다.
최신 코드 테스트의 기본 설정을 그대로 두고 완료를 선택합니다.
Apps Script 프로젝트에 연결된 Google Slides 프레젠테이션을 탐색하고 웹페이지를 새로고침합니다.
프레젠테이션 웹 앱의 오른쪽 하단에서 ( <) 아이콘을 선택하여 측면 패널을 열고 흑백 눈 아이콘을 선택하여 Slides Advisor 패널을 엽니다.

이 단계를 완료하고 부가기능을 성공적으로 실행하면 수정을 시작하여 다른 가이드라인을 사용하거나 다른 워크플로를 따를 수 있습니다. Slides Advisor 부가기능의 몇 가지 기본적인 수정 방법에 관한 안내는 다음 섹션을 참고하세요.

리뷰 동작 수정하기

프로젝트 코드를 수정하여 Gemini API에서 가져오는 출력과 부가기능에서 제공하는 사용자 인터페이스 측면에서 Slides Advisor의 검토 동작을 변경할 수 있습니다. 이 튜토리얼에서는 프레젠테이션 슬라이드 검토 동작을 수정하라는 메시지 안내를 변경하는 데 중점을 둡니다. Apps Script를 사용하여 Google Slides 사용자 인터페이스를 확장하는 방법에 관한 자세한 내용은 Google Slides 확장을 참고하세요.

검토 가이드라인 변경

Slides Advisor에는 단순성, 색상 및 서체, 구조 및 공백, 그래픽 및 아이콘을 위한 카테고리가 포함된 기본 슬라이드 검토 가이드라인 세트가 프로그래밍되어 있습니다. 검토 가이드라인은 선택한 슬라이드 및 발표자 노트의 스냅샷 이미지와 함께 Gemini API를 통해 프롬프트에 포함된 텍스트 안내입니다.

텍스트 안내를 변경하여 부가기능의 검토 동작을 변경할 수 있습니다. 예를 들어 Gemini 모델에 카테고리 제목과 같은 줄에 카테고리 평점이 있는 리뷰를 출력하거나 카테고리 이름을 변경하도록 지시할 수 있습니다.

카테고리 평점 위치 및 카테고리 이름을 변경하려면 다음 단계를 따르세요.

내 슬라이드 관리자 프로젝트가 포함된 Apps Script 웹 인터페이스를 엽니다. 필요한 경우 Apps Script 프로젝트가 포함된 Google 프레젠테이션을 열고 확장 프로그램 > Apps Script를 선택하여 프로젝트 창으로 이동합니다.
왼쪽 메뉴에서 < > Editor 뷰를 선택한 다음 ai.gs 파일 이름을 선택합니다.

ai.gs 코드 파일에서 SYSTEM_PROMPT 문자열 상수를 찾아 굵게 표시된 텍스트로 안내를 수정합니다.

const SYSTEM_PROMPT = `
...
For each of the following categories evaluate the given slide. Score each
category on a scale of 0 to 100, show the score next to the category heading,
and concisely explain the reasoning. Do not suggest improvements if the score
is 80 or above.

동일한 SYSTEM_PROMPT 문자열 상수에서 Simplicity 카테고리 텍스트를 Message로 변경합니다.
```
const SYSTEM_PROMPT = `
...
* Message -- Slides should focus on one main idea per slide and ...
```
변경사항을 ai.gs 코드 파일에 저장합니다.
Apps Script 프로젝트에 연결된 Google Slides 프레젠테이션을 탐색하고, 웹페이지를 새로고침하고, 부가기능을 다시 실행하여 부가기능의 변경사항을 테스트합니다.

Slides Advisor 부가기능의 테스트 배포를 아직 설정하지 않았다면 부가기능 프로젝트 테스트의 안내를 따릅니다.

리뷰 요구사항에 맞게 SYSTEM_PROMPT 문자열 상수에서 리뷰 카테고리 안내를 삭제, 교체 또는 재작성할 수 있습니다. 다른 검토 프롬프트 접근 방식을 사용해 보거나 전체 검토 프롬프트를 재작성하려면 Google AI Studio 웹 애플리케이션을 확인하세요. 이 앱을 사용하면 편리한 인터페이스에서 Gemini 프롬프트를 프로토타입으로 제작하고 테스트 및 저장할 수 있으며 Slides Advisor 프로젝트와 동일한 Gemini API를 사용합니다. AI Studio 사용에 대한 자세한 내용은 AI Studio 빠른 시작 가이드를 참조하세요.

모델 동작 구성 변경

Gemini API는 요청 프롬프트에 응답하여 모델의 일반 작업을 변경하기 위한 여러 설정을 제공합니다. 특히 모델의 온도 설정을 사용하면 모델이 응답에서 허용되는 변동 정도를 설정할 수 있습니다. 0이 가장 낮고 1이 가장 높습니다. 이 값을 0.1로 설정하면 매우 일관된 응답이 생성되지만 이 동작은 반복적으로 보일 수 있으며 리뷰 의견을 받는 사용자에게 유용하지 않을 수 있습니다. 온도 값을 더 높게 설정하는 것이 좋습니다. 온도가 높을수록 결과의 일관성이 높아집니다.

리뷰 답변의 강도를 높이려면 다음 단계를 따르세요.

내 슬라이드 관리자 프로젝트가 포함된 Apps Script 웹 인터페이스를 엽니다.
왼쪽 메뉴에서 < > Editor 뷰를 선택한 다음 ai.gs 파일 이름을 선택합니다.

ai.gs 코드 파일에서 analyzeSlides() 함수를 찾고 temperature 값을 0.3로 설정하여 generationConfig 상수를 수정합니다.

function analyzeSlides(slide) {

    const generationConfig = {
        temperature: 0.3,
        maxOutputTokens: 1024 * 2,
    };

변경사항을 ai.gs 코드 파일에 저장합니다.
Apps Script 프로젝트에 연결된 Google Slides 프레젠테이션을 탐색하고, 웹페이지를 새로고침하고, 부가기능을 다시 실행하여 부가기능의 변경사항을 테스트합니다.

모델 동작 구성 설정에 관한 자세한 내용은 GenerationConfig의 Gemini API 문서를 참고하세요.

추가 리소스

Slides Advisor 프로젝트에 관한 자세한 내용은 코드 저장소를 참고하세요. 애플리케이션을 빌드하는 데 도움이 필요하거나 다른 개발자와 공동작업하려면 Google Developers 커뮤니티 Discord 서버를 확인하세요. Build with Google AI 프로젝트를 더 보려면 동영상 재생목록을 확인하세요.