Gemini Deep Research를 이제 공동 계획, 시각화, MCP 지원 등과 함께 미리보기로 이용할 수 있습니다.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Gemini API

Gemini Interactions API는 개발자가 Gemini 모델을 사용하여 생성형 AI 애플리케이션을 빌드할 수 있는 실험용 API입니다. Gemini는 처음부터 멀티모달로 설계된 Google의 가장 강력한 모델입니다. 언어, 이미지, 오디오, 동영상, 코드 등 다양한 유형의 정보를 일반화하고 원활하게 이해, 운영, 결합할 수 있습니다. 텍스트와 이미지 간 추론, 콘텐츠 생성, 대화 에이전트, 요약 및 분류 시스템 등의 사용 사례에 Gemini API를 사용할 수 있습니다.

마크다운으로 보기 OpenAPI 사양 보기

CreateWebhook

post https://generativelanguage.googleapis.com/v1beta/webhooks

새 웹훅을 만듭니다.

요청 본문
응답

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

name string (선택사항)

선택사항입니다. 사용자가 제공한 웹훅 이름입니다.

uri string (필수)

필수 항목입니다. 웹훅 이벤트가 전송될 URI입니다.

subscribed_events array (object or string) (필수)

필수 항목입니다. 웹훅이 구독하는 이벤트입니다. 사용 가능한 이벤트: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

응답

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

name string (선택사항)

선택사항입니다. 사용자가 제공한 웹훅 이름입니다.

uri string (선택사항)

필수 항목입니다. 웹훅 이벤트가 전송될 URI입니다.

subscribed_events 배열 (객체 또는 문자열) (선택사항)

create_time string (선택사항)

출력 전용입니다. 웹훅이 생성된 타임스탬프입니다.

update_time string (선택사항)

출력 전용입니다. 웹훅이 마지막으로 업데이트된 타임스탬프입니다.

signing_secrets SigningSecret (선택사항)

출력 전용입니다. 이 웹훅과 연결된 서명 보안 비밀입니다.

필드

truncated_secret string (선택사항)

출력 전용입니다. 서명 보안 비밀의 잘린 버전입니다.

expire_time string (선택사항)

출력 전용입니다. 서명 보안 비밀의 만료일입니다.

state enum (string) (선택사항)

출력 전용입니다. 웹훅의 상태입니다.

가능한 값은 다음과 같습니다.

enabled
disabled
disabled_due_to_failed_deliveries

new_signing_secret string (선택사항)

출력 전용입니다. 웹훅의 새 서명 보안 비밀입니다. 생성 시에만 채워집니다.

id 문자열 (선택사항)

출력 전용입니다. 웹훅의 ID입니다.

예

응답 예시

{
  "name": "string",
  "uri": "string",
  "subscribed_events": [
    "string"
  ],
  "create_time": "string",
  "update_time": "string",
  "signing_secrets": [
    {
      "truncated_secret": "string",
      "expire_time": "string"
    }
  ],
  "state": "enabled",
  "new_signing_secret": "string",
  "id": "string"
}

ListWebhooks

get https://generativelanguage.googleapis.com/v1beta/webhooks

모든 웹훅을 나열합니다.

경로 / 쿼리 매개변수
응답

경로 / 쿼리 매개변수

page_size integer (선택사항)

선택사항입니다. 반환할 최대 웹훅 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 웹훅이 반환됩니다. 최댓값은 1,000입니다.

page_token string (선택사항)

선택사항입니다. 이전 `ListWebhooks` 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

응답

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

웹훅 배열 (Webhook) (선택사항)

웹훅입니다.

next_page_token string (선택사항)

다음 페이지를 가져오기 위해 `page_token` 으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

예

응답 예시

{
  "webhooks": [
    {
      "name": "string",
      "uri": "string",
      "subscribed_events": [
        "string"
      ],
      "create_time": "string",
      "update_time": "string",
      "signing_secrets": [
        {
          "truncated_secret": "string",
          "expire_time": "string"
        }
      ],
      "state": "enabled",
      "new_signing_secret": "string",
      "id": "string"
    }
  ],
  "next_page_token": "string"
}

GetWebhook

get https://generativelanguage.googleapis.com/v1beta/webhooks/{id}

특정 웹훅을 가져옵니다.

경로 / 쿼리 매개변수
응답

경로 / 쿼리 매개변수

id 문자열 (필수)

필수 항목입니다. 가져올 웹훅의 ID입니다.

응답

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

name string (선택사항)

선택사항입니다. 사용자가 제공한 웹훅 이름입니다.

uri string (선택사항)

필수 항목입니다. 웹훅 이벤트가 전송될 URI입니다.

subscribed_events 배열 (객체 또는 문자열) (선택사항)

create_time string (선택사항)

출력 전용입니다. 웹훅이 생성된 타임스탬프입니다.

update_time string (선택사항)

출력 전용입니다. 웹훅이 마지막으로 업데이트된 타임스탬프입니다.

signing_secrets SigningSecret (선택사항)

출력 전용입니다. 이 웹훅과 연결된 서명 보안 비밀입니다.

필드

truncated_secret string (선택사항)

출력 전용입니다. 서명 보안 비밀의 잘린 버전입니다.

expire_time string (선택사항)

출력 전용입니다. 서명 보안 비밀의 만료일입니다.

state enum (string) (선택사항)

출력 전용입니다. 웹훅의 상태입니다.

가능한 값은 다음과 같습니다.

enabled
disabled
disabled_due_to_failed_deliveries

new_signing_secret string (선택사항)

출력 전용입니다. 웹훅의 새 서명 보안 비밀입니다. 생성 시에만 채워집니다.

id 문자열 (선택사항)

출력 전용입니다. 웹훅의 ID입니다.

예

응답 예시

{
  "name": "string",
  "uri": "string",
  "subscribed_events": [
    "string"
  ],
  "create_time": "string",
  "update_time": "string",
  "signing_secrets": [
    {
      "truncated_secret": "string",
      "expire_time": "string"
    }
  ],
  "state": "enabled",
  "new_signing_secret": "string",
  "id": "string"
}

UpdateWebhook

patch https://generativelanguage.googleapis.com/v1beta/webhooks/{id}

기존 웹훅을 업데이트합니다.

경로 / 쿼리 매개변수
요청 본문
응답

경로 / 쿼리 매개변수

id 문자열 (필수)

필수 항목입니다. 업데이트할 웹훅의 ID입니다.

update_mask string (선택사항)

선택사항입니다. 업데이트할 필드 목록입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

name string (선택사항)

선택사항입니다. 사용자가 제공한 웹훅 이름입니다.

uri string (선택사항)

선택사항입니다. 웹훅 이벤트가 전송될 URI입니다.

subscribed_events 배열 (객체 또는 문자열) (선택사항)

선택사항입니다. 웹훅이 구독하는 이벤트입니다. 사용 가능한 이벤트: - batch.succeeded - batch.expired - batch.failed - interaction.requires_action - interaction.completed - interaction.failed - video.generated

state enum (string) (선택사항)

선택사항입니다. 웹훅의 상태입니다.

가능한 값은 다음과 같습니다.

enabled
disabled
disabled_due_to_failed_deliveries

응답

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

name string (선택사항)

선택사항입니다. 사용자가 제공한 웹훅 이름입니다.

uri string (선택사항)

필수 항목입니다. 웹훅 이벤트가 전송될 URI입니다.

subscribed_events 배열 (객체 또는 문자열) (선택사항)

create_time string (선택사항)

출력 전용입니다. 웹훅이 생성된 타임스탬프입니다.

update_time string (선택사항)

출력 전용입니다. 웹훅이 마지막으로 업데이트된 타임스탬프입니다.

signing_secrets SigningSecret (선택사항)

출력 전용입니다. 이 웹훅과 연결된 서명 보안 비밀입니다.

필드

truncated_secret string (선택사항)

출력 전용입니다. 서명 보안 비밀의 잘린 버전입니다.

expire_time string (선택사항)

출력 전용입니다. 서명 보안 비밀의 만료일입니다.

state enum (string) (선택사항)

출력 전용입니다. 웹훅의 상태입니다.

가능한 값은 다음과 같습니다.

enabled
disabled
disabled_due_to_failed_deliveries

new_signing_secret string (선택사항)

출력 전용입니다. 웹훅의 새 서명 보안 비밀입니다. 생성 시에만 채워집니다.

id 문자열 (선택사항)

출력 전용입니다. 웹훅의 ID입니다.

예

응답 예시

{
  "name": "string",
  "uri": "string",
  "subscribed_events": [
    "string"
  ],
  "create_time": "string",
  "update_time": "string",
  "signing_secrets": [
    {
      "truncated_secret": "string",
      "expire_time": "string"
    }
  ],
  "state": "enabled",
  "new_signing_secret": "string",
  "id": "string"
}

DeleteWebhook

delete https://generativelanguage.googleapis.com/v1beta/webhooks/{id}

웹훅을 삭제합니다.

경로 / 쿼리 매개변수
응답

경로 / 쿼리 매개변수

id 문자열 (필수)

필수 항목입니다. 삭제할 웹훅의 ID입니다. 형식: `{webhook_id}`

응답

성공한 경우 응답은 비어 있습니다.

예

RotateSigningSecret

post https://generativelanguage.googleapis.com/v1beta/webhooks/{id}:rotateSigningSecret

웹훅의 새 서명 보안 비밀을 생성합니다.

경로 / 쿼리 매개변수
요청 본문
응답

경로 / 쿼리 매개변수

id 문자열 (필수)

필수 항목입니다. 서명 보안 비밀을 생성할 웹훅의 ID입니다. 형식: `{webhook_id}`

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

revocation_behavior enum (string) (선택사항)

선택사항입니다. 이전 서명 보안 비밀의 취소 동작입니다.

가능한 값은 다음과 같습니다.

revoke_previous_secrets_after_h24
revoke_previous_secrets_immediately

응답

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

secret string (선택사항)

출력 전용입니다. 새로 생성된 서명 보안 비밀입니다.

예

응답 예시

{
  "secret": "string"
}

PingWebhook

post https://generativelanguage.googleapis.com/v1beta/webhooks/{id}:ping

웹훅에 핑 이벤트를 전송합니다.

경로 / 쿼리 매개변수
요청 본문
응답

경로 / 쿼리 매개변수

id 문자열 (필수)

필수 항목입니다. ping할 웹훅의 ID입니다. 형식: `{webhook_id}`

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

응답

성공한 경우 응답은 비어 있습니다.

예

리소스

웹훅

웹훅 리소스입니다.

필드

name string (선택사항)

선택사항입니다. 사용자가 제공한 웹훅 이름입니다.

uri string (선택사항)

필수 항목입니다. 웹훅 이벤트가 전송될 URI입니다.

subscribed_events 배열 (객체 또는 문자열) (선택사항)

create_time string (선택사항)

출력 전용입니다. 웹훅이 생성된 타임스탬프입니다.

update_time string (선택사항)

출력 전용입니다. 웹훅이 마지막으로 업데이트된 타임스탬프입니다.

signing_secrets SigningSecret (선택사항)

출력 전용입니다. 이 웹훅과 연결된 서명 보안 비밀입니다.

