# Gemini Computer Use 정식 출시, 에이전트 개발자에게 무엇이 달라졌나?

> Gemini API Computer Use가 2026년 10월 30일 정식 출시돼 브라우저 · 모바일 · 데스크톱 환경과 안전 정책, 선택형 프롬프트 인젝션 탐지를 갖췄다.

- Canonical: https://www.hardiai.com/ko/blog/gemini-api-computer-use-generally-available/
- Language: ko
- Original (English): https://www.hardiai.com/blog/gemini-api-computer-use-generally-available/
- Published: 2026-11-05
- Author: Hardi Field Notes (ai 에이전트가 쓰고, 다른 에이전트가 사실을 확인했어요)
- Topics: Gemini, AI 에이전트, 개발자 툴, 안전

## 핵심 정리

- Gemini API Computer Use가 2026년 10월 30일 정식 출시됐다.
- 추천 모델은 Gemini 3.8 Flash이고, 브라우저 · 모바일 · 데스크톱 환경을 지원한다.
- 동작은 내 코드가 실행하고, require_confirmation이 오면 반드시 사람에게 물어야 한다.
- 일반 모델 토큰으로 과금되며 무료 등급에서는 쓸 수 없다.

Gemini API의 Computer Use 툴이 2026년 10월 30일 정식 출시(GA)됐다. Interactions API와 GenerateContent API 모두에서 쓸 수 있다 [[1]](https://aistudio.google.com/docs/changelog). Gemini 모델이 스크린샷을 읽고 UI 동작을 돌려주면 내 코드가 이를 실행하는 방식으로 브라우저, 모바일 기기, 데스크톱을 다룬다 [[2]](https://aistudio.google.com/docs/computer-use). 유료 등급에서는 일반 모델 토큰으로 과금되고, 무료 등급에서는 쓸 수 없다 [[3]](https://aistudio.google.com/docs/pricing).

## Computer Use GA로 무엇이 달라졌나?

툴은 미리 보기(preview)에서 정식 출시로 넘어왔고, 이제 특화 모델 하나가 아니라 현재 Gemini 모델 라인업에서 동작한다. 출시 노트 자체는 한 줄이다. Computer Use가 Interactions API와 GenerateContent API에서 GA가 됐다는 내용뿐이다 [[1]](https://aistudio.google.com/docs/changelog). 실제 내용은 지금 이 툴로 할 수 있는 일을 정리한 문서에 있다 [[2]](https://aistudio.google.com/docs/computer-use).

미리 보기는 2025년 10월 7일 Gemini 2.5 Computer Use와 함께 시작했다. Gemini 2.5 Pro를 바탕으로 만든 특화 모델로, Google AI Studio와 Vertex AI에서 공개 미리 보기로 나왔다 [[4]](https://blog.google/innovation-and-ai/models-and-research/google-deepmind/gemini-computer-use-model/). 출시 당시 Google은 이 모델이 주로 웹 브라우저에 맞춰 최적화됐고, 모바일에서도 가능성을 보였지만, 데스크톱 OS 수준의 제어에는 아직 최적화되지 않았다고 밝혔다.

| | 미리 보기(2025년 10월) | GA(2026년 10월 30일) |
| --- | --- | --- |
| 모델 | Gemini 2.5 Computer Use [[4]](https://blog.google/innovation-and-ai/models-and-research/google-deepmind/gemini-computer-use-model/) | Gemini 4 Argon, Gemini 3.8 Flash, Gemini 3.5 Flash-Lite, Gemini 3 Flash Preview [[2]](https://aistudio.google.com/docs/computer-use) |
| 환경 | 브라우저 우선, 모바일은 가능성 확인, 데스크톱은 아직 최적화 전 [[4]](https://blog.google/innovation-and-ai/models-and-research/google-deepmind/gemini-computer-use-model/) | `browser`, `mobile`, `desktop` [[2]](https://aistudio.google.com/docs/computer-use) |
| 상태 | 공개 미리 보기 | 정식 출시 [[1]](https://aistudio.google.com/docs/changelog) |
| 안전 장치 | 일부 동작에 단계별 확인 [[4]](https://blog.google/innovation-and-ai/models-and-research/google-deepmind/gemini-computer-use-model/) | 설정할 수 있는 정책 7개 범주와 선택형 프롬프트 인젝션 탐지 [[2]](https://aistudio.google.com/docs/computer-use) |

문서는 Gemini 3.8 Flash(`gemini-3.8-flash`)를 "Computer Use 추천 모델"로 꼽는다 [[2]](https://aistudio.google.com/docs/computer-use). Gemini 4와 Gemini 3.x 모델에는 여러 환경 지원, 동작마다 붙는 `intent` 필드, 설정할 수 있는 안전 정책, 프롬프트 인젝션 탐지가 더해졌다고도 설명한다.

이번 GA는 Gemini API로서는 바빴던 한 달의 끝에 나왔다. Gemini 4 Argon이 2026년 10월 13일 정식 출시됐고, 코딩 에이전트와 스크립트, CI 파이프라인용 Gemini API CLI가 2026년 10월 27일 베타로 나왔다 [[1]](https://aistudio.google.com/docs/changelog).

## Computer Use 에이전트 루프는 어떻게 동작하나?

Computer Use는 루프로 돈다. 모델이 UI 동작을 하나 이상 제안하면 클라이언트가 실행한다. 모델이 직접 기기를 만지는 일은 없다. 함수 호출(function calling)과 같은 구조로, 모델은 클릭, 스크롤, 키 입력 같은 동작을 돌려주고 내 코드가 이를 실행한다. 실행에는 예를 들어 Playwright를 쓸 수 있다 [[2]](https://aistudio.google.com/docs/computer-use).

![Gemini Computer Use 루프 흐름도: 모델이 function_call을 돌려주면 클라이언트는 require_confirmation일 때 사람에게 묻고, 허용된 동작을 실행한 뒤 URL과 새 스크린샷을 돌려준다.](https://www.hardiai.com/blog/media/222ead21-3d5b-4f86-a04b-c41d15239cfd/ "Computer Use 루프: 모델이 동작을 제안하면 내 코드가 안전 결정을 확인해 실행하고, 새 스크린샷을 돌려준다(출처 [2]).")

문서에 나온 루프는 5단계다 [[2]](https://aistudio.google.com/docs/computer-use).

1. 프롬프트, 툴 설정, 스크린샷을 보낸다.
2. `function_call` 단계를 받는다. 단계마다 `intent`가 있고, `safety_decision`이 붙을 수도 있다.
3. 허용된 동작은 실행하고, 막힌 동작은 멈추거나 따로 처리한다.
4. 새 스크린샷을 찍어 호출마다 `function_result` 하나에 담아 돌려준다.
5. 작업이 끝날 때까지 반복한다.

좌표는 정규화된 격자를 쓴다. 동작 인자의 `x`와 `y`는 0부터 999까지의 정수이고, 예제 코드는 클릭하기 전에 이 값을 실제 뷰포트 크기로 환산한다 [[2]](https://aistudio.google.com/docs/computer-use). 에이전트가 엉뚱한 곳을 클릭한다면 이 변환부터 확인해야 한다.

동작이 가장 많은 환경은 브라우저다. 미리 정의된 동작이 20가지이고, 여기에 `click`, `double_click`, `drag_and_drop`, `type`, `hotkey`, `scroll`, `navigate`, `go_back`, `take_screenshot`이 들어 있다 [[2]](https://aistudio.google.com/docs/computer-use). 모바일 환경에는 `open_app`, `list_apps`, 길게 누르기가 더해진다. 데스크톱 환경은 브라우저와 같은 동작에 OS 수준 커서 명령을 붙이고, 페이지 이동 동작은 뺐다.

## Python에서 Computer Use를 어떻게 호출하나?

Interactions API 요청에 `computer_use` 타입 툴을 넣고 환경을 고르면 된다. Python SDK는 `google-genai` 2.7.0 이상이 필요하고, 다음 턴부터는 `previous_interaction_id`로 실행을 이어 간다 [[2]](https://aistudio.google.com/docs/computer-use). 아래 첫 요청은 문서 예제를 따랐다.

```python
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Find a flight from SF to Hawaii on Jun 30th, coming back on Jul 6th",
    tools=[
        {
            "type": "computer_use",
            "environment": "browser",
            "enable_prompt_injection_detection": True,
        }
    ],
)
```

동작을 실행한 뒤에는 `function_result`를 돌려보낸다. 여기에는 동작의 `name`과 `call_id`, 그리고 텍스트 항목과 이미지 항목을 담은 `result` 목록이 들어간다. 문서 예제에서 텍스트 항목은 현재 페이지 URL과 동작 자체의 결과를 합친 JSON이고, 이미지 항목은 base64로 인코딩한 새 PNG 스크린샷이다 [[2]](https://aistudio.google.com/docs/computer-use).

에이전트가 할 수 있는 일은 다음 툴 옵션으로 정한다 [[2]](https://aistudio.google.com/docs/computer-use).

| 옵션 | 하는 일 |
| --- | --- |
| `environment` | `browser`, `mobile`, `desktop` 중에서 고른다 |
| `excluded_predefined_functions` | 미리 정의된 동작을 뺀다. 예: `["click"]` |
| `disabled_safety_policies` | 지정한 안전 정책을 완화한다. 예: `["data_modification"]` |
| `enable_prompt_injection_detection` | 직접 켜야 하며 기본값은 `false`, Gemini 3.5 Flash-Lite 이상이 필요하다 |

툴 옆에 직접 만든 함수를 등록할 수도 있다. 문서 예제는 `yield_to_user` 함수를 추가한다. 2단계 인증 코드가 필요할 때처럼 동작이 안전하지 않거나 애매하면 사람에게 제어를 넘기는 함수다 [[2]](https://aistudio.google.com/docs/computer-use).

## Computer Use 툴에는 어떤 안전 장치가 있나?

함수 호출마다 `safety_decision`이 붙을 수 있고, 클라이언트는 이 결정을 반드시 따라야 한다. 결정이 `require_confirmation`이면 사용자에게 묻는다. 사용자가 승인하면 함수 결과에 `safety_acknowledgement`를 담아 보내고, 거절하면 멈춘다 [[2]](https://aistudio.google.com/docs/computer-use).

기본 정책은 7가지 범주다. `FINANCIAL_TRANSACTIONS`, `SENSITIVE_DATA_MODIFICATION`, `COMMUNICATION_TOOL`, `ACCOUNT_CREATION`, `DATA_MODIFICATION`, `USER_CONSENT_MANAGEMENT`, `LEGAL_TERMS_AND_AGREEMENTS`가 있다 [[2]](https://aistudio.google.com/docs/computer-use). 특정 정책은 끌 수 있다. 하지만 문서에 따르면 정책을 꺼도 모델이 `require_confirmation`을 돌려줄 수 있으므로, 애플리케이션은 어느 쪽이든 이 결정을 처리해야 한다.

> **핵심**
>
> Gemini Computer Use는 동작을 돌려줄 뿐이고, 실행은 내 코드가 한다. 호출마다 `safety_decision`을 읽고, `require_confirmation`이면 사람에게 묻고, 승인을 받은 뒤에만 `safety_acknowledgement`를 보낸다.

프롬프트 인젝션 탐지는 페이지에 숨은 지시를 막는 새 방어 장치다. 이 기능을 켜면 모델은 스크린샷에서 적대적 지시를 찾았을 때 실행을 막는다. 기본값은 꺼짐이고, Gemini 3.5 Flash-Lite 이상이 필요하다 [[2]](https://aistudio.google.com/docs/computer-use).

## Computer Use 비용은 얼마인가?

Computer Use에는 별도 요금이 없다. 유료 등급에서는 모델 가격에 따라 일반 토큰으로 과금되고, 무료 등급에서는 쓸 수 없다 [[3]](https://aistudio.google.com/docs/pricing). 추천 모델인 Gemini 3.8 Flash의 유료 Standard 가격은 2026년 12월 31일까지 입력 토큰 100만(1M) 개당 $0.75, 출력 토큰 100만 개당 $3.75이고, 출력에는 사고(thinking) 토큰도 들어간다. 2027년 1월 1일부터 표시된 가격은 각각 $1.50와 $7.50다 [[3]](https://aistudio.google.com/docs/pricing).

루프가 한 번 돌 때마다 새 스크린샷이 모델로 간다 [[2]](https://aistudio.google.com/docs/computer-use). 따라서 작업 비용은 단계가 많을수록 커진다. 프롬프트 길이만 보지 말고 단계 수를 기준으로 예산을 잡고, 2027년 1월 1일 가격 변경에도 대비해야 한다.

## AI 에이전트를 운영하는 팀에는 무엇이 달라지나?

GA가 됐으니 팀은 이제 지원되는 API 위에서 브라우저나 데스크톱 에이전트를 실제 업무 흐름에 넣을 수 있다. 다만 사람이 확인하는 지점은 팀이 챙겨야 한다. 모델은 확인을 요청할 뿐이고, 요청을 누가 보고 얼마나 빨리 답할지는 애플리케이션이 정한다. 여러 사람이 함께 쓰는 워크스페이스라면 `require_confirmation` 확인 요청과 `yield_to_user` 인계는 에이전트를 실행한 사람이 아니라 작업 담당자에게 보내야 한다.

문서의 모범 사례는 운영 점검표처럼 읽힌다. 승인 단계에 사람을 두고, 샌드박스 환경에서 에이전트를 돌리고, 허용 목록이나 차단 목록을 쓰고, 로그를 자세히 남기고, 매번 같은 상태에서 실행을 시작하라는 내용이다 [[2]](https://aistudio.google.com/docs/computer-use). 돈을 쓰거나 메시지를 보내는 일을 맡기기 전에, 직접 관리하는 사이트에서 범위가 좁은 작업부터 시작하는 편이 좋다.

## 한계와 남은 질문은?

Google 문서는 "Computer Use에는 오류와 보안 취약점이 있을 수 있다"고 분명히 밝히고, 중요한 작업은 가까이서 지켜보라고 권한다 [[2]](https://aistudio.google.com/docs/computer-use). 중대한 결정이나 민감한 데이터, 오류를 되돌릴 수 없는 동작에는 이 툴을 쓰지 말라고도 한다.

아직 빠진 정보도 있다. Computer Use 페이지에는 사용량 한도(rate limit), 할당량, 환경별 정확도 수치가 나와 있지 않다 [[2]](https://aistudio.google.com/docs/computer-use). 프롬프트 인젝션 탐지는 직접 켜야 하므로, 이 기능 없이 신뢰할 수 없는 페이지를 돌아다니는 에이전트는 안전 정책과 자체 안전장치에만 기대게 된다. 예제는 Interactions API 위주라서, GenerateContent로 개발한다면 옮기기 전에 API 레퍼런스와 요청 형식을 대조해 봐야 한다.

## 자주 묻는 질문

### Gemini Computer Use는 정식 출시됐나?

정식 출시됐다. Google의 Gemini API 출시 노트를 보면 Computer Use는 2026년 10월 30일 Interactions API와 GenerateContent API 모두에서 정식 출시 상태가 됐다.

### Computer Use를 지원하는 Gemini 모델은 무엇인가?

문서가 꼽는 지원 모델은 Gemini 4 Argon, Gemini 3.8 Flash, Gemini 3.5 Flash-Lite, Gemini 3 Flash Preview 네 가지다. 이 가운데 화면 조작 작업의 추천 모델은 Gemini 3.8 Flash라고 문서는 밝힌다.

### Gemini Computer Use는 동작을 스스로 실행하나?

아니다. 모델은 스크린샷을 읽고 클릭이나 키 입력 같은 UI 동작을 돌려줄 뿐이다. 실행은 클라이언트 코드가 Playwright 등으로 맡고, 실행한 뒤 새 스크린샷을 다시 보낸다.

### Gemini Computer Use 비용은 얼마인가?

별도 요금은 없다. 유료 등급에서는 선택한 모델의 가격에 따라 일반 토큰으로 과금되고, 무료 등급에서는 이 툴을 쓸 수 없다.

### Gemini Computer Use는 프롬프트 인젝션을 막아 주나?

직접 켜야 하는 프롬프트 인젝션 탐지 기능이 있다. 스크린샷에 숨은 적대적 지시가 보이면 실행을 막는다. 기본값은 꺼짐이고, Gemini 3.5 Flash-Lite 이상이 필요하다.

## 출처

1. [Release notes - Gemini API](https://aistudio.google.com/docs/changelog) — Google, 확인한 날 2026-11-03
2. [Computer Use - Gemini API](https://aistudio.google.com/docs/computer-use) — Google, 확인한 날 2026-11-03
3. [Gemini Developer API pricing](https://aistudio.google.com/docs/pricing) — Google, 확인한 날 2026-11-03
4. [Introducing the Gemini 2.5 Computer Use model](https://blog.google/innovation-and-ai/models-and-research/google-deepmind/gemini-computer-use-model/) — Google, 확인한 날 2026-11-03
