=AI()
함수는 유료...
서론: 스프레드시트에서 AI로 분류하고 싶지만 Google 스프레드시트에는 표준으로 =AI()와 같은 편리한 AI 함수가 준비되어 있지만, 이를 이용하려면 Google AI Pro (구 Gemini Advanced) 등의 개인용 유료 플랜 또는 대상이 되는 Google Workspace의 유료 플랜에 가입해야 합니다. 무료 계정 상태에서는 기본적으로 사용할 수 없습니다.
또한, 스프레드시트에서 진행하는 AI 활용 중 상당수는 사실 '긴 자연스러운 문장을 작성하게 하는 것'이라기보다는 다음과 같은 규격화된 분류/판단 작업이 아닐까요?
- Google 폼으로 도착한 설문조사의
카테고리 분류(질문 / 불량 보고 / 요청 등)
- 문의 내용으로부터의
긴급도 판단(높음 / 중간 / 낮음)
- 대응 필요 여부에 대한
플래그 지정(TRUE / FALSE)
이러한 '자연어 문장 출력이 불필요하고, 정해진 선택지 중 분류나 판정만 자동화하고 싶은' 경우에 딱 맞는 것이 Google DeepMind의 **Gemini Decisions API (모델: gemini-decision-1)**입니다.
본 기사에서는 Gemini Decisions API와 Google Apps Script(GAS)를 결합하여, 유료 플랜 미가입 상태에서도 초저비용(또는 무료 범위 내)으로 사용할 수 있는 스프레드시트 범용 사용자 정의 함수 =GEMINI_DECIDE() 를 직접 만드는 방법을 소개합니다.
gemini-decision-1
)란 무엇인가?
Gemini Decisions API(Gemini Decisions API)는 텍스트를 생성하는 것이 아니라 **'의사결정/분류/채점'에 특화된 API(및 전용 모델 gemini-decision-1)**입니다.
기존의 생성 AI(gemini-2.5-flash 등)를 사용하여 스프레드시트에서 분류 작업을 수행하는 경우와 비교했을 때, 다음과 같은 압도적인 장점이 있습니다.
1. 출력 토큰 수가 항상 '0' (출력 과금 완전 무료)
일반적인 LLM(Large Language Model)은 '불량 보고'와 같은 글자를 1토큰씩 생성하기 때문에 출력 토큰 과금이 발생하지만, Decisions API는 1회의 추론 경로에서 각 선택지의 확률(확신도)이나 점수 등의 수치 데이터만을 직접 반환합니다.
따라서, **출력 토큰 소비가 항상 0 ($0.00)**이 되어 비용을 극단적으로 절약할 수 있습니다 (입력 토큰 역시 100만 토큰당 $0.10으로 매우 저렴하여 Google AI Studio의 무료 범위에서도 시도해 볼 수 있습니다).
2. 표기 흐트러짐이나 JSON 파싱 오류가 발생하지 않음
일반적인 생성 AI에 '「질문」「불량」「요청」 중 하나로 답해주세요'라고 지시하면, 임의로 '카테고리: 불량입니다.'와 같은 불필요한 문구를 붙이거나 표기 흐트러짐(表記ゆれ)을 일으키는 경우가 있습니다.
Decisions API는 사전에 전달된 선택지(키)에 대한 확률 분포를 반환하기 때문에, 지정된 선택지 외의 문자열이 돌아올 가능성이 100% 없습니다.
3. 판정 유형 (Primitive)
Decisions API에는 용도에 맞는 판정 유형이 준비되어 있으며, 이번 사용자 정의 함수에서는 특히 스프레드시트와 궁합이 좋은 다음 두 가지를 활용합니다.
: 2~255개의 선택지 중 최적의 것을 골라 전체 선택지의 확률 분포와 확신도를 반환함 (choice (단일 선택)) 카테고리 선택/긴급도 판정에 최적)
: 조건에 부합하는지에 대한 확률(0.01~0.99)과 확신도를 반환함 (noul (Yes/No 판정))에 최적) TRUE / FALSE 플래그 지정
※ 그 외 단계 평가용 score 타입도 있지만, 스프레드시트 상에서는 '높음・중간・낮음'이나 'Lv1~Lv5'처럼 라벨과 기준을 명시할 수 있는 choice 타입을 사용하면, 카테고리 분류와 같은 감각으로 직관적으로 긴급도 판정까지 다룰 수 있습니다.
=GEMINI_DECIDE()
의 사양
이번에 만들 사용자 정의 함수는 표준 =AI() 함수처럼 셀에 수식을 넣기만 하면 사용할 수 있고, 게다가 Google 폼 연동 시에도 불필요한 API 소비를 줄일 수 있도록 다음 기능을 담아 만든 사용자 정의 함수입니다.
구문
=GEMINI_DECIDE(prompt, targetRange, [categories], [topN], [showConfidence])
인수 상세 설명
스프레드시트에서 =GEMINI_DECIDE(를 입력했을 때도 일본어 가이드(수식 도움말)가 표시되도록 설계되었습니다. 각 인수의 역할은 다음과 같습니다.
prompt
(필수)
-
역할: AI에게 판정 지시를 일본어로 지정합니다. -
지정 예시: "문의 내용을 분류하여"
"고객의 긴급도를 판정하여"
"클레임이거나 즉시 회신이 필요한 내용인가?"
targetRange
(필수)
-
역할: 판정 대상 셀 또는 범위를 지정합니다. -
지정 예시: -
단일 셀 (예): 하나의 셀만 판정합니다. B2
) -
다중 열의 1행 (예): '제목(B열)'과 '본문(C열)'처럼 여러 열을 지정하면, 자동으로 B2:C2로 결합하여 하나의 문장으로 판정합니다. -
다중 행・전체 열 (예): 행별로 판정을 수행하고 결과를 세로 방향으로 자동 스필(펼쳐) 출력합니다. B2:B100
또는 B2:C
)공백의 행은 API를 호출하지 않고 자동으로 건너뛰기하므로, Google 폼 연동 시트에서 아직 답변이 오지 않은 미래의 행까지 미리 지정해 둘 수 있습니다.
categories
(선택 가능)
-
역할: 분류하고 싶은 **카테고리 선택지 (분류 원본 소스)**를 지정합니다. 지정 방법에 따라 4가지 방식으로 작동합니다. -
지정 예시: -
생략 (또는 공백): Decisions API의 noul (Yes/No 판정) 모드로 작동하며, 프롬프트의 질문에 대해 TRUE 또는 FALSE를 출력합니다.
쉼표 구분 문자열 (예): 함수 내에서 직접 카테고리 이름을 지정하여 그중 하나를 선택하게 합니다. "질문,불량 보고,기능 요청,기타"
) -
별도 시트 등의 1열 범위 (예): 지정한 셀 범위에 적힌 항목을 선택지로 사용합니다. 마스터!A2:A5
) -
별도 시트 등의 2열 범위 (예): **1열을 '카테고리명', 2열을 '해당 카테고리의 판정 기준(설명문)'**으로 API에 전달합니다. '높음・중간・낮음'의 긴급도 판정 등, 기준을 명확하게 전달하고 싶을 때 정확도가 극적으로 올라갑니다. 마스터!A2:B5
)
topN
(선택 가능・기본값: 1)
-
역할: 확률이 높은 순서대로 상위 몇 개의 카테고리를 출력할지 숫자로 지정합니다. -
지정 예시: -
생략 또는 공백: 가장 확률이 높은 1 순위의 결과만 출력합니다. -
:1위뿐만 아니라, 2위・3위 후보도 2
이상의 숫자(예: 2나 3)는 오른쪽 옆 셀로 가로 방향으로 스필 전개되어 출력됩니다("여러 카테고리에 걸쳐 있는 문의"를 놓치고 싶지 않을 때 유용합니다).
showConfidence
(선택 가능・기본값: FALSE)
-
역할: AI가 해당 판정에 대해 얼마나 자신감을 가지고 있는지 나타내는 **확신도 (0~1의 확률)**를 함께 출력할지 TRUE/FALSE로 지정합니다. -
지정 예시: -
생략 또는 공백: 카테고리명(또는 FALSE)만 출력합니다. -
:판정 결과 바로 옆 셀에, 확신도(예: TRUE 0.952 = 약 95.2%)를 나란히 출력합니다. topN을 2, showConfidence를 TRUE로 설정한 경우, [1위 카테고리, 1위 확률, 2위 카테고리, 2위 확률]처럼 4열로 출력됩니다.
💡 Google 폼 연동에서 유용한 '자동 캐시' 메커니즘
스프레드시트의 커스텀 함수는 시트를 다시 열 때 등의 경우 재계산이 발생하는 사양이 있습니다. 따라서 이번 코드에서는 GAS의 CacheService를 이용하여,
프롬프트 + 입력 텍스트 + 선택지
해시 값(hash value)을 키로 사용하여 API 판정 결과를 자동으로 캐싱합니다(최대 6시간 저장). 이 덕분에 Google Forms에서 새로운 답변이 추가되어도 기존 답변 행은 캐시에서 즉시 결과가 반환되며, 새로 추가된 행에만 API 호출이 이루어지므로 API 할당량을 낭비하지 않습니다. 또한, 캐시에는 API의 원본 확률 데이터가 저장되므로, 나중에 topN
(출력 건수)이나 showConfidence
(확신도 유무)를 변경하더라도 API 통신 없이 순식간에 표시가 전환됩니다.
사전 준비 및 초기 실행 절차
1. Gemini API Key 가져오기
Google AI Studio에서 Gemini API Key를 발급받으세요.
API 키의 구체적인 발급 절차는 아래 기사 등을 참고해 주세요.
2. 스크립트 속성에 API 키 설정
3. 코드 붙여넣기 및 '초기 실행(권한 승인/연결 테스트)'
- 왼쪽 메뉴의 **'에디터'(**로 돌아가서, 처음부터 작성되어 있는
function myFunction() {}
아이콘)을 지우고, 다음 장의 GAS 코드 전문을 붙여넣습니다. - 또는 상단의 플로피 디스크 아이콘을 눌러 프로젝트를 저장합니다. Ctrl + S
(Mac은 Cmd + S)
- 【중요】초기 실행 및 권한 승인(연결 테스트):
화면 상단에서 실행할 함수를 선택하는 드롭다운(처음에는 GEMINI_DECIDE로 되어 있는 부분)을 클릭하고, 가장 아래에 있는 testConnection
'▶ 실행' 버튼을 누릅니다.
-
※직접 GEMINI_DECIDE를 선택하여 '실행'을 누르면 인수가 비어있기 때문에 오류가 발생합니다. 반드시 테스트용인 testConnection을 선택하여 실행해 주세요.
-
※직접-
-
초기 실행 시에는 **'승인이 필요합니다'**라는 팝업이 표시되므로, 다음 절차에 따라 허용합니다(자작 GAS에서 외부 API와 통신하는 데 필요한 최초의 절차입니다).
-
대화 상자의 **'권한 확인'**을 클릭 - 본인의 Google 계정을 선택 - '이 앱은 Google에서 확인되지 않았습니다'라는 화면이 나오면, 왼쪽 아래의 **'세부 정보'**를 클릭 - 가장 아래에 표시되는 **'제목 없는 프로젝트(안전하지 않은 페이지)로 이동'**을 클릭 - 내용을 확인하고 '허용' (또는 '계속')을 클릭
-
대화 상자의-
-
화면 하단의 '실행 로그'에 ✅ 연결 테스트 성공!
이라고 표시되면 준비 완료입니다! 스프레드시트로 돌아가 셀에 =GEMINI_DECIDE(...)
를 입력할 수 있게 됩니다.
구현: 복사/붙여넣기 가능한 GAS 코드 전문
Apps Script 에디터(코드.gs)에 다음 코드를 그대로 붙여넣고 저장해 주세요.
📝 보충 설명: 스프레드시트의 수식 도움말(JSDoc) 작성법
GAS 사용자 정의 함수에서는, 함수 바로 앞 주석에 @param {타입} 인수명 설명문
이라고 작성하면, 스프레드시트에서 수식을 입력할 때 한국어 설명 팝업을 표시할 수 있습니다.
다만, Google 스프레드시트의 사양상 생략 가능한 인수에 @param {string} [categories]
이나 [topN=1]처럼 대괄호 [ ]를 사용하면 인수명이 인식되지 않아 설명문이 사라지므로, 대괄호는 사용하지 않고 설명문 맨 앞에 【선택 가능】
이라고 기재했습니다.
여기서는 Google Forms에서 스프레드시트로 답변이 모이는 경우를 가정하여, =GEMINI_DECIDE()의 구체적인 사용법 4가지 패턴을 소개합니다.
예를 들어, 스프레드시트의 **B열에 "제목", C열에 "문의 내용"**이 입력되어 있다고 가정합니다.
| 행 | A열 (타임스탬프) | B열 (제목) | C열 (문의 내용) |
|---|
| 2 | 2026/11/18 10:00 | 로그인 불가 | 어제부터 결제 화면에서 오류가 발생하여 로그인이 불가능하고, 업무가 완전히 중단되었습니다. 즉시 확인 부탁드립니다. |
| 3 | 2026/11/18 10:15 | 플랜 변경 관련 | 다음 달부터 계약 플랜을 변경하고 싶은데, 절차 방법을 알려주세요. |
| 4 | 2026/11/18 10:30 | 다크 모드 지원 요청 | 관리 화면에 다크 모드가 있으면 좋겠습니다. 향후 업데이트 시 검토 부탁드립니다! |
TRUE / FALSE
판정 (요 대응 플래그)
패턴 ①: 선택지 생략 및 세 번째 인자(categories) 생략하기
세 번째 인자를 생략하면, Decisions API의 noul 유형이 자동으로 사용되어 프롬프트 조건에 부합하는지 여부를 TRUE 또는 FALSE로 반환합니다.
=GEMINI_DECIDE("클레임이나 즉시 답변이 필요한 내용인가?", B2:C4)
출력 결과 (세로 방향으로 스필):
-
2행目:
TRUE
-
3행目:
TRUE
-
4행目:
FALSE
또한, B2:C4처럼 여러 열을 한 번에 지정하면, 같은 행의 "제목"과 "문의 내용"을 자동으로 결합하여 (예: 로그인 불가 / 어제부터 결제 화면에서...) 판정해 줍니다.
패턴 ②: 함수 내에서 직접 카테고리를 지정하여 분류하기
세 번째 인자에 쉼표로 구분된 카테고리를 지정하면, 가장 확률이 높은 카테고리(1위)를 출력합니다.
=GEMINI_DECIDE("문의 카테고리를 분류해", B2:C4, "불량 보고, 계약/절차, 기능 요청, 기타")
출력 결과:
-
2행目:
불량 보고
-
3행目:
계약/절차
-
4행目:
기능 요청
💡 열 단위 지정도 가능합니다 (B2:C)
B2:C처럼 행 번호를 생략하고 전체 열을 지정해 두면, 빈 행은 API 호출 없이 건너뛰어지며, Google Forms에서 새로운 답변이 추가되는 순간 해당 행만 자동으로 판정됩니다.
패턴 ③: 별도의 시트의 "마스터 범위(2열)"를 참조하여 고정밀 긴급도 판단하기
긴급도(높음/중간/낮음)처럼, '무엇을 높다고 볼 것인가'에 대한 기준이 중요한 경우에는, 별도의 시트(예: 마스터 시트)에 "선택지명"과 "판정 기준 설명"의 2열을 준비하여 범위 지정하는 것이 권장됩니다.
마스터 시트 (A2:B4) 예시:
| A열 (긴급도) | B열 (판정 기준 설명) |
|---|
| 높음 | 시스템 정지, 결제 불가, 로그인 불가 등 사용자의 업무가 완전히 중단된 상태 |
| 중간 | 불량은 있으나 회피책이 있거나, 계약/청구 관련 일반적인 질문 |
| 낮음 | 향후 기능 요청, 감상평, 답변 불필요 알림 등 |
이 상태에서 다섯 번째 인자인 showConfidence를 TRUE로 설정하여 호출합니다.
=GEMINI_DECIDE("문의 긴급도를 판정해", B2:C4, 마스터!A2:B4, 1, TRUE)
출력 결과 (긴급도와 신뢰도가 가로 2열에 스필):
| 행 | D열 (긴급도) | E열 (신뢰도) |
|---|
| 2 | 높음 | 0.985 |
| 3 | 중간 | 0.912 |
| 4 | 낮음 | 0.991 |
2열의 범위를 전달하면, Decisions API의 criteria 파라미터에 {"높음": "시스템 정지...", "중간": "불량은 있으나..."}와 같은 형태로 기준 설명이 그대로 전달되므로, 단순 단어 지정보다 판정 정확도가 크게 향상됩니다.
패턴 ④: 여러 카테고리 후보(상위 N개)를 신뢰도와 함께 출력하기
'하나로 좁히기 어렵고, 여러 카테고리에 걸쳐 있는 문의'를 놓치고 싶지 않다면, 네 번째 인자인 topN에 2 등을 지정합니다.
=GEMINI_DECIDE("관련 카테고리를 선택해 주세요", B2:C2, "버그 보고, 결제/청구, 계정, 기능 요청", 2, TRUE)
출력 결과 (상위 2개 카테고리와 각각의 확률이 가로 4열에 스필(spill) 전개):
| 1위 카테고리 | 1위 확신도 | 2위 카테고리 | 2위 확신도 |
|---|
| 버그 보고 | 0.682 | 결제/청구 | 0.305 |
'1위의 확신도가 0.6 미만일 때는, 2위 카테고리도 확인한다'와 같은 조건부 서식이나 필터링을 스프레드시트 측에서 쉽게 구성할 수 있습니다.
운영 노하우: API 호출을 더욱 절약하기 위해
이번 =GEMINI_DECIDE() 함수에는 CacheService에 의한 6시간 캐시가 내장되어 있기 때문에, 작업 중에 시트를 새로고침하거나 Google Forms에서 연속적으로 답변이 들어와도 중복으로 API가 호출되지는 않습니다.
다만, GAS의 CacheService 사양상 최대 유지 기간은 6시간입니다. 수천 건의 답변이 쌓인 시트를 다음 날 이후에 여러 번 열어보면, 캐시가 만료된 행에 대해서는 재계산이 발생합니다.
따라서 장기간 운영할 경우에는 아래 중 하나의 방법을 도입하면 완벽하게 대상 행 1회 API 소비로 줄일 수 있습니다.
판단 완료된 과거 행은 '값만 붙여넣기'로 확정하기
월별 또는 주별로 이미 판단이 끝난 행을 선택하고, Ctrl + C → Ctrl + Shift + V (값만 붙여넣기)를 통해 수식을 텍스트/숫자로 변환해 버리는 방법입니다. 가장 간단하고 확실합니다.
- 폼 제출 시 트리거 (
onFormSubmit)와 결합하기
완전히 방치하여 영구 보존하고 싶다면, 본 기사의 함수를 그대로 GAS의 트리거에서 호출하고, sheet.getRange(...).setValues(...)로 셀에 값을 직접 작성하는 형태로 발전시키는 것도 추천합니다.
요약
- 스프레드시트 표준의
=AI() 함수는 유료 플랜이 필수이지만, Gemini Decisions API × GAS를 사용하면 무료 계정에서도 초저비용으로 도입할 수 있습니다.
- Decisions API (
gemini-decision-1)는 자연어를 생성하지 않는 대신 **출력 토큰이 항상 0(출력 과금 제로)**이며, 표기 오류가 없는 분류(choice)나 Yes/No 판정(noul)을 빠르게 수행할 수 있습니다.
- 사용자 정의 함수
=GEMINI_DECIDE()를 만들어 두면, 다중 열・다중 행의 일괄 판단, 별도 시트의 기준 마스터 참조, 상위 N개 출력, 확신도 표시, 캐시 저장까지 스프레드시트 위에서 자유자재로 다룰 수 있습니다.
설문조사 자동 분류나 문의사항 트리아지(긴급도 판정) 등, 스프레드시트상의 정형 판단 업무에 꼭 활용해 보세요!
Discussion