필드

truncated_secret string (선택사항)

출력 전용입니다. 서명 보안 비밀의 잘린 버전입니다.

expire_time string (선택사항)

출력 전용입니다. 서명 보안 비밀의 만료일입니다.

state enum (string) (선택사항)

출력 전용입니다. 웹훅의 상태입니다.

가능한 값은 다음과 같습니다.

enabled
disabled
disabled_due_to_failed_deliveries

new_signing_secret string (선택사항)

출력 전용입니다. 웹훅의 새 서명 보안 비밀입니다. 생성 시에만 채워집니다.

id 문자열 (선택사항)

출력 전용입니다. 웹훅의 ID입니다.

데이터 모델

InteractionSseEvent

가능한 유형

다형성 판별자: event_type

InteractionCreatedEvent

event_type object (필수)

제공된 설명이 없습니다.

항상 "interaction.created"로 설정합니다.

interaction Interaction (필수)

제공된 설명이 없습니다.

필드

model ModelOption (선택사항)

상호작용을 생성하는 데 사용된 `Model` 의 이름입니다.

가능한 값은 다음과 같습니다.

gemini-2.5-computer-use-preview-10-2025
직접 인터페이스 상호작용을 위해 설계된 에이전트형 기능 모델로, Gemini가 디지털 환경을 인식하고 탐색할 수 있습니다.
gemini-2.5-flash
100만 개의 토큰 컨텍스트 윈도우를 지원하고 사고 예산이 있는 Google의 첫 번째 하이브리드 추론 모델입니다.
gemini-2.5-flash-image
속도, 유연성, 맥락 이해에 최적화된 Google의 네이티브 이미지 생성 모델입니다. 텍스트 입력 및 출력은 2.5 Flash와 동일한 가격으로 책정됩니다.
gemini-2.5-flash-lite
대규모 사용을 위해 빌드된 가장 작고 비용 효율적인 모델입니다.
gemini-2.5-flash-lite-preview-09-2025
비용 효율성, 높은 처리량, 고품질에 최적화된 Gemini 2.5 Flash Lite 기반의 최신 모델입니다.
gemini-2.5-flash-native-audio-preview-12-2025
Google의 네이티브 오디오 모델은 더 나은 속도, 자연스러운 음성, 세부정보 수준, 분위기를 통해 고품질 오디오 출력을 제공하도록 최적화되어 있습니다.
gemini-2.5-flash-preview-09-2025
2.5 Flash 모델을 기반으로 하는 최신 모델입니다. 2.5 Flash Preview는 대규모 처리, 짧은 지연 시간, 사고력이 필요한 대량 작업, 에이전트형 사용 사례에 가장 적합합니다.
gemini-2.5-flash-preview-tts
강력하고 짧은 지연 시간의 제어 가능한 음성 생성에 최적화된 2.5 Flash Text-to-Speech 모델입니다.
gemini-2.5-pro
코딩 및 복잡한 추론 작업에 탁월한 성능을 보이는 최첨단 다목적 모델입니다.
gemini-2.5-pro-preview-tts
더 자연스러운 출력과 프롬프트의 쉬운 조정을 위해 강력하고 짧은 지연 시간의 음성 생성을 위해 최적화된 2.5 Pro Text-to-Speech 오디오 모델입니다.
gemini-3-flash-preview
최첨단 인텔리전스와 뛰어난 검색 및 그라운딩을 결합하여 속도에 중점을 두고 설계된 가장 지능적인 모델입니다.
gemini-3-pro-image-preview
최첨단 이미지 생성 및 편집 모델입니다.
gemini-3-pro-preview
최고 수준의 추론 및 멀티모달 이해와 강력한 에이전트형 및 바이브 코딩 기능을 갖춘 가장 지능적인 모델입니다.
gemini-3.1-pro-preview
전례 없는 깊이와 미묘한 차이를 갖춘 최신 SOTA 추론 모델로, 강력한 멀티모달 이해 및 코딩 기능을 제공합니다.
gemini-3.1-flash-image-preview
Flash 속도의 효율성과 현실에 기반한 생성 기능을 갖춘 Pro 수준의 시각적 인텔리전스
gemini-3.1-flash-lite-preview
대용량 에이전트형 작업, 번역, 간단한 데이터 처리에 최적화된 가장 비용 효율적인 모델입니다.
gemini-3.1-flash-tts-preview
Gemini 3.1 Flash TTS: 강력하고 지연 시간이 짧은 음성 생성 자연스러운 출력, 조종 가능한 프롬프트, 정확한 내레이션 제어를 위한 새로운 표현력 있는 오디오 태그를 사용해 보세요.
lyria-3-clip-preview
충실도 높은 오디오 클립과 정확한 리듬 제어에 최적화된 지연 시간이 짧은 음악 생성 모델입니다.
lyria-3-pro-preview
다양한 음악 스타일에서 정확한 구조 제어와 복잡한 전환에 최적화된 심층적인 작곡 이해를 갖춘 고급 전곡 생성 모델입니다.

agent AgentOption (선택사항)

상호작용을 생성하는 데 사용된 `Agent` 의 이름입니다.

가능한 값은 다음과 같습니다.

deep-research-pro-preview-12-2025
Gemini Deep Research 에이전트
deep-research-preview-04-2026
Gemini Deep Research 에이전트
deep-research-max-preview-04-2026
Gemini Deep Research Max 에이전트

id 문자열 (선택사항)

필수 항목입니다. 출력 전용입니다. 상호작용 완료의 고유 식별자입니다.

status enum (string) (선택사항)

필수 항목입니다. 출력 전용입니다. 상호작용의 상태입니다.

가능한 값은 다음과 같습니다.

in_progress
requires_action
completed
failed
cancelled
incomplete

created string (선택사항)

필수 항목입니다. 출력 전용입니다. 대답이 생성된 시간입니다(ISO 8601 형식(YYYY-MM-DDThh:mm:ssZ)).

updated string (선택사항)

필수 항목입니다. 출력 전용입니다. ISO 8601 형식(YYYY-MM-DDThh:mm:ssZ)으로 대답이 마지막으로 업데이트된 시간입니다.

role string (선택사항)

출력 전용입니다. 상호작용의 역할입니다.

system_instruction string (선택사항)

상호작용을 위한 시스템 요청 사항입니다.

도구 도구 (선택사항)

모델이 상호작용 중에 호출할 수 있는 도구 선언 목록입니다.

가능한 유형

다형성 판별자: type

기능

모델에서 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "function"로 설정합니다.

name string (선택사항)

함수 이름입니다.

설명 문자열 (선택사항)

함수에 대한 설명입니다.

parameters object (선택사항)

함수 파라미터의 JSON 스키마입니다.

CodeExecution

모델이 코드를 실행하는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "code_execution"로 설정합니다.

UrlContext

모델이 URL 컨텍스트를 가져오는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_context"로 설정합니다.

ComputerUse

모델이 컴퓨터와 상호작용하는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "computer_use"로 설정합니다.

environment enum (string) (선택사항)

운영되는 환경입니다.

가능한 값은 다음과 같습니다.

browser

excluded_predefined_functions array (string) (선택사항)

모델 호출에서 제외되는 사전 정의된 함수의 목록입니다.

McpServer

MCPServer는 모델이 작업을 실행하기 위해 호출할 수 있는 서버입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "mcp_server"로 설정합니다.

name string (선택사항)

MCPServer의 이름입니다.

url string (선택사항)

MCPServer 엔드포인트의 전체 URL입니다. 예: 'https://api.example.com/mcp'

headers object (선택사항)

선택사항: 필요한 경우 인증 헤더, 제한 시간 등의 필드

allowed_tools AllowedTools (선택사항)

허용된 도구입니다.

필드

mode ToolChoiceType (선택사항)

도구 선택 모드입니다.

가능한 값은 다음과 같습니다.

auto
any
none
validated

tools array (string) (선택사항)

허용된 도구의 이름입니다.

GoogleSearch

모델이 Google을 검색하는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_search"로 설정합니다.

search_types array (enum (string)) (선택사항)

사용 설정할 검색 그라운딩 유형입니다.

가능한 값은 다음과 같습니다.

web_search
image_search
enterprise_web_search

FileSearch

모델이 파일을 검색하는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_search"로 설정합니다.

file_search_store_names array (string) (선택사항)

검색할 파일 검색 저장소 이름입니다.

top_k integer (선택사항)

가져올 시맨틱 검색 청크의 수입니다.

metadata_filter string (선택사항)

시맨틱 검색 문서 및 청크에 적용할 메타데이터 필터입니다.

GoogleMaps

모델이 Google 지도를 호출하는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_maps"로 설정합니다.

enable_widget boolean (선택사항)

응답의 도구 호출 결과에 위젯 컨텍스트 토큰을 반환할지 여부입니다.

latitude number (선택사항)

사용자 위치의 위도입니다.

longitude number (선택사항)

사용자 위치의 경도입니다.

가져오기

모델이 파일을 검색하는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "retrieval"로 설정합니다.

retrieval_types array (enum (string)) (선택사항)

사용 설정할 파일 검색 유형입니다.

가능한 값은 다음과 같습니다.

vertex_ai_search

vertex_ai_search_config VertexAISearchConfig (선택사항)

VertexAISearch의 구성을 지정하는 데 사용됩니다.

필드

엔진 문자열 (선택사항)

선택사항입니다. Vertex AI Search 엔진을 지정하는 데 사용됩니다.

datastores array (string) (선택사항)

선택사항입니다. Vertex AI Search 데이터 스토어를 지정하는 데 사용됩니다.

usage Usage (선택사항)

출력 전용입니다. 상호작용 요청의 토큰 사용량에 관한 통계입니다.

필드

total_input_tokens integer (선택사항)

프롬프트 (컨텍스트)의 토큰 수입니다.

input_tokens_by_modality ModalityTokens (선택사항)

모달리티별 입력 토큰 사용량 분석입니다.

필드

modality ResponseModality (선택사항)

토큰 수와 연결된 모달리티입니다.

가능한 값은 다음과 같습니다.

text
image
audio
video
document

토큰 정수 (선택사항)

모달리티의 토큰 수입니다.

total_cached_tokens integer (선택사항)

프롬프트의 캐시된 부분 (캐시된 콘텐츠)에 있는 토큰 수입니다.

cached_tokens_by_modality ModalityTokens (선택사항)

모달리티별 캐시된 토큰 사용량 분석입니다.

필드

modality ResponseModality (선택사항)

토큰 수와 연결된 모달리티입니다.

가능한 값은 다음과 같습니다.

text
image
audio
video
document

토큰 정수 (선택사항)

모달리티의 토큰 수입니다.

total_output_tokens integer (선택사항)

생성된 모든 대답의 총 토큰 수입니다.

output_tokens_by_modality ModalityTokens (선택사항)

모달리티별 출력 토큰 사용량 분석입니다.

필드

modality ResponseModality (선택사항)

토큰 수와 연결된 모달리티입니다.

가능한 값은 다음과 같습니다.

text
image
audio
video
document

토큰 정수 (선택사항)

모달리티의 토큰 수입니다.

total_tool_use_tokens integer (optional)

도구 사용 프롬프트에 있는 토큰 수입니다.

tool_use_tokens_by_modality ModalityTokens (선택사항)

모달리티별 도구 사용 토큰 사용량 분석

필드

modality ResponseModality (선택사항)

토큰 수와 연결된 모달리티입니다.

가능한 값은 다음과 같습니다.

text
image
audio
video
document

토큰 정수 (선택사항)

모달리티의 토큰 수입니다.

total_thought_tokens integer (선택사항)

사고 모델의 사고 토큰 수입니다.

total_tokens integer (선택사항)

상호작용 요청의 총 토큰 수 (프롬프트 + 응답 + 기타 내부 토큰)입니다.

grounding_tool_count GroundingToolCount (선택사항)

그라운딩 도구 수입니다.

필드

type enum (string) (선택사항)

개수와 연결된 그라운딩 도구 유형입니다.

가능한 값은 다음과 같습니다.

google_search
google_maps
retrieval

count integer (선택사항)

그라운딩 도구 수입니다.

response_modalities ResponseModality (선택사항)

요청된 대답의 형식 (TEXT, IMAGE, AUDIO)입니다.

가능한 값은 다음과 같습니다.

text
image
audio
video
document

response_mime_type string (선택사항)

대답의 MIME 유형입니다. response_format이 설정된 경우 필수입니다.

previous_interaction_id string (선택사항)

이전 상호작용의 ID입니다(있는 경우).

service_tier ServiceTier (선택사항)

상호작용의 서비스 등급입니다.

가능한 값은 다음과 같습니다.

flex
standard
priority

webhook_config WebhookConfig (선택사항)

선택사항입니다. 상호작용이 완료될 때 알림을 수신하기 위한 웹훅 구성입니다.

필드

uris array (string) (선택사항)

선택사항입니다. 설정된 경우 등록된 웹훅 대신 웹훅 이벤트에 이러한 웹훅 URI가 사용됩니다.

user_metadata object (선택사항)

선택사항입니다. 각 이벤트가 웹훅에 전송될 때 반환되는 사용자 메타데이터입니다.

steps Step (선택사항)

출력 전용입니다. 상호작용을 구성하는 단계입니다.

가능한 유형

다형성 판별자: type

UserInputStep

사용자가 제공한 입력입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "user_input"로 설정합니다.

content Content (선택사항)

제공된 설명이 없습니다.

가능한 유형

다형성 판별자: type

TextContent

텍스트 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "text"로 설정합니다.

text string (필수)

필수 항목입니다. 텍스트 콘텐츠입니다.

annotations Annotation (선택사항)

모델 생성 콘텐츠의 인용 정보입니다.

가능한 유형

다형성 판별자: type

UrlCitation

URL 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_citation"로 설정합니다.

url string (선택사항)

URL입니다.

title string (선택사항)

URL의 제목입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

FileCitation

파일 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_citation"로 설정합니다.

document_uri 문자열 (선택사항)

파일의 URI입니다.

file_name string (선택사항)

파일 이름입니다.

source string (선택사항)

텍스트의 일부에 기여도가 부여된 출처입니다.

custom_metadata object (선택사항)

사용자가 가져온 컨텍스트에 관한 메타데이터를 제공했습니다.

page_number integer (선택사항)

인용된 문서의 페이지 번호(해당하는 경우)

media_id string (선택사항)

이미지 인용의 경우 미디어 ID입니다(해당하는 경우).

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

PlaceCitation

장소 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "place_citation"로 설정합니다.

place_id string (선택사항)

장소의 ID입니다(`places/{place_id}` 형식).

name string (선택사항)

장소의 이름입니다.

url string (선택사항)

장소의 URI 참조입니다.

review_snippets ReviewSnippet (선택사항)

Google 지도에서 특정 장소의 기능에 관한 답변을 생성하는 데 사용되는 리뷰 스니펫입니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

ImageContent

이미지 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "image"로 설정합니다.

data string (선택사항)

이미지 콘텐츠입니다.

uri string (선택사항)

이미지의 URI입니다.

mime_type enum (string) (선택사항)

이미지의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

image/png
image/jpeg
image/webp
image/heic
image/heif
image/gif
image/bmp
image/tiff

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

AudioContent

오디오 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "audio"로 설정합니다.

data string (선택사항)

오디오 콘텐츠입니다.

uri string (선택사항)

오디오의 URI입니다.

mime_type enum (string) (선택사항)

오디오의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

audio/wav
audio/mp3
audio/aiff
audio/aac
audio/ogg
audio/flac
audio/mpeg
audio/m4a
audio/l16
audio/opus
audio/alaw
audio/mulaw

channels integer (선택사항)

오디오 채널 수입니다.

sample_rate integer (선택사항)

오디오의 샘플링 레이트입니다.

DocumentContent

문서 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "document"로 설정합니다.

data string (선택사항)

문서 콘텐츠입니다.

uri string (선택사항)

문서 URI입니다.

mime_type enum (string) (선택사항)

문서의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

application/pdf

VideoContent

동영상 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "video"로 설정합니다.

data string (선택사항)

동영상 콘텐츠입니다.

uri string (선택사항)

동영상의 URI입니다.

mime_type enum (string) (선택사항)

동영상의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

video/mp4
video/mpeg
video/mpg
video/mov
video/avi
video/x-flv
video/webm
video/wmv
video/3gpp

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

ModelOutputStep

모델에서 생성된 출력입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "model_output"로 설정합니다.

content Content (선택사항)

제공된 설명이 없습니다.

가능한 유형

다형성 판별자: type

TextContent

텍스트 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "text"로 설정합니다.

text string (필수)

필수 항목입니다. 텍스트 콘텐츠입니다.

annotations Annotation (선택사항)

모델 생성 콘텐츠의 인용 정보입니다.

가능한 유형

다형성 판별자: type

UrlCitation

URL 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_citation"로 설정합니다.

url string (선택사항)

URL입니다.

title string (선택사항)

URL의 제목입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

FileCitation

파일 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_citation"로 설정합니다.

document_uri 문자열 (선택사항)

파일의 URI입니다.

file_name string (선택사항)

파일 이름입니다.

source string (선택사항)

텍스트의 일부에 기여도가 부여된 출처입니다.

custom_metadata object (선택사항)

사용자가 가져온 컨텍스트에 관한 메타데이터를 제공했습니다.

page_number integer (선택사항)

인용된 문서의 페이지 번호(해당하는 경우)

media_id string (선택사항)

이미지 인용의 경우 미디어 ID입니다(해당하는 경우).

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

PlaceCitation

장소 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "place_citation"로 설정합니다.

place_id string (선택사항)

장소의 ID입니다(`places/{place_id}` 형식).

name string (선택사항)

장소의 이름입니다.

url string (선택사항)

장소의 URI 참조입니다.

review_snippets ReviewSnippet (선택사항)

Google 지도에서 특정 장소의 기능에 관한 답변을 생성하는 데 사용되는 리뷰 스니펫입니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

ImageContent

이미지 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "image"로 설정합니다.

data string (선택사항)

이미지 콘텐츠입니다.

uri string (선택사항)

이미지의 URI입니다.

mime_type enum (string) (선택사항)

이미지의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

image/png
image/jpeg
image/webp
image/heic
image/heif
image/gif
image/bmp
image/tiff

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

AudioContent

오디오 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "audio"로 설정합니다.

data string (선택사항)

오디오 콘텐츠입니다.

uri string (선택사항)

오디오의 URI입니다.

mime_type enum (string) (선택사항)

오디오의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

audio/wav
audio/mp3
audio/aiff
audio/aac
audio/ogg
audio/flac
audio/mpeg
audio/m4a
audio/l16
audio/opus
audio/alaw
audio/mulaw

channels integer (선택사항)

오디오 채널 수입니다.

sample_rate integer (선택사항)

오디오의 샘플링 레이트입니다.

DocumentContent

문서 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "document"로 설정합니다.

data string (선택사항)

문서 콘텐츠입니다.

uri string (선택사항)

문서 URI입니다.

mime_type enum (string) (선택사항)

문서의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

application/pdf

VideoContent

동영상 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "video"로 설정합니다.

data string (선택사항)

동영상 콘텐츠입니다.

uri string (선택사항)

동영상의 URI입니다.

mime_type enum (string) (선택사항)

동영상의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

video/mp4
video/mpeg
video/mpg
video/mov
video/avi
video/x-flv
video/webm
video/wmv
video/3gpp

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

ThoughtStep

사고 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "thought"로 설정합니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

summary ThoughtSummaryContent (선택사항)

생각의 요약

가능한 유형

다형성 판별자: type

TextContent

텍스트 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "text"로 설정합니다.

text string (필수)

필수 항목입니다. 텍스트 콘텐츠입니다.

annotations Annotation (선택사항)

모델 생성 콘텐츠의 인용 정보입니다.

가능한 유형

다형성 판별자: type

UrlCitation

URL 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_citation"로 설정합니다.

url string (선택사항)

URL입니다.

title string (선택사항)

URL의 제목입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

FileCitation

파일 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_citation"로 설정합니다.

document_uri 문자열 (선택사항)

파일의 URI입니다.

file_name string (선택사항)

파일 이름입니다.

source string (선택사항)

텍스트의 일부에 기여도가 부여된 출처입니다.

custom_metadata object (선택사항)

사용자가 가져온 컨텍스트에 관한 메타데이터를 제공했습니다.

page_number integer (선택사항)

인용된 문서의 페이지 번호(해당하는 경우)

media_id string (선택사항)

이미지 인용의 경우 미디어 ID입니다(해당하는 경우).

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

PlaceCitation

장소 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "place_citation"로 설정합니다.

place_id string (선택사항)

장소의 ID입니다(`places/{place_id}` 형식).

name string (선택사항)

장소의 이름입니다.

url string (선택사항)

장소의 URI 참조입니다.

review_snippets ReviewSnippet (선택사항)

Google 지도에서 특정 장소의 기능에 관한 답변을 생성하는 데 사용되는 리뷰 스니펫입니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

ImageContent

이미지 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "image"로 설정합니다.

data string (선택사항)

이미지 콘텐츠입니다.

uri string (선택사항)

이미지의 URI입니다.

mime_type enum (string) (선택사항)

이미지의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

image/png
image/jpeg
image/webp
image/heic
image/heif
image/gif
image/bmp
image/tiff

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

FunctionCallStep

함수 도구 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "function_call"로 설정합니다.

name string (필수)

필수 항목입니다. 호출할 도구의 이름입니다.

arguments object (필수)

필수 항목입니다. 함수에 전달할 인수입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

CodeExecutionCallStep

코드 실행 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "code_execution_call"로 설정합니다.

arguments CodeExecutionCallStepArguments (필수)

필수 항목입니다. 코드 실행에 전달할 인수입니다.

필드

language enum (string) (선택사항)

`code`의 프로그래밍 언어입니다.

가능한 값은 다음과 같습니다.

python

code string (선택사항)

실행할 코드입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

UrlContextCallStep

URL 컨텍스트 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_context_call"로 설정합니다.

arguments UrlContextCallStepArguments (필수)

필수 항목입니다. URL 컨텍스트에 전달할 인수입니다.

필드

urls array (string) (선택사항)

가져올 URL입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

McpServerToolCallStep

MCPServer 도구 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "mcp_server_tool_call"로 설정합니다.

name string (필수)

필수 항목입니다. 호출된 도구의 이름입니다.

server_name string (필수)

필수 항목입니다. 사용된 MCP 서버의 이름입니다.

arguments object (필수)

필수 항목입니다. 함수의 인수 JSON 객체입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

GoogleSearchCallStep

Google 검색 통화 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_search_call"로 설정합니다.

arguments GoogleSearchCallStepArguments (필수)

필수 항목입니다. Google 검색에 전달할 인수입니다.

필드

queries array (string) (선택사항)

후속 웹 검색을 위한 웹 검색어입니다.

search_type enum (string) (선택사항)

사용 설정된 검색 그라운딩의 유형입니다.

가능한 값은 다음과 같습니다.

web_search
image_search
enterprise_web_search

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

FileSearchCallStep

파일 검색 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_search_call"로 설정합니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

GoogleMapsCallStep

Google 지도 통화 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_maps_call"로 설정합니다.

arguments GoogleMapsCallStepArguments (선택사항)

Google 지도 도구에 전달할 인수입니다.

필드

queries array (string) (선택사항)

실행할 쿼리입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

FunctionResultStep

함수 도구 호출의 결과입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "function_result"로 설정합니다.

name string (선택사항)

호출된 도구의 이름입니다.

is_error boolean (선택사항)

도구 호출로 인해 오류가 발생했는지 여부입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

result 배열 (FunctionResultSubcontent) 또는 문자열 (필수)

도구 호출의 결과입니다.

CodeExecutionResultStep

코드 실행 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "code_execution_result"로 설정합니다.

result string (필수)

필수 항목입니다. 코드 실행의 출력입니다.

is_error boolean (선택사항)

코드 실행으로 인해 오류가 발생했는지 여부입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

UrlContextResultStep

URL 컨텍스트 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_context_result"로 설정합니다.

result UrlContextResultItem (필수)

필수 항목입니다. URL 컨텍스트의 결과입니다.

필드

url string (선택사항)

가져온 URL입니다.

status enum (string) (선택사항)

URL 가져오기의 상태입니다.

가능한 값은 다음과 같습니다.

success
error
paywall
unsafe

is_error boolean (선택사항)

URL 컨텍스트로 인해 오류가 발생했는지 여부입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

GoogleSearchResultStep

Google 검색 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_search_result"로 설정합니다.

result GoogleSearchResultItem (필수)

필수 항목입니다. Google 검색 결과입니다.

필드

search_suggestions string (선택사항)

웹페이지나 앱 웹뷰에 삽입할 수 있는 웹 콘텐츠 스니펫입니다.

is_error boolean (선택사항)

Google 검색에서 오류가 발생했는지 여부입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

McpServerToolResultStep

MCPServer 도구 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "mcp_server_tool_result"로 설정합니다.

name string (선택사항)

이 특정 도구 호출에 대해 호출되는 도구의 이름입니다.

server_name string (선택사항)

사용된 MCP 서버의 이름입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

result 배열 (FunctionResultSubcontent) 또는 문자열 (필수)

MCP 서버 호출의 출력입니다. 단순 텍스트 또는 리치 콘텐츠일 수 있습니다.

FileSearchResultStep

파일 검색 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_search_result"로 설정합니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

GoogleMapsResultStep

Google 지도 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_maps_result"로 설정합니다.

result GoogleMapsResultItem (필수)

제공된 설명이 없습니다.

필드

places GoogleMapsResultPlaces (선택사항)

제공된 설명이 없습니다.

필드

place_id string (선택사항)

제공된 설명이 없습니다.

name string (선택사항)

제공된 설명이 없습니다.

url string (선택사항)

제공된 설명이 없습니다.

review_snippets ReviewSnippet (선택사항)

제공된 설명이 없습니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

widget_context_token string (선택사항)

제공된 설명이 없습니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

input Content 또는 배열 (Content) 또는 배열 (Step) 또는 문자열 (선택사항)

상호작용의 입력입니다.

response_format ResponseFormat 또는 ResponseFormatList (선택사항)

생성된 대답이 이 필드에 지정된 JSON 스키마를 준수하는 JSON 객체인지 확인합니다.

agent_config object (선택사항)

상담사 상호작용의 구성 매개변수입니다.

가능한 유형

다형성 판별자: type

DynamicAgentConfig

동적 에이전트의 구성입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "dynamic"로 설정합니다.

DeepResearchAgentConfig

Deep Research 에이전트의 구성입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "deep-research"로 설정합니다.

thinking_summaries ThinkingSummaries (선택사항)

대답에 사고 요약을 포함할지 여부입니다.

가능한 값은 다음과 같습니다.

auto
none

시각화 enum (string) (선택사항)

응답에 시각화 포함 여부입니다.

가능한 값은 다음과 같습니다.

off
auto

collaborative_planning boolean (선택사항)

Deep Research 에이전트의 인간 참여형 계획을 사용 설정합니다. true로 설정하면 Deep Research 에이전트가 대답에 조사 계획을 제공합니다. 그런 다음 사용자가 다음 턴에서 계획을 확인하는 경우에만 상담사가 계속 진행합니다.

event_id string (선택사항)

이 이벤트에서 상호작용 스트림을 재개하는 데 사용할 event_id 토큰입니다.

InteractionCompletedEvent

event_type object (필수)

제공된 설명이 없습니다.

항상 "interaction.completed"로 설정합니다.

interaction Interaction (필수)

필수 항목입니다. 페이로드 크기를 줄이기 위해 출력이 비어 있는 완료된 상호작용입니다. 실제 출력에는 위의 ContentDelta 이벤트를 사용합니다.

필드

model ModelOption (선택사항)

상호작용을 생성하는 데 사용된 `Model` 의 이름입니다.

가능한 값은 다음과 같습니다.

gemini-2.5-computer-use-preview-10-2025
직접 인터페이스 상호작용을 위해 설계된 에이전트형 기능 모델로, Gemini가 디지털 환경을 인식하고 탐색할 수 있습니다.
gemini-2.5-flash
100만 개의 토큰 컨텍스트 윈도우를 지원하고 사고 예산이 있는 Google의 첫 번째 하이브리드 추론 모델입니다.
gemini-2.5-flash-image
속도, 유연성, 맥락 이해에 최적화된 Google의 네이티브 이미지 생성 모델입니다. 텍스트 입력 및 출력은 2.5 Flash와 동일한 가격으로 책정됩니다.
gemini-2.5-flash-lite
대규모 사용을 위해 빌드된 가장 작고 비용 효율적인 모델입니다.
gemini-2.5-flash-lite-preview-09-2025
비용 효율성, 높은 처리량, 고품질에 최적화된 Gemini 2.5 Flash Lite 기반의 최신 모델입니다.
gemini-2.5-flash-native-audio-preview-12-2025
Google의 네이티브 오디오 모델은 더 나은 속도, 자연스러운 음성, 세부정보 수준, 분위기를 통해 고품질 오디오 출력을 제공하도록 최적화되어 있습니다.
gemini-2.5-flash-preview-09-2025
2.5 Flash 모델을 기반으로 하는 최신 모델입니다. 2.5 Flash Preview는 대규모 처리, 짧은 지연 시간, 사고력이 필요한 대량 작업, 에이전트형 사용 사례에 가장 적합합니다.
gemini-2.5-flash-preview-tts
강력하고 짧은 지연 시간의 제어 가능한 음성 생성에 최적화된 2.5 Flash Text-to-Speech 모델입니다.
gemini-2.5-pro
코딩 및 복잡한 추론 작업에 탁월한 성능을 보이는 최첨단 다목적 모델입니다.
gemini-2.5-pro-preview-tts
더 자연스러운 출력과 프롬프트의 쉬운 조정을 위해 강력하고 짧은 지연 시간의 음성 생성을 위해 최적화된 2.5 Pro Text-to-Speech 오디오 모델입니다.
gemini-3-flash-preview
최첨단 인텔리전스와 뛰어난 검색 및 그라운딩을 결합하여 속도에 중점을 두고 설계된 가장 지능적인 모델입니다.
gemini-3-pro-image-preview
최첨단 이미지 생성 및 편집 모델입니다.
gemini-3-pro-preview
최고 수준의 추론 및 멀티모달 이해와 강력한 에이전트형 및 바이브 코딩 기능을 갖춘 가장 지능적인 모델입니다.
gemini-3.1-pro-preview
전례 없는 깊이와 미묘한 차이를 갖춘 최신 SOTA 추론 모델로, 강력한 멀티모달 이해 및 코딩 기능을 제공합니다.
gemini-3.1-flash-image-preview
Flash 속도의 효율성과 현실에 기반한 생성 기능을 갖춘 Pro 수준의 시각적 인텔리전스
gemini-3.1-flash-lite-preview
대용량 에이전트형 작업, 번역, 간단한 데이터 처리에 최적화된 가장 비용 효율적인 모델입니다.
gemini-3.1-flash-tts-preview
Gemini 3.1 Flash TTS: 강력하고 지연 시간이 짧은 음성 생성 자연스러운 출력, 조종 가능한 프롬프트, 정확한 내레이션 제어를 위한 새로운 표현력 있는 오디오 태그를 사용해 보세요.
lyria-3-clip-preview
충실도 높은 오디오 클립과 정확한 리듬 제어에 최적화된 지연 시간이 짧은 음악 생성 모델입니다.
lyria-3-pro-preview
다양한 음악 스타일에서 정확한 구조 제어와 복잡한 전환에 최적화된 심층적인 작곡 이해를 갖춘 고급 전곡 생성 모델입니다.

agent AgentOption (선택사항)

상호작용을 생성하는 데 사용된 `Agent` 의 이름입니다.

가능한 값은 다음과 같습니다.

deep-research-pro-preview-12-2025
Gemini Deep Research 에이전트
deep-research-preview-04-2026
Gemini Deep Research 에이전트
deep-research-max-preview-04-2026
Gemini Deep Research Max 에이전트

id 문자열 (선택사항)

필수 항목입니다. 출력 전용입니다. 상호작용 완료의 고유 식별자입니다.

status enum (string) (선택사항)

필수 항목입니다. 출력 전용입니다. 상호작용의 상태입니다.

가능한 값은 다음과 같습니다.

in_progress
requires_action
completed
failed
cancelled
incomplete

created string (선택사항)

필수 항목입니다. 출력 전용입니다. 대답이 생성된 시간입니다(ISO 8601 형식(YYYY-MM-DDThh:mm:ssZ)).

updated string (선택사항)

필수 항목입니다. 출력 전용입니다. ISO 8601 형식(YYYY-MM-DDThh:mm:ssZ)으로 대답이 마지막으로 업데이트된 시간입니다.

role string (선택사항)

출력 전용입니다. 상호작용의 역할입니다.

system_instruction string (선택사항)

상호작용을 위한 시스템 요청 사항입니다.

도구 도구 (선택사항)

모델이 상호작용 중에 호출할 수 있는 도구 선언 목록입니다.

가능한 유형

다형성 판별자: type

기능

모델에서 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "function"로 설정합니다.

name string (선택사항)

함수 이름입니다.

설명 문자열 (선택사항)

함수에 대한 설명입니다.

parameters object (선택사항)

함수 파라미터의 JSON 스키마입니다.

CodeExecution

모델이 코드를 실행하는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "code_execution"로 설정합니다.

UrlContext

모델이 URL 컨텍스트를 가져오는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_context"로 설정합니다.

ComputerUse

모델이 컴퓨터와 상호작용하는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "computer_use"로 설정합니다.

environment enum (string) (선택사항)

운영되는 환경입니다.

가능한 값은 다음과 같습니다.

browser

excluded_predefined_functions array (string) (선택사항)

모델 호출에서 제외되는 사전 정의된 함수의 목록입니다.

McpServer

MCPServer는 모델이 작업을 실행하기 위해 호출할 수 있는 서버입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "mcp_server"로 설정합니다.

name string (선택사항)

MCPServer의 이름입니다.

url string (선택사항)

MCPServer 엔드포인트의 전체 URL입니다. 예: 'https://api.example.com/mcp'

headers object (선택사항)

선택사항: 필요한 경우 인증 헤더, 제한 시간 등의 필드

allowed_tools AllowedTools (선택사항)

허용된 도구입니다.

필드

mode ToolChoiceType (선택사항)

도구 선택 모드입니다.

가능한 값은 다음과 같습니다.

auto
any
none
validated

tools array (string) (선택사항)

허용된 도구의 이름입니다.

GoogleSearch

모델이 Google을 검색하는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_search"로 설정합니다.

search_types array (enum (string)) (선택사항)

사용 설정할 검색 그라운딩 유형입니다.

가능한 값은 다음과 같습니다.

web_search
image_search
enterprise_web_search

FileSearch

모델이 파일을 검색하는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_search"로 설정합니다.

file_search_store_names array (string) (선택사항)

검색할 파일 검색 저장소 이름입니다.

top_k integer (선택사항)

가져올 시맨틱 검색 청크의 수입니다.

metadata_filter string (선택사항)

시맨틱 검색 문서 및 청크에 적용할 메타데이터 필터입니다.

GoogleMaps

모델이 Google 지도를 호출하는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_maps"로 설정합니다.

enable_widget boolean (선택사항)

응답의 도구 호출 결과에 위젯 컨텍스트 토큰을 반환할지 여부입니다.

latitude number (선택사항)

사용자 위치의 위도입니다.

longitude number (선택사항)

사용자 위치의 경도입니다.

가져오기

모델이 파일을 검색하는 데 사용할 수 있는 도구입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "retrieval"로 설정합니다.

retrieval_types array (enum (string)) (선택사항)

사용 설정할 파일 검색 유형입니다.

가능한 값은 다음과 같습니다.

vertex_ai_search

vertex_ai_search_config VertexAISearchConfig (선택사항)

VertexAISearch의 구성을 지정하는 데 사용됩니다.

필드

엔진 문자열 (선택사항)

선택사항입니다. Vertex AI Search 엔진을 지정하는 데 사용됩니다.

datastores array (string) (선택사항)

선택사항입니다. Vertex AI Search 데이터 스토어를 지정하는 데 사용됩니다.

usage Usage (선택사항)

출력 전용입니다. 상호작용 요청의 토큰 사용량에 관한 통계입니다.

필드

total_input_tokens integer (선택사항)

프롬프트 (컨텍스트)의 토큰 수입니다.

input_tokens_by_modality ModalityTokens (선택사항)

모달리티별 입력 토큰 사용량 분석입니다.

필드

modality ResponseModality (선택사항)

토큰 수와 연결된 모달리티입니다.

가능한 값은 다음과 같습니다.

text
image
audio
video
document

토큰 정수 (선택사항)

모달리티의 토큰 수입니다.

total_cached_tokens integer (선택사항)

프롬프트의 캐시된 부분 (캐시된 콘텐츠)에 있는 토큰 수입니다.

cached_tokens_by_modality ModalityTokens (선택사항)

모달리티별 캐시된 토큰 사용량 분석입니다.

필드

modality ResponseModality (선택사항)

토큰 수와 연결된 모달리티입니다.

가능한 값은 다음과 같습니다.

text
image
audio
video
document

토큰 정수 (선택사항)

모달리티의 토큰 수입니다.

total_output_tokens integer (선택사항)

생성된 모든 대답의 총 토큰 수입니다.

output_tokens_by_modality ModalityTokens (선택사항)

모달리티별 출력 토큰 사용량 분석입니다.

필드

modality ResponseModality (선택사항)

토큰 수와 연결된 모달리티입니다.

가능한 값은 다음과 같습니다.

text
image
audio
video
document

토큰 정수 (선택사항)

모달리티의 토큰 수입니다.

total_tool_use_tokens integer (optional)

도구 사용 프롬프트에 있는 토큰 수입니다.

tool_use_tokens_by_modality ModalityTokens (선택사항)

모달리티별 도구 사용 토큰 사용량 분석

필드

modality ResponseModality (선택사항)

토큰 수와 연결된 모달리티입니다.

가능한 값은 다음과 같습니다.

text
image
audio
video
document

토큰 정수 (선택사항)

모달리티의 토큰 수입니다.

total_thought_tokens integer (선택사항)

사고 모델의 사고 토큰 수입니다.

total_tokens integer (선택사항)

상호작용 요청의 총 토큰 수 (프롬프트 + 응답 + 기타 내부 토큰)입니다.

grounding_tool_count GroundingToolCount (선택사항)

그라운딩 도구 수입니다.

필드

type enum (string) (선택사항)

개수와 연결된 그라운딩 도구 유형입니다.

가능한 값은 다음과 같습니다.

google_search
google_maps
retrieval

count integer (선택사항)

그라운딩 도구 수입니다.

response_modalities ResponseModality (선택사항)

요청된 대답의 형식 (TEXT, IMAGE, AUDIO)입니다.

가능한 값은 다음과 같습니다.

text
image
audio
video
document

response_mime_type string (선택사항)

대답의 MIME 유형입니다. response_format이 설정된 경우 필수입니다.

previous_interaction_id string (선택사항)

이전 상호작용의 ID입니다(있는 경우).

service_tier ServiceTier (선택사항)

상호작용의 서비스 등급입니다.

가능한 값은 다음과 같습니다.

flex
standard
priority

webhook_config WebhookConfig (선택사항)

선택사항입니다. 상호작용이 완료될 때 알림을 수신하기 위한 웹훅 구성입니다.

필드

uris array (string) (선택사항)

선택사항입니다. 설정된 경우 등록된 웹훅 대신 웹훅 이벤트에 이러한 웹훅 URI가 사용됩니다.

user_metadata object (선택사항)

선택사항입니다. 각 이벤트가 웹훅에 전송될 때 반환되는 사용자 메타데이터입니다.

steps Step (선택사항)

출력 전용입니다. 상호작용을 구성하는 단계입니다.

가능한 유형

다형성 판별자: type

UserInputStep

사용자가 제공한 입력입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "user_input"로 설정합니다.

content Content (선택사항)

제공된 설명이 없습니다.

가능한 유형

다형성 판별자: type

TextContent

텍스트 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "text"로 설정합니다.

text string (필수)

필수 항목입니다. 텍스트 콘텐츠입니다.

annotations Annotation (선택사항)

모델 생성 콘텐츠의 인용 정보입니다.

가능한 유형

다형성 판별자: type

UrlCitation

URL 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_citation"로 설정합니다.

url string (선택사항)

URL입니다.

title string (선택사항)

URL의 제목입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

FileCitation

파일 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_citation"로 설정합니다.

document_uri 문자열 (선택사항)

파일의 URI입니다.

file_name string (선택사항)

파일 이름입니다.

source string (선택사항)

텍스트의 일부에 기여도가 부여된 출처입니다.

custom_metadata object (선택사항)

사용자가 가져온 컨텍스트에 관한 메타데이터를 제공했습니다.

page_number integer (선택사항)

인용된 문서의 페이지 번호(해당하는 경우)

media_id string (선택사항)

이미지 인용의 경우 미디어 ID입니다(해당하는 경우).

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

PlaceCitation

장소 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "place_citation"로 설정합니다.

place_id string (선택사항)

장소의 ID입니다(`places/{place_id}` 형식).

name string (선택사항)

장소의 이름입니다.

url string (선택사항)

장소의 URI 참조입니다.

review_snippets ReviewSnippet (선택사항)

Google 지도에서 특정 장소의 기능에 관한 답변을 생성하는 데 사용되는 리뷰 스니펫입니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

ImageContent

이미지 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "image"로 설정합니다.

data string (선택사항)

이미지 콘텐츠입니다.

uri string (선택사항)

이미지의 URI입니다.

mime_type enum (string) (선택사항)

이미지의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

image/png
image/jpeg
image/webp
image/heic
image/heif
image/gif
image/bmp
image/tiff

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

AudioContent

오디오 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "audio"로 설정합니다.

data string (선택사항)

오디오 콘텐츠입니다.

uri string (선택사항)

오디오의 URI입니다.

mime_type enum (string) (선택사항)

오디오의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

audio/wav
audio/mp3
audio/aiff
audio/aac
audio/ogg
audio/flac
audio/mpeg
audio/m4a
audio/l16
audio/opus
audio/alaw
audio/mulaw

channels integer (선택사항)

오디오 채널 수입니다.

sample_rate integer (선택사항)

오디오의 샘플링 레이트입니다.

DocumentContent

문서 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "document"로 설정합니다.

data string (선택사항)

문서 콘텐츠입니다.

uri string (선택사항)

문서 URI입니다.

mime_type enum (string) (선택사항)

문서의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

application/pdf

VideoContent

동영상 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "video"로 설정합니다.

data string (선택사항)

동영상 콘텐츠입니다.

uri string (선택사항)

동영상의 URI입니다.

mime_type enum (string) (선택사항)

동영상의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

video/mp4
video/mpeg
video/mpg
video/mov
video/avi
video/x-flv
video/webm
video/wmv
video/3gpp

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

ModelOutputStep

모델에서 생성된 출력입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "model_output"로 설정합니다.

content Content (선택사항)

제공된 설명이 없습니다.

가능한 유형

다형성 판별자: type

TextContent

텍스트 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "text"로 설정합니다.

text string (필수)

필수 항목입니다. 텍스트 콘텐츠입니다.

annotations Annotation (선택사항)

모델 생성 콘텐츠의 인용 정보입니다.

가능한 유형

다형성 판별자: type

UrlCitation

URL 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_citation"로 설정합니다.

url string (선택사항)

URL입니다.

title string (선택사항)

URL의 제목입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

FileCitation

파일 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_citation"로 설정합니다.

document_uri 문자열 (선택사항)

파일의 URI입니다.

file_name string (선택사항)

파일 이름입니다.

source string (선택사항)

텍스트의 일부에 기여도가 부여된 출처입니다.

custom_metadata object (선택사항)

사용자가 가져온 컨텍스트에 관한 메타데이터를 제공했습니다.

page_number integer (선택사항)

인용된 문서의 페이지 번호(해당하는 경우)

media_id string (선택사항)

이미지 인용의 경우 미디어 ID입니다(해당하는 경우).

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

PlaceCitation

장소 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "place_citation"로 설정합니다.

place_id string (선택사항)

장소의 ID입니다(`places/{place_id}` 형식).

name string (선택사항)

장소의 이름입니다.

url string (선택사항)

장소의 URI 참조입니다.

review_snippets ReviewSnippet (선택사항)

Google 지도에서 특정 장소의 기능에 관한 답변을 생성하는 데 사용되는 리뷰 스니펫입니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

ImageContent

이미지 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "image"로 설정합니다.

data string (선택사항)

이미지 콘텐츠입니다.

uri string (선택사항)

이미지의 URI입니다.

mime_type enum (string) (선택사항)

이미지의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

image/png
image/jpeg
image/webp
image/heic
image/heif
image/gif
image/bmp
image/tiff

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

AudioContent

오디오 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "audio"로 설정합니다.

data string (선택사항)

오디오 콘텐츠입니다.

uri string (선택사항)

오디오의 URI입니다.

mime_type enum (string) (선택사항)

오디오의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

audio/wav
audio/mp3
audio/aiff
audio/aac
audio/ogg
audio/flac
audio/mpeg
audio/m4a
audio/l16
audio/opus
audio/alaw
audio/mulaw

channels integer (선택사항)

오디오 채널 수입니다.

sample_rate integer (선택사항)

오디오의 샘플링 레이트입니다.

DocumentContent

문서 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "document"로 설정합니다.

data string (선택사항)

문서 콘텐츠입니다.

uri string (선택사항)

문서 URI입니다.

mime_type enum (string) (선택사항)

문서의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

application/pdf

VideoContent

동영상 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "video"로 설정합니다.

data string (선택사항)

동영상 콘텐츠입니다.

uri string (선택사항)

동영상의 URI입니다.

mime_type enum (string) (선택사항)

동영상의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

video/mp4
video/mpeg
video/mpg
video/mov
video/avi
video/x-flv
video/webm
video/wmv
video/3gpp

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

ThoughtStep

사고 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "thought"로 설정합니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

summary ThoughtSummaryContent (선택사항)

생각의 요약

가능한 유형

다형성 판별자: type

TextContent

텍스트 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "text"로 설정합니다.

text string (필수)

필수 항목입니다. 텍스트 콘텐츠입니다.

annotations Annotation (선택사항)

모델 생성 콘텐츠의 인용 정보입니다.

가능한 유형

다형성 판별자: type

UrlCitation

URL 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_citation"로 설정합니다.

url string (선택사항)

URL입니다.

title string (선택사항)

URL의 제목입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

FileCitation

파일 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_citation"로 설정합니다.

document_uri 문자열 (선택사항)

파일의 URI입니다.

file_name string (선택사항)

파일 이름입니다.

source string (선택사항)

텍스트의 일부에 기여도가 부여된 출처입니다.

custom_metadata object (선택사항)

사용자가 가져온 컨텍스트에 관한 메타데이터를 제공했습니다.

page_number integer (선택사항)

인용된 문서의 페이지 번호(해당하는 경우)

media_id string (선택사항)

이미지 인용의 경우 미디어 ID입니다(해당하는 경우).

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

PlaceCitation

장소 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "place_citation"로 설정합니다.

place_id string (선택사항)

장소의 ID입니다(`places/{place_id}` 형식).

name string (선택사항)

장소의 이름입니다.

url string (선택사항)

장소의 URI 참조입니다.

review_snippets ReviewSnippet (선택사항)

Google 지도에서 특정 장소의 기능에 관한 답변을 생성하는 데 사용되는 리뷰 스니펫입니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

ImageContent

이미지 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "image"로 설정합니다.

data string (선택사항)

이미지 콘텐츠입니다.

uri string (선택사항)

이미지의 URI입니다.

mime_type enum (string) (선택사항)

이미지의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

image/png
image/jpeg
image/webp
image/heic
image/heif
image/gif
image/bmp
image/tiff

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

FunctionCallStep

함수 도구 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "function_call"로 설정합니다.

name string (필수)

필수 항목입니다. 호출할 도구의 이름입니다.

arguments object (필수)

필수 항목입니다. 함수에 전달할 인수입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

CodeExecutionCallStep

코드 실행 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "code_execution_call"로 설정합니다.

arguments CodeExecutionCallStepArguments (필수)

필수 항목입니다. 코드 실행에 전달할 인수입니다.

필드

language enum (string) (선택사항)

`code`의 프로그래밍 언어입니다.

가능한 값은 다음과 같습니다.

python

code string (선택사항)

실행할 코드입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

UrlContextCallStep

URL 컨텍스트 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_context_call"로 설정합니다.

arguments UrlContextCallStepArguments (필수)

필수 항목입니다. URL 컨텍스트에 전달할 인수입니다.

필드

urls array (string) (선택사항)

가져올 URL입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

McpServerToolCallStep

MCPServer 도구 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "mcp_server_tool_call"로 설정합니다.

name string (필수)

필수 항목입니다. 호출된 도구의 이름입니다.

server_name string (필수)

필수 항목입니다. 사용된 MCP 서버의 이름입니다.

arguments object (필수)

필수 항목입니다. 함수의 인수 JSON 객체입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

GoogleSearchCallStep

Google 검색 통화 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_search_call"로 설정합니다.

arguments GoogleSearchCallStepArguments (필수)

필수 항목입니다. Google 검색에 전달할 인수입니다.

필드

queries array (string) (선택사항)

후속 웹 검색을 위한 웹 검색어입니다.

search_type enum (string) (선택사항)

사용 설정된 검색 그라운딩의 유형입니다.

가능한 값은 다음과 같습니다.

web_search
image_search
enterprise_web_search

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

FileSearchCallStep

파일 검색 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_search_call"로 설정합니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

GoogleMapsCallStep

Google 지도 통화 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_maps_call"로 설정합니다.

arguments GoogleMapsCallStepArguments (선택사항)

Google 지도 도구에 전달할 인수입니다.

필드

queries array (string) (선택사항)

실행할 쿼리입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

FunctionResultStep

함수 도구 호출의 결과입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "function_result"로 설정합니다.

name string (선택사항)

호출된 도구의 이름입니다.

is_error boolean (선택사항)

도구 호출로 인해 오류가 발생했는지 여부입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

result 배열 (FunctionResultSubcontent) 또는 문자열 (필수)

도구 호출의 결과입니다.

CodeExecutionResultStep

코드 실행 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "code_execution_result"로 설정합니다.

result string (필수)

필수 항목입니다. 코드 실행의 출력입니다.

is_error boolean (선택사항)

코드 실행으로 인해 오류가 발생했는지 여부입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

UrlContextResultStep

URL 컨텍스트 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_context_result"로 설정합니다.

result UrlContextResultItem (필수)

필수 항목입니다. URL 컨텍스트의 결과입니다.

필드

url string (선택사항)

가져온 URL입니다.

status enum (string) (선택사항)

URL 가져오기의 상태입니다.

가능한 값은 다음과 같습니다.

success
error
paywall
unsafe

is_error boolean (선택사항)

URL 컨텍스트로 인해 오류가 발생했는지 여부입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

GoogleSearchResultStep

Google 검색 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_search_result"로 설정합니다.

result GoogleSearchResultItem (필수)

필수 항목입니다. Google 검색 결과입니다.

필드

search_suggestions string (선택사항)

웹페이지나 앱 웹뷰에 삽입할 수 있는 웹 콘텐츠 스니펫입니다.

is_error boolean (선택사항)

Google 검색에서 오류가 발생했는지 여부입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

McpServerToolResultStep

MCPServer 도구 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "mcp_server_tool_result"로 설정합니다.

name string (선택사항)

이 특정 도구 호출에 대해 호출되는 도구의 이름입니다.

server_name string (선택사항)

사용된 MCP 서버의 이름입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

result 배열 (FunctionResultSubcontent) 또는 문자열 (필수)

MCP 서버 호출의 출력입니다. 단순 텍스트 또는 리치 콘텐츠일 수 있습니다.

FileSearchResultStep

파일 검색 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_search_result"로 설정합니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

GoogleMapsResultStep

Google 지도 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_maps_result"로 설정합니다.

result GoogleMapsResultItem (필수)

제공된 설명이 없습니다.

필드

places GoogleMapsResultPlaces (선택사항)

제공된 설명이 없습니다.

필드

place_id string (선택사항)

제공된 설명이 없습니다.

name string (선택사항)

제공된 설명이 없습니다.

url string (선택사항)

제공된 설명이 없습니다.

review_snippets ReviewSnippet (선택사항)

제공된 설명이 없습니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

widget_context_token string (선택사항)

제공된 설명이 없습니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

input Content 또는 배열 (Content) 또는 배열 (Step) 또는 문자열 (선택사항)

상호작용의 입력입니다.

response_format ResponseFormat 또는 ResponseFormatList (선택사항)

생성된 대답이 이 필드에 지정된 JSON 스키마를 준수하는 JSON 객체인지 확인합니다.

agent_config object (선택사항)

상담사 상호작용의 구성 매개변수입니다.

가능한 유형

다형성 판별자: type

DynamicAgentConfig

동적 에이전트의 구성입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "dynamic"로 설정합니다.

DeepResearchAgentConfig

Deep Research 에이전트의 구성입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "deep-research"로 설정합니다.

thinking_summaries ThinkingSummaries (선택사항)

대답에 사고 요약을 포함할지 여부입니다.

가능한 값은 다음과 같습니다.

auto
none

시각화 enum (string) (선택사항)

응답에 시각화 포함 여부입니다.

가능한 값은 다음과 같습니다.

off
auto

collaborative_planning boolean (선택사항)

event_id string (선택사항)

이 이벤트에서 상호작용 스트림을 재개하는 데 사용할 event_id 토큰입니다.

InteractionStatusUpdate

event_type object (필수)

제공된 설명이 없습니다.

항상 "interaction.status_update"로 설정합니다.

interaction_id string (필수)

제공된 설명이 없습니다.

status enum (string) (필수)

제공된 설명이 없습니다.

가능한 값은 다음과 같습니다.

in_progress
requires_action
completed
failed
cancelled
incomplete

event_id string (선택사항)

이 이벤트에서 상호작용 스트림을 재개하는 데 사용할 event_id 토큰입니다.

ErrorEvent

event_type object (필수)

제공된 설명이 없습니다.

항상 "error"로 설정합니다.

error Error (선택사항)

제공된 설명이 없습니다.

필드

code string (선택사항)

오류 유형을 식별하는 URI입니다.

message string (선택사항)

사람이 읽을 수 있는 오류 메시지입니다.

event_id string (선택사항)

이 이벤트에서 상호작용 스트림을 재개하는 데 사용할 event_id 토큰입니다.

StepStart

event_type object (필수)

제공된 설명이 없습니다.

항상 "step.start"로 설정합니다.

index 정수 (필수)

제공된 설명이 없습니다.

단계 단계 (필수)

제공된 설명이 없습니다.

가능한 유형

다형성 판별자: type

UserInputStep

사용자가 제공한 입력입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "user_input"로 설정합니다.

content Content (선택사항)

제공된 설명이 없습니다.

가능한 유형

다형성 판별자: type

TextContent

텍스트 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "text"로 설정합니다.

text string (필수)

필수 항목입니다. 텍스트 콘텐츠입니다.

annotations Annotation (선택사항)

모델 생성 콘텐츠의 인용 정보입니다.

가능한 유형

다형성 판별자: type

UrlCitation

URL 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_citation"로 설정합니다.

url string (선택사항)

URL입니다.

title string (선택사항)

URL의 제목입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

FileCitation

파일 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_citation"로 설정합니다.

document_uri 문자열 (선택사항)

파일의 URI입니다.

file_name string (선택사항)

파일 이름입니다.

source string (선택사항)

텍스트의 일부에 기여도가 부여된 출처입니다.

custom_metadata object (선택사항)

사용자가 가져온 컨텍스트에 관한 메타데이터를 제공했습니다.

page_number integer (선택사항)

인용된 문서의 페이지 번호(해당하는 경우)

media_id string (선택사항)

이미지 인용의 경우 미디어 ID입니다(해당하는 경우).

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

PlaceCitation

장소 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "place_citation"로 설정합니다.

place_id string (선택사항)

장소의 ID입니다(`places/{place_id}` 형식).

name string (선택사항)

장소의 이름입니다.

url string (선택사항)

장소의 URI 참조입니다.

review_snippets ReviewSnippet (선택사항)

Google 지도에서 특정 장소의 기능에 관한 답변을 생성하는 데 사용되는 리뷰 스니펫입니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

ImageContent

이미지 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "image"로 설정합니다.

data string (선택사항)

이미지 콘텐츠입니다.

uri string (선택사항)

이미지의 URI입니다.

mime_type enum (string) (선택사항)

이미지의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

image/png
image/jpeg
image/webp
image/heic
image/heif
image/gif
image/bmp
image/tiff

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

AudioContent

오디오 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "audio"로 설정합니다.

data string (선택사항)

오디오 콘텐츠입니다.

uri string (선택사항)

오디오의 URI입니다.

mime_type enum (string) (선택사항)

오디오의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

audio/wav
audio/mp3
audio/aiff
audio/aac
audio/ogg
audio/flac
audio/mpeg
audio/m4a
audio/l16
audio/opus
audio/alaw
audio/mulaw

channels integer (선택사항)

오디오 채널 수입니다.

sample_rate integer (선택사항)

오디오의 샘플링 레이트입니다.

DocumentContent

문서 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "document"로 설정합니다.

data string (선택사항)

문서 콘텐츠입니다.

uri string (선택사항)

문서 URI입니다.

mime_type enum (string) (선택사항)

문서의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

application/pdf

VideoContent

동영상 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "video"로 설정합니다.

data string (선택사항)

동영상 콘텐츠입니다.

uri string (선택사항)

동영상의 URI입니다.

mime_type enum (string) (선택사항)

동영상의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

video/mp4
video/mpeg
video/mpg
video/mov
video/avi
video/x-flv
video/webm
video/wmv
video/3gpp

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

ModelOutputStep

모델에서 생성된 출력입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "model_output"로 설정합니다.

content Content (선택사항)

제공된 설명이 없습니다.

가능한 유형

다형성 판별자: type

TextContent

텍스트 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "text"로 설정합니다.

text string (필수)

필수 항목입니다. 텍스트 콘텐츠입니다.

annotations Annotation (선택사항)

모델 생성 콘텐츠의 인용 정보입니다.

가능한 유형

다형성 판별자: type

UrlCitation

URL 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_citation"로 설정합니다.

url string (선택사항)

URL입니다.

title string (선택사항)

URL의 제목입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

FileCitation

파일 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_citation"로 설정합니다.

document_uri 문자열 (선택사항)

파일의 URI입니다.

file_name string (선택사항)

파일 이름입니다.

source string (선택사항)

텍스트의 일부에 기여도가 부여된 출처입니다.

custom_metadata object (선택사항)

사용자가 가져온 컨텍스트에 관한 메타데이터를 제공했습니다.

page_number integer (선택사항)

인용된 문서의 페이지 번호(해당하는 경우)

media_id string (선택사항)

이미지 인용의 경우 미디어 ID입니다(해당하는 경우).

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

PlaceCitation

장소 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "place_citation"로 설정합니다.

place_id string (선택사항)

장소의 ID입니다(`places/{place_id}` 형식).

name string (선택사항)

장소의 이름입니다.

url string (선택사항)

장소의 URI 참조입니다.

review_snippets ReviewSnippet (선택사항)

Google 지도에서 특정 장소의 기능에 관한 답변을 생성하는 데 사용되는 리뷰 스니펫입니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

ImageContent

이미지 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "image"로 설정합니다.

data string (선택사항)

이미지 콘텐츠입니다.

uri string (선택사항)

이미지의 URI입니다.

mime_type enum (string) (선택사항)

이미지의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

image/png
image/jpeg
image/webp
image/heic
image/heif
image/gif
image/bmp
image/tiff

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

AudioContent

오디오 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "audio"로 설정합니다.

data string (선택사항)

오디오 콘텐츠입니다.

uri string (선택사항)

오디오의 URI입니다.

mime_type enum (string) (선택사항)

오디오의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

audio/wav
audio/mp3
audio/aiff
audio/aac
audio/ogg
audio/flac
audio/mpeg
audio/m4a
audio/l16
audio/opus
audio/alaw
audio/mulaw

channels integer (선택사항)

오디오 채널 수입니다.

sample_rate integer (선택사항)

오디오의 샘플링 레이트입니다.

DocumentContent

문서 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "document"로 설정합니다.

data string (선택사항)

문서 콘텐츠입니다.

uri string (선택사항)

문서 URI입니다.

mime_type enum (string) (선택사항)

문서의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

application/pdf

VideoContent

동영상 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "video"로 설정합니다.

data string (선택사항)

동영상 콘텐츠입니다.

uri string (선택사항)

동영상의 URI입니다.

mime_type enum (string) (선택사항)

동영상의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

video/mp4
video/mpeg
video/mpg
video/mov
video/avi
video/x-flv
video/webm
video/wmv
video/3gpp

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

ThoughtStep

사고 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "thought"로 설정합니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

summary ThoughtSummaryContent (선택사항)

생각의 요약

가능한 유형

다형성 판별자: type

TextContent

텍스트 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "text"로 설정합니다.

text string (필수)

필수 항목입니다. 텍스트 콘텐츠입니다.

annotations Annotation (선택사항)

모델 생성 콘텐츠의 인용 정보입니다.

가능한 유형

다형성 판별자: type

UrlCitation

URL 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_citation"로 설정합니다.

url string (선택사항)

URL입니다.

title string (선택사항)

URL의 제목입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

FileCitation

파일 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_citation"로 설정합니다.

document_uri 문자열 (선택사항)

파일의 URI입니다.

file_name string (선택사항)

파일 이름입니다.

source string (선택사항)

텍스트의 일부에 기여도가 부여된 출처입니다.

custom_metadata object (선택사항)

사용자가 가져온 컨텍스트에 관한 메타데이터를 제공했습니다.

page_number integer (선택사항)

인용된 문서의 페이지 번호(해당하는 경우)

media_id string (선택사항)

이미지 인용의 경우 미디어 ID입니다(해당하는 경우).

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

PlaceCitation

장소 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "place_citation"로 설정합니다.

place_id string (선택사항)

장소의 ID입니다(`places/{place_id}` 형식).

name string (선택사항)

장소의 이름입니다.

url string (선택사항)

장소의 URI 참조입니다.

review_snippets ReviewSnippet (선택사항)

Google 지도에서 특정 장소의 기능에 관한 답변을 생성하는 데 사용되는 리뷰 스니펫입니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

ImageContent

이미지 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "image"로 설정합니다.

data string (선택사항)

이미지 콘텐츠입니다.

uri string (선택사항)

이미지의 URI입니다.

mime_type enum (string) (선택사항)

이미지의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

image/png
image/jpeg
image/webp
image/heic
image/heif
image/gif
image/bmp
image/tiff

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

FunctionCallStep

함수 도구 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "function_call"로 설정합니다.

name string (필수)

필수 항목입니다. 호출할 도구의 이름입니다.

arguments object (필수)

필수 항목입니다. 함수에 전달할 인수입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

CodeExecutionCallStep

코드 실행 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "code_execution_call"로 설정합니다.

arguments CodeExecutionCallStepArguments (필수)

필수 항목입니다. 코드 실행에 전달할 인수입니다.

필드

language enum (string) (선택사항)

`code`의 프로그래밍 언어입니다.

가능한 값은 다음과 같습니다.

python

code string (선택사항)

실행할 코드입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

UrlContextCallStep

URL 컨텍스트 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_context_call"로 설정합니다.

arguments UrlContextCallStepArguments (필수)

필수 항목입니다. URL 컨텍스트에 전달할 인수입니다.

필드

urls array (string) (선택사항)

가져올 URL입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

McpServerToolCallStep

MCPServer 도구 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "mcp_server_tool_call"로 설정합니다.

name string (필수)

필수 항목입니다. 호출된 도구의 이름입니다.

server_name string (필수)

필수 항목입니다. 사용된 MCP 서버의 이름입니다.

arguments object (필수)

필수 항목입니다. 함수의 인수 JSON 객체입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

GoogleSearchCallStep

Google 검색 통화 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_search_call"로 설정합니다.

arguments GoogleSearchCallStepArguments (필수)

필수 항목입니다. Google 검색에 전달할 인수입니다.

필드

queries array (string) (선택사항)

후속 웹 검색을 위한 웹 검색어입니다.

search_type enum (string) (선택사항)

사용 설정된 검색 그라운딩의 유형입니다.

가능한 값은 다음과 같습니다.

web_search
image_search
enterprise_web_search

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

FileSearchCallStep

파일 검색 호출 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_search_call"로 설정합니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

GoogleMapsCallStep

Google 지도 통화 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_maps_call"로 설정합니다.

arguments GoogleMapsCallStepArguments (선택사항)

Google 지도 도구에 전달할 인수입니다.

필드

queries array (string) (선택사항)

실행할 쿼리입니다.

id 문자열 (필수)

필수 항목입니다. 이 특정 도구 호출의 고유 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

FunctionResultStep

함수 도구 호출의 결과입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "function_result"로 설정합니다.

name string (선택사항)

호출된 도구의 이름입니다.

is_error boolean (선택사항)

도구 호출로 인해 오류가 발생했는지 여부입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

result 배열 (FunctionResultSubcontent) 또는 문자열 (필수)

도구 호출의 결과입니다.

CodeExecutionResultStep

코드 실행 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "code_execution_result"로 설정합니다.

result string (필수)

필수 항목입니다. 코드 실행의 출력입니다.

is_error boolean (선택사항)

코드 실행으로 인해 오류가 발생했는지 여부입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

UrlContextResultStep

URL 컨텍스트 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_context_result"로 설정합니다.

result UrlContextResultItem (필수)

필수 항목입니다. URL 컨텍스트의 결과입니다.

필드

url string (선택사항)

가져온 URL입니다.

status enum (string) (선택사항)

URL 가져오기의 상태입니다.

가능한 값은 다음과 같습니다.

success
error
paywall
unsafe

is_error boolean (선택사항)

URL 컨텍스트로 인해 오류가 발생했는지 여부입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

GoogleSearchResultStep

Google 검색 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_search_result"로 설정합니다.

result GoogleSearchResultItem (필수)

필수 항목입니다. Google 검색 결과입니다.

필드

search_suggestions string (선택사항)

웹페이지나 앱 웹뷰에 삽입할 수 있는 웹 콘텐츠 스니펫입니다.

is_error boolean (선택사항)

Google 검색에서 오류가 발생했는지 여부입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

McpServerToolResultStep

MCPServer 도구 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "mcp_server_tool_result"로 설정합니다.

name string (선택사항)

이 특정 도구 호출에 대해 호출되는 도구의 이름입니다.

server_name string (선택사항)

사용된 MCP 서버의 이름입니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

result 배열 (FunctionResultSubcontent) 또는 문자열 (필수)

MCP 서버 호출의 출력입니다. 단순 텍스트 또는 리치 콘텐츠일 수 있습니다.

FileSearchResultStep

파일 검색 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_search_result"로 설정합니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

GoogleMapsResultStep

Google 지도 결과 단계입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "google_maps_result"로 설정합니다.

result GoogleMapsResultItem (필수)

제공된 설명이 없습니다.

필드

places GoogleMapsResultPlaces (선택사항)

제공된 설명이 없습니다.

필드

place_id string (선택사항)

제공된 설명이 없습니다.

name string (선택사항)

제공된 설명이 없습니다.

url string (선택사항)

제공된 설명이 없습니다.

review_snippets ReviewSnippet (선택사항)

제공된 설명이 없습니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

widget_context_token string (선택사항)

제공된 설명이 없습니다.

call_id string (필수)

필수 항목입니다. 함수 호출 블록의 ID와 일치하는 ID입니다.

서명 문자열 (선택사항)

백엔드 검증을 위한 서명 해시입니다.

event_id string (선택사항)

이 이벤트에서 상호작용 스트림을 재개하는 데 사용할 event_id 토큰입니다.

StepDelta

event_type object (필수)

제공된 설명이 없습니다.

항상 "step.delta"로 설정합니다.

index 정수 (필수)

제공된 설명이 없습니다.

delta StepDeltaData (필수)

제공된 설명이 없습니다.

가능한 유형

다형성 판별자: type

TextDelta

type object (필수)

제공된 설명이 없습니다.

항상 "text"로 설정합니다.

text string (필수)

제공된 설명이 없습니다.

ImageDelta

type object (필수)

제공된 설명이 없습니다.

항상 "image"로 설정합니다.

data string (선택사항)

제공된 설명이 없습니다.

uri string (선택사항)

제공된 설명이 없습니다.

mime_type enum (string) (선택사항)

제공된 설명이 없습니다.

가능한 값은 다음과 같습니다.

image/png
image/jpeg
image/webp
image/heic
image/heif
image/gif
image/bmp
image/tiff

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

AudioDelta

type object (필수)

제공된 설명이 없습니다.

항상 "audio"로 설정합니다.

data string (선택사항)

제공된 설명이 없습니다.

uri string (선택사항)

제공된 설명이 없습니다.

mime_type enum (string) (선택사항)

제공된 설명이 없습니다.

가능한 값은 다음과 같습니다.

audio/wav
audio/mp3
audio/aiff
audio/aac
audio/ogg
audio/flac
audio/mpeg
audio/m4a
audio/l16
audio/opus
audio/alaw
audio/mulaw

rate 정수 (선택사항)

지원 중단되었습니다. 대신 sample_rate를 사용하세요. 이 값은 무시됩니다.

sample_rate integer (선택사항)

오디오의 샘플링 레이트입니다.

channels integer (선택사항)

오디오 채널 수입니다.

DocumentDelta

type object (필수)

제공된 설명이 없습니다.

항상 "document"로 설정합니다.

data string (선택사항)

제공된 설명이 없습니다.

uri string (선택사항)

제공된 설명이 없습니다.

mime_type enum (string) (선택사항)

제공된 설명이 없습니다.

가능한 값은 다음과 같습니다.

application/pdf

VideoDelta

type object (필수)

제공된 설명이 없습니다.

항상 "video"로 설정합니다.

data string (선택사항)

제공된 설명이 없습니다.

uri string (선택사항)

제공된 설명이 없습니다.

mime_type enum (string) (선택사항)

제공된 설명이 없습니다.

가능한 값은 다음과 같습니다.

video/mp4
video/mpeg
video/mpg
video/mov
video/avi
video/x-flv
video/webm
video/wmv
video/3gpp

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

ThoughtSummaryDelta

type object (필수)

제공된 설명이 없습니다.

항상 "thought_summary"로 설정합니다.

content ThoughtSummaryContent (선택사항)

생각에 추가할 새로운 요약 항목입니다.

가능한 유형

다형성 판별자: type

TextContent

텍스트 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "text"로 설정합니다.

text string (필수)

필수 항목입니다. 텍스트 콘텐츠입니다.

annotations Annotation (선택사항)

모델 생성 콘텐츠의 인용 정보입니다.

가능한 유형

다형성 판별자: type

UrlCitation

URL 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_citation"로 설정합니다.

url string (선택사항)

URL입니다.

title string (선택사항)

URL의 제목입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

FileCitation

파일 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_citation"로 설정합니다.

document_uri 문자열 (선택사항)

파일의 URI입니다.

file_name string (선택사항)

파일 이름입니다.

source string (선택사항)

텍스트의 일부에 기여도가 부여된 출처입니다.

custom_metadata object (선택사항)

사용자가 가져온 컨텍스트에 관한 메타데이터를 제공했습니다.

page_number integer (선택사항)

인용된 문서의 페이지 번호(해당하는 경우)

media_id string (선택사항)

이미지 인용의 경우 미디어 ID입니다(해당하는 경우).

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

PlaceCitation

장소 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "place_citation"로 설정합니다.

place_id string (선택사항)

장소의 ID입니다(`places/{place_id}` 형식).

name string (선택사항)

장소의 이름입니다.

url string (선택사항)

장소의 URI 참조입니다.

review_snippets ReviewSnippet (선택사항)

Google 지도에서 특정 장소의 기능에 관한 답변을 생성하는 데 사용되는 리뷰 스니펫입니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

ImageContent

이미지 콘텐츠 블록입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "image"로 설정합니다.

data string (선택사항)

이미지 콘텐츠입니다.

uri string (선택사항)

이미지의 URI입니다.

mime_type enum (string) (선택사항)

이미지의 MIME 유형입니다.

가능한 값은 다음과 같습니다.

image/png
image/jpeg
image/webp
image/heic
image/heif
image/gif
image/bmp
image/tiff

resolution MediaResolution (선택사항)

미디어의 해상도입니다.

가능한 값은 다음과 같습니다.

low
medium
high
ultra_high

ThoughtSignatureDelta

type object (필수)

제공된 설명이 없습니다.

항상 "thought_signature"로 설정합니다.

서명 문자열 (선택사항)

생성에 포함될 백엔드 소스와 일치하는 서명입니다.

TextAnnotationDelta

type object (필수)

제공된 설명이 없습니다.

항상 "text_annotation_delta"로 설정합니다.

annotations Annotation (선택사항)

모델 생성 콘텐츠의 인용 정보입니다.

가능한 유형

다형성 판별자: type

UrlCitation

URL 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "url_citation"로 설정합니다.

url string (선택사항)

URL입니다.

title string (선택사항)

URL의 제목입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

FileCitation

파일 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "file_citation"로 설정합니다.

document_uri 문자열 (선택사항)

파일의 URI입니다.

file_name string (선택사항)

파일 이름입니다.

source string (선택사항)

텍스트의 일부에 기여도가 부여된 출처입니다.

custom_metadata object (선택사항)

사용자가 가져온 컨텍스트에 관한 메타데이터를 제공했습니다.

page_number integer (선택사항)

인용된 문서의 페이지 번호(해당하는 경우)

media_id string (선택사항)

이미지 인용의 경우 미디어 ID입니다(해당하는 경우).

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

PlaceCitation

장소 인용 주석입니다.

type object (필수)

제공된 설명이 없습니다.

항상 "place_citation"로 설정합니다.

place_id string (선택사항)

장소의 ID입니다(`places/{place_id}` 형식).

name string (선택사항)

장소의 이름입니다.

url string (선택사항)

장소의 URI 참조입니다.

review_snippets ReviewSnippet (선택사항)

Google 지도에서 특정 장소의 기능에 관한 답변을 생성하는 데 사용되는 리뷰 스니펫입니다.

필드

title string (선택사항)

리뷰의 제목입니다.

url string (선택사항)

Google 지도의 사용자 리뷰에 해당하는 링크입니다.

review_id string (선택사항)

리뷰 스니펫의 ID입니다.

start_index integer (선택사항)

이 출처에 기여도가 부여된 대답의 세그먼트 시작입니다. 색인은 바이트로 측정된 세그먼트의 시작을 나타냅니다.

end_index integer (선택사항)

기여도가 부여된 세그먼트의 끝(해당 값 제외)입니다.

ArgumentsDelta

type object (필수)

제공된 설명이 없습니다.

항상 "arguments_delta"로 설정합니다.

partial_arguments string (선택사항)

제공된 설명이 없습니다.

event_id string (선택사항)

이 이벤트에서 상호작용 스트림을 재개하는 데 사용할 event_id 토큰입니다.

StepStop

event_type object (필수)

제공된 설명이 없습니다.

항상 "step.stop"로 설정합니다.

index 정수 (필수)

제공된 설명이 없습니다.

event_id string (선택사항)

이 이벤트에서 상호작용 스트림을 재개하는 데 사용할 event_id 토큰입니다.

예

Interaction Created(상호작용 생성됨)

{
  "event_type": "interaction.created",
  "interaction": {
    "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
    "model": "gemini-3-flash-preview",
    "status": "in_progress",
    "created": "2025-12-04T15:01:45Z",
    "updated": "2025-12-04T15:01:45Z"
  },
  "event_id": "evt_123"
}

상호작용 완료됨

{
  "event_type": "interaction.completed",
  "interaction": {
    "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
    "model": "gemini-3-flash-preview",
    "status": "completed",
    "created": "2025-12-04T15:01:45Z",
    "updated": "2025-12-04T15:01:45Z"
  },
  "event_id": "evt_123"
}

상호작용 상태 업데이트

{
  "event_type": "interaction.status_update",
  "interaction_id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
  "status": "in_progress"
}

오류 이벤트

{
  "event_type": "error",
  "error": {
    "message": "Failed to get completed interaction: Result not found.",
    "code": "not_found"
  }
}

단계 시작

{
  "event_type": "step.start",
  "index": 0,
  "step": {
    "type": "model_output"
  }
}

걸음 수 델타

{
  "event_type": "step.delta",
  "index": 0,
  "delta": {
    "type": "text",
    "text": "Hello"
  }
}

단계 중지

{
  "event_type": "step.stop",
  "index": 0
}