Gemini API

Gemini Interactions API là một API thử nghiệm cho phép nhà phát triển tạo các ứng dụng AI tạo sinh bằng mô hình Gemini. Gemini là mô hình mạnh nhất của chúng tôi, được xây dựng từ đầu theo hướng đa phương thức. Mô hình này có thể tổng quát hoá và hiểu một cách liền mạch, vận hành và kết hợp nhiều loại thông tin, bao gồm cả ngôn ngữ, hình ảnh, âm thanh, video và mã. Bạn có thể sử dụng Gemini API cho các trường hợp sử dụng như suy luận trên văn bản và hình ảnh, tạo nội dung, tác nhân đối thoại, hệ thống tóm tắt và phân loại, v.v.

Xem dưới dạng markdown Xem OpenAPI Spec

Tạo một hoạt động tương tác

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

Tạo một lượt tương tác mới.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

model ModelOption  (không bắt buộc)

Tên của "Mô hình" dùng để tạo lượt tương tác.
Bắt buộc nếu bạn không cung cấp "nhân viên hỗ trợ".

Các giá trị có thể có:

  • gemini-2.5-flash

    Mô hình suy luận kết hợp đầu tiên của chúng tôi hỗ trợ cửa sổ ngữ cảnh 1 triệu token và có ngân sách tư duy.

  • gemini-2.5-flash-image

    Mô hình tạo hình ảnh gốc của chúng tôi, được tối ưu hoá về tốc độ, tính linh hoạt và khả năng hiểu ngữ cảnh. Giá của văn bản đầu vào và đầu ra giống như giá của 2,5 Flash.

  • gemini-2.5-flash-lite

    Mô hình nhỏ nhất và tiết kiệm chi phí nhất của chúng tôi, được xây dựng để sử dụng ở quy mô lớn.

  • gemini-2.5-flash-lite-preview-09-2025

    Mô hình mới nhất dựa trên Gemini 2.5 Flash lite, được tối ưu hoá để tiết kiệm chi phí, có thông lượng cao và chất lượng cao.

  • gemini-2.5-flash-native-audio-preview-12-2025

    Các mô hình âm thanh gốc của chúng tôi được tối ưu hoá để mang đến đầu ra âm thanh chất lượng cao hơn với nhịp điệu, giọng nói tự nhiên, mức độ chi tiết và tâm trạng tốt hơn.

  • gemini-2.5-flash-preview-09-2025

    Mô hình mới nhất dựa trên mô hình 2.5 Flash. 2.5 Flash Preview phù hợp nhất với các tác vụ xử lý quy mô lớn, độ trễ thấp, khối lượng lớn đòi hỏi khả năng tư duy và các trường hợp sử dụng có tác nhân.

  • gemini-2.5-flash-preview-tts

    Mô hình chuyển văn bản sang lời nói 2.5 Flash được tối ưu hoá để tạo lời nói mạnh mẽ, có độ trễ thấp và có thể kiểm soát.

  • gemini-2.5-pro

    Mô hình đa năng tiên tiến của chúng tôi, có khả năng vượt trội trong việc lập trình và xử lý các nhiệm vụ suy luận phức tạp.

  • gemini-2.5-pro-preview-tts

    Mô hình âm thanh chuyển văn bản sang lời nói 2.5 Pro của chúng tôi được tối ưu hoá để tạo lời nói mạnh mẽ với độ trễ thấp, giúp tạo ra kết quả tự nhiên hơn và dễ dàng điều hướng các câu lệnh.

  • gemini-3-flash-preview

    Mô hình thông minh nhất của chúng tôi được tối ưu hoá về tốc độ, kết hợp trí thông minh đột phá với khả năng tìm kiếm và liên kết thực tế vượt trội.

  • gemini-3-pro-image-preview

    Mô hình tạo hình ảnh và chỉnh sửa hình ảnh tiên tiến.

  • gemini-3-pro-preview

    Mô hình thông minh nhất của chúng tôi với khả năng suy luận và hiểu đa phương thức tiên tiến, cùng các tính năng tác nhân và lập trình theo cảm hứng mạnh mẽ.

  • gemini-3.1-pro-preview

    Mô hình suy luận SOTA mới nhất của chúng tôi với độ sâu và sắc thái chưa từng có, cùng khả năng hiểu đa phương thức và lập trình mạnh mẽ.

  • gemini-3.1-flash-image-preview

    Trí tuệ thị giác cấp chuyên nghiệp với tốc độ phản hồi và hiệu quả của bản Flash, cùng khả năng tạo nội dung dựa trên thực tế.

Mô hình sẽ hoàn thành câu lệnh của bạn.\n\nHãy xem [các mô hình](https://ai.google.dev/gemini-api/docs/models) để biết thêm thông tin chi tiết.

agent AgentOption  (không bắt buộc)

Tên của "Nhân viên hỗ trợ" được dùng để tạo lượt tương tác.
Bắt buộc nếu bạn không cung cấp "model".

Các giá trị có thể có:

  • deep-research-pro-preview-12-2025

    Tác nhân Deep Research của Gemini

Nhân viên hỗ trợ để tương tác.

input Content hoặc mảng (Content) hoặc mảng (Turn) hoặc string  (bắt buộc)

Đầu vào cho hoạt động tương tác (giống nhau đối với cả Mô hình và Agent).

system_instruction string  (không bắt buộc)

Hướng dẫn của hệ thống cho lượt tương tác.

tools mảng (Tool)  (không bắt buộc)

Danh sách các khai báo công cụ mà mô hình có thể gọi trong quá trình tương tác.

response_format object  (không bắt buộc)

Thực thi để phản hồi được tạo là một đối tượng JSON tuân thủ giản đồ JSON được chỉ định trong trường này.

response_mime_type string  (không bắt buộc)

Loại MIME của phản hồi. Bạn phải cung cấp thông tin này nếu đã đặt response_format.

stream boolean  (không bắt buộc)

Chỉ có đầu vào. Liệu hoạt động tương tác có được phát trực tiếp hay không.

store boolean  (không bắt buộc)

Chỉ có đầu vào. Có lưu trữ phản hồi và yêu cầu để truy xuất sau này hay không.

background boolean  (không bắt buộc)

Chỉ có đầu vào. Có chạy hoạt động tương tác mô hình ở chế độ nền hay không.

generation_config GenerationConfig  (không bắt buộc)

Cấu hình mô hình
Các thông số cấu hình cho hoạt động tương tác của mô hình.
Phương án thay thế cho "agent_config". Chỉ áp dụng khi bạn đặt "model".

Thông số cấu hình cho các lượt tương tác với mô hình.

Trường

temperature number  (không bắt buộc)

Kiểm soát tính ngẫu nhiên của kết quả.

top_p number  (không bắt buộc)

Xác suất tích luỹ tối đa của các mã thông báo cần xem xét khi lấy mẫu.

seed integer  (không bắt buộc)

Dữ liệu gốc được dùng trong quá trình giải mã để có thể tái tạo.

stop_sequences mảng (chuỗi)  (không bắt buộc)

Danh sách các chuỗi ký tự sẽ dừng tương tác đầu ra.

thinking_level ThinkingLevel  (không bắt buộc)

Mức độ của mã thông báo suy nghĩ mà mô hình sẽ tạo.

Các giá trị có thể có:

  • minimal
  • low
  • medium
  • high

thinking_summaries ThinkingSummaries  (không bắt buộc)

Có nên đưa bản tóm tắt suy nghĩ vào câu trả lời hay không.

Các giá trị có thể có:

  • auto
  • none

max_output_tokens số nguyên  (không bắt buộc)

Số lượng mã thông báo tối đa cần đưa vào phản hồi.

speech_config SpeechConfig  (không bắt buộc)

Cấu hình cho hoạt động tương tác bằng lời nói.

Cấu hình cho hoạt động tương tác bằng lời nói.

Trường

voice string  (không bắt buộc)

Giọng nói của người nói.

language string  (không bắt buộc)

Ngôn ngữ của lời nói.

speaker string  (không bắt buộc)

Tên của người nói, tên này phải khớp với tên người nói trong câu lệnh.

image_config ImageConfig  (không bắt buộc)

Cấu hình cho hoạt động tương tác với hình ảnh.

Cấu hình cho hoạt động tương tác với hình ảnh.

Trường

aspect_ratio enum (string)  (không bắt buộc)

Không có mô tả nào được cung cấp.

Các giá trị có thể có:

  • 1:1
  • 2:3
  • 3:2
  • 3:4
  • 4:3
  • 4:5
  • 5:4
  • 9:16
  • 16:9
  • 21:9
  • 1:8
  • 8:1
  • 1:4
  • 4:1
image_size enum (string)  (không bắt buộc)

Không có mô tả nào được cung cấp.

Các giá trị có thể có:

  • 1K
  • 2K
  • 4K
  • 512
tool_choice ToolChoiceConfig hoặc ToolChoiceType  (không bắt buộc)

Lựa chọn về công cụ cho hoạt động tương tác.

agent_config object  (không bắt buộc)

Cấu hình tác nhân
Cấu hình cho tác nhân.
Phương án thay thế cho "generation_config". Chỉ áp dụng khi bạn đặt "agent".

Các loại có thể có

Phân biệt đối xử đa hình: type

DynamicAgentConfig

Cấu hình cho các tác nhân động.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "dynamic".

DeepResearchAgentConfig

Cấu hình cho tác nhân Deep Research.

thinking_summaries ThinkingSummaries  (không bắt buộc)

Có nên đưa bản tóm tắt suy nghĩ vào câu trả lời hay không.

Các giá trị có thể có:

  • auto
  • none

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "deep-research".

previous_interaction_id string  (không bắt buộc)

Mã của lượt tương tác trước đó (nếu có).

response_modalities ResponseModality  (không bắt buộc)

Các phương thức phản hồi được yêu cầu (VĂN BẢN, HÌNH ẢNH, ÂM THANH).

Các giá trị có thể có:

  • text
  • image
  • audio

Phản hồi

Trả về tài nguyên Tương tác.

Yêu cầu đơn giản

Ví dụ về phản hồi

{
  "created": "2025-11-26T12:25:15Z",
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm functioning perfectly and ready to assist you.\n\nHow are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-11-26T12:25:15Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 20,
    "total_thought_tokens": 22,
    "total_tokens": 49,
    "total_tool_use_tokens": 0
  }
}

Nhiều lượt

Ví dụ về phản hồi

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "The capital of France is Paris."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 50
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 50,
    "total_output_tokens": 10,
    "total_thought_tokens": 0,
    "total_tokens": 60,
    "total_tool_use_tokens": 0
  }
}

Đầu vào hình ảnh

Ví dụ về phản hồi

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "A white humanoid robot with glowing blue eyes stands holding a red skateboard."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 10
      },
      {
        "modality": "image",
        "tokens": 258
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 268,
    "total_output_tokens": 20,
    "total_thought_tokens": 0,
    "total_tokens": 288,
    "total_tool_use_tokens": 0
  }
}

Gọi hàm

Ví dụ về phản hồi

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "requires_action",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "function_call",
      "id": "gth23981",
      "name": "get_weather",
      "arguments": {
        "location": "Boston, MA"
      }
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 100
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 100,
    "total_output_tokens": 25,
    "total_thought_tokens": 0,
    "total_tokens": 125,
    "total_tool_use_tokens": 50
  }
}

Deep Research

Ví dụ về phản hồi

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "agent",
  "outputs": [
    {
      "type": "text",
      "text": "Here is a comprehensive research report on the current state of cancer research..."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 20
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 20,
    "total_output_tokens": 1000,
    "total_thought_tokens": 500,
    "total_tokens": 1520,
    "total_tool_use_tokens": 0
  }
}

Truy xuất một lượt tương tác

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

Truy xuất thông tin chi tiết đầy đủ về một lượt tương tác dựa trên `Interaction.id`.

Tham số đường dẫn / truy vấn

id string  (bắt buộc)

Giá trị nhận dạng duy nhất của lượt tương tác cần truy xuất.

stream boolean  (không bắt buộc)

Nếu bạn đặt chính sách này thành true, thì nội dung được tạo sẽ được truyền trực tuyến theo gia số.

Mặc định là: False

last_event_id string  (không bắt buộc)

Không bắt buộc. Nếu được đặt, sẽ tiếp tục luồng tương tác từ đoạn tiếp theo sau sự kiện được đánh dấu bằng mã sự kiện. Chỉ có thể dùng nếu `stream` là true.

include_input boolean  (không bắt buộc)

Nếu được đặt thành true, thì sẽ thêm thông tin đầu vào vào phản hồi.

Mặc định là: False

api_version string  (không bắt buộc)

Nên dùng phiên bản API nào.

Phản hồi

Trả về tài nguyên Tương tác.

Nhận lượt tương tác

Ví dụ về phản hồi

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "I'm doing great, thank you for asking! How can I help you today?"
    }
  ]
}

Xoá một lượt tương tác

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

Xoá lượt tương tác theo mã nhận dạng.

Tham số đường dẫn / truy vấn

id string  (bắt buộc)

Giá trị nhận dạng riêng biệt của lượt tương tác cần xoá.

api_version string  (không bắt buộc)

Nên dùng phiên bản API nào.

Phản hồi

Nếu thành công, phản hồi sẽ trống.

Xoá lượt tương tác

Huỷ một lượt tương tác

post https://generativelanguage.googleapis.com/v1beta/interactions/{id}/cancel

Huỷ một lượt tương tác theo mã nhận dạng. Điều này chỉ áp dụng cho những hoạt động tương tác ở chế độ nền vẫn đang chạy.

Tham số đường dẫn / truy vấn

id string  (bắt buộc)

Giá trị nhận dạng riêng biệt của thao tác cần huỷ.

api_version string  (không bắt buộc)

Nên dùng phiên bản API nào.

Phản hồi

Trả về tài nguyên Tương tác.

Huỷ lượt tương tác

Ví dụ về phản hồi

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "cancelled",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "agent"
}

Tài nguyên

Tương tác

Tài nguyên Interaction.

Trường

model ModelOption  (không bắt buộc)

Tên của "Mô hình" dùng để tạo lượt tương tác.

Các giá trị có thể có:

  • gemini-2.5-flash

    Mô hình suy luận kết hợp đầu tiên của chúng tôi hỗ trợ cửa sổ ngữ cảnh 1 triệu token và có ngân sách tư duy.

  • gemini-2.5-flash-image

    Mô hình tạo hình ảnh gốc của chúng tôi, được tối ưu hoá về tốc độ, tính linh hoạt và khả năng hiểu ngữ cảnh. Giá của văn bản đầu vào và đầu ra giống như giá của 2,5 Flash.

  • gemini-2.5-flash-lite

    Mô hình nhỏ nhất và tiết kiệm chi phí nhất của chúng tôi, được xây dựng để sử dụng ở quy mô lớn.

  • gemini-2.5-flash-lite-preview-09-2025

    Mô hình mới nhất dựa trên Gemini 2.5 Flash lite, được tối ưu hoá để tiết kiệm chi phí, có thông lượng cao và chất lượng cao.

  • gemini-2.5-flash-native-audio-preview-12-2025

    Các mô hình âm thanh gốc của chúng tôi được tối ưu hoá để mang đến đầu ra âm thanh chất lượng cao hơn với nhịp điệu, giọng nói tự nhiên, mức độ chi tiết và tâm trạng tốt hơn.

  • gemini-2.5-flash-preview-09-2025

    Mô hình mới nhất dựa trên mô hình 2.5 Flash. 2.5 Flash Preview phù hợp nhất với các tác vụ xử lý quy mô lớn, độ trễ thấp, khối lượng lớn đòi hỏi khả năng tư duy và các trường hợp sử dụng có tác nhân.

  • gemini-2.5-flash-preview-tts

    Mô hình chuyển văn bản sang lời nói 2.5 Flash được tối ưu hoá để tạo lời nói mạnh mẽ, có độ trễ thấp và có thể kiểm soát.

  • gemini-2.5-pro

    Mô hình đa năng tiên tiến của chúng tôi, có khả năng vượt trội trong việc lập trình và xử lý các nhiệm vụ suy luận phức tạp.

  • gemini-2.5-pro-preview-tts

    Mô hình âm thanh chuyển văn bản sang lời nói 2.5 Pro của chúng tôi được tối ưu hoá để tạo lời nói mạnh mẽ với độ trễ thấp, giúp tạo ra kết quả tự nhiên hơn và dễ dàng điều hướng các câu lệnh.

  • gemini-3-flash-preview

    Mô hình thông minh nhất của chúng tôi được tối ưu hoá về tốc độ, kết hợp trí thông minh đột phá với khả năng tìm kiếm và liên kết thực tế vượt trội.

  • gemini-3-pro-image-preview

    Mô hình tạo hình ảnh và chỉnh sửa hình ảnh tiên tiến.

  • gemini-3-pro-preview

    Mô hình thông minh nhất của chúng tôi với khả năng suy luận và hiểu đa phương thức tiên tiến, cùng các tính năng tác nhân và lập trình theo cảm hứng mạnh mẽ.

  • gemini-3.1-pro-preview

    Mô hình suy luận SOTA mới nhất của chúng tôi với độ sâu và sắc thái chưa từng có, cùng khả năng hiểu đa phương thức và lập trình mạnh mẽ.

  • gemini-3.1-flash-image-preview

    Trí tuệ thị giác cấp chuyên nghiệp với tốc độ phản hồi và hiệu quả của bản Flash, cùng khả năng tạo nội dung dựa trên thực tế.

Mô hình sẽ hoàn thành câu lệnh của bạn.\n\nHãy xem [các mô hình](https://ai.google.dev/gemini-api/docs/models) để biết thêm thông tin chi tiết.

agent AgentOption  (không bắt buộc)

Tên của "Nhân viên hỗ trợ" được dùng để tạo lượt tương tác.

Các giá trị có thể có:

  • deep-research-pro-preview-12-2025

    Tác nhân Deep Research của Gemini

Nhân viên hỗ trợ để tương tác.

id string  (không bắt buộc)

Chỉ có đầu ra. Giá trị nhận dạng riêng biệt cho lượt hoàn tất tương tác.

status enum (string)  (không bắt buộc)

Chỉ có đầu ra. Trạng thái của lượt tương tác.

Các giá trị có thể có:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
created string  (không bắt buộc)

Chỉ có đầu ra. Thời gian tạo phản hồi ở định dạng ISO 8601 (YYYY-MM-DDThh:mm:ssZ).

updated string  (không bắt buộc)

Chỉ có đầu ra. Thời gian cập nhật phản hồi gần đây nhất ở định dạng ISO 8601 (YYYY-MM-DDThh:mm:ssZ).

role string  (không bắt buộc)

Chỉ có đầu ra. Vai trò của lượt tương tác.

outputs mảng (Nội dung)  (không bắt buộc)

Chỉ có đầu ra. Câu trả lời của mô hình.

system_instruction string  (không bắt buộc)

Hướng dẫn của hệ thống cho lượt tương tác.

tools mảng (Tool)  (không bắt buộc)

Danh sách các khai báo công cụ mà mô hình có thể gọi trong quá trình tương tác.

usage Usage  (không bắt buộc)

Chỉ có đầu ra. Số liệu thống kê về việc sử dụng mã thông báo của yêu cầu tương tác.

Số liệu thống kê về việc sử dụng mã thông báo của yêu cầu tương tác.

Trường

total_input_tokens số nguyên  (không bắt buộc)

Số lượng mã thông báo trong câu lệnh (ngữ cảnh).

input_tokens_by_modality ModalityTokens  (không bắt buộc)

Thông tin chi tiết về mức sử dụng token đầu vào theo phương thức.

Số lượng mã thông báo cho một phương thức phản hồi duy nhất.

Trường

phương thức ResponseModality  (không bắt buộc)

Phương thức liên kết với số lượng mã thông báo.

Các giá trị có thể có:

  • text
  • image
  • audio

tokens integer  (không bắt buộc)

Số lượng mã thông báo cho phương thức.

total_cached_tokens integer  (không bắt buộc)

Số lượng mã thông báo trong phần được lưu vào bộ nhớ đệm của câu lệnh (nội dung được lưu vào bộ nhớ đệm).

cached_tokens_by_modality ModalityTokens  (không bắt buộc)

Bảng chi tiết về việc sử dụng mã thông báo được lưu vào bộ nhớ đệm theo phương thức.

Số lượng mã thông báo cho một phương thức phản hồi duy nhất.

Trường

phương thức ResponseModality  (không bắt buộc)

Phương thức liên kết với số lượng mã thông báo.

Các giá trị có thể có:

  • text
  • image
  • audio

tokens integer  (không bắt buộc)

Số lượng mã thông báo cho phương thức.

total_output_tokens integer  (không bắt buộc)

Tổng số mã thông báo trong tất cả các câu trả lời được tạo.

output_tokens_by_modality ModalityTokens  (không bắt buộc)

Thông tin chi tiết về việc sử dụng mã thông báo đầu ra theo phương thức.

Số lượng mã thông báo cho một phương thức phản hồi duy nhất.

Trường

phương thức ResponseModality  (không bắt buộc)

Phương thức liên kết với số lượng mã thông báo.

Các giá trị có thể có:

  • text
  • image
  • audio

tokens integer  (không bắt buộc)

Số lượng mã thông báo cho phương thức.

total_tool_use_tokens integer  (không bắt buộc)

Số lượng mã thông báo có trong(các) câu lệnh sử dụng công cụ.

tool_use_tokens_by_modality ModalityTokens  (không bắt buộc)

Bảng chi tiết về việc sử dụng mã thông báo sử dụng công cụ theo phương thức.

Số lượng mã thông báo cho một phương thức phản hồi duy nhất.

Trường

phương thức ResponseModality  (không bắt buộc)

Phương thức liên kết với số lượng mã thông báo.

Các giá trị có thể có:

  • text
  • image
  • audio

tokens integer  (không bắt buộc)

Số lượng mã thông báo cho phương thức.

total_thought_tokens integer  (không bắt buộc)

Số lượng mã thông báo về suy nghĩ đối với mô hình tư duy.

total_tokens integer  (không bắt buộc)

Tổng số mã thông báo cho yêu cầu tương tác (lời nhắc + câu trả lời + các mã thông báo nội bộ khác).

response_modalities ResponseModality  (không bắt buộc)

Các phương thức phản hồi được yêu cầu (VĂN BẢN, HÌNH ẢNH, ÂM THANH).

Các giá trị có thể có:

  • text
  • image
  • audio

response_format object  (không bắt buộc)

Thực thi để phản hồi được tạo là một đối tượng JSON tuân thủ giản đồ JSON được chỉ định trong trường này.

response_mime_type string  (không bắt buộc)

Loại MIME của phản hồi. Bạn phải cung cấp thông tin này nếu đã đặt response_format.

previous_interaction_id string  (không bắt buộc)

Mã của lượt tương tác trước đó (nếu có).

input Content hoặc mảng (Content) hoặc mảng (Turn) hoặc string  (bắt buộc)

Đầu vào cho hoạt động tương tác (giống nhau đối với cả Mô hình và Agent).

agent_config object  (không bắt buộc)

Thông số cấu hình cho hoạt động tương tác của nhân viên hỗ trợ.

Các loại có thể có

Phân biệt đối xử đa hình: type

DynamicAgentConfig

Cấu hình cho các tác nhân động.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "dynamic".

DeepResearchAgentConfig

Cấu hình cho tác nhân Deep Research.

thinking_summaries ThinkingSummaries  (không bắt buộc)

Có nên đưa bản tóm tắt suy nghĩ vào câu trả lời hay không.

Các giá trị có thể có:

  • auto
  • none

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "deep-research".

Ví dụ

Ví dụ:

{
  "created": "2025-12-04T15:01:45Z",
  "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-12-04T15:01:45Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 23,
    "total_thought_tokens": 49,
    "total_tokens": 79,
    "total_tool_use_tokens": 0
  }
}

Mô hình dữ liệu

Nội dung

Nội dung của câu trả lời.

Các loại có thể có

Phân biệt đối xử đa hình: type

TextContent

Một khối nội dung văn bản.

text string  (bắt buộc)

Nội dung văn bản.

annotations Chú thích  (không bắt buộc)

Thông tin trích dẫn cho nội dung do mô hình tạo.

Thông tin trích dẫn cho nội dung do mô hình tạo.

Các loại có thể có

Phân biệt đối xử đa hình: type

UrlCitation

Chú thích trích dẫn URL.

url string  (không bắt buộc)

URL.

title string  (không bắt buộc)

Tiêu đề của URL.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "url_citation".

start_index integer  (không bắt buộc)

Điểm bắt đầu của đoạn phản hồi được phân bổ cho nguồn này.

end_index integer  (không bắt buộc)

Kết thúc phân đoạn được phân bổ, không bao gồm.

FileCitation

Chú thích trích dẫn tệp.

document_uri string  (không bắt buộc)

URI của tệp.

file_name string  (không bắt buộc)

Tên của tệp.

source string  (không bắt buộc)

Nguồn được ghi công cho một phần văn bản.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "file_citation".

start_index integer  (không bắt buộc)

Điểm bắt đầu của đoạn phản hồi được phân bổ cho nguồn này.

end_index integer  (không bắt buộc)

Kết thúc phân đoạn được phân bổ, không bao gồm.

PlaceCitation

Chú giải trích dẫn địa điểm.

place_id string  (không bắt buộc)

Mã nhận dạng của địa điểm, ở định dạng "places/{place_id}".

name string  (không bắt buộc)

Tên của địa điểm.

url string  (không bắt buộc)

URI tham chiếu của địa điểm.

review_snippets ReviewSnippet  (không bắt buộc)

Đoạn trích trong bài đánh giá được dùng để tạo câu trả lời về các tính năng của một địa điểm cụ thể trên Google Maps.

Đóng gói một đoạn trích trong bài đánh giá của người dùng để trả lời một câu hỏi về các tính năng của một địa điểm cụ thể trong Google Maps.

Trường

title string  (không bắt buộc)

Tiêu đề của bài đánh giá.

url string  (không bắt buộc)

Đường liên kết tương ứng với bài đánh giá của người dùng trên Google Maps.

review_id string  (không bắt buộc)

Mã của đoạn trích thông tin đánh giá.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "place_citation".

start_index integer  (không bắt buộc)

Điểm bắt đầu của đoạn phản hồi được phân bổ cho nguồn này.

end_index integer  (không bắt buộc)

Kết thúc phân đoạn được phân bổ, không bao gồm.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "text".

ImageContent

Một khối nội dung hình ảnh.

data string  (không bắt buộc)

Nội dung hình ảnh.

uri string  (không bắt buộc)

URI của hình ảnh.

mime_type enum (string)  (không bắt buộc)

Loại MIME của hình ảnh.

Các giá trị có thể có:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (không bắt buộc)

Độ phân giải của nội dung nghe nhìn.

Các giá trị có thể có:

  • low
  • medium
  • high
  • ultra_high

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "image".

AudioContent

Một khối nội dung âm thanh.

data string  (không bắt buộc)

Nội dung âm thanh.

uri string  (không bắt buộc)

URI của âm thanh.

mime_type enum (string)  (không bắt buộc)

Loại MIME của âm thanh.

Các giá trị có thể có:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "audio".

DocumentContent

Một khối nội dung tài liệu.

data string  (không bắt buộc)

Nội dung của tài liệu.

uri string  (không bắt buộc)

URI của tài liệu.

mime_type enum (string)  (không bắt buộc)

Loại MIME của tài liệu.

Các giá trị có thể có:

  • application/pdf
type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "document".

VideoContent

Một khối nội dung video.

data string  (không bắt buộc)

Nội dung video.

uri string  (không bắt buộc)

URI của video.

mime_type enum (string)  (không bắt buộc)

Loại MIME của video.

Các giá trị có thể có:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (không bắt buộc)

Độ phân giải của nội dung nghe nhìn.

Các giá trị có thể có:

  • low
  • medium
  • high
  • ultra_high

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "video".

ThoughtContent

Một khối nội dung về suy nghĩ.

chữ ký chuỗi  (không bắt buộc)

Chữ ký khớp với nguồn phụ trợ sẽ là một phần của quá trình tạo.

summary ThoughtSummaryContent  (không bắt buộc)

Tóm tắt suy nghĩ.

Các loại có thể có

Phân biệt đối xử đa hình: type

TextContent

Một khối nội dung văn bản.

text string  (bắt buộc)

Nội dung văn bản.

annotations Chú thích  (không bắt buộc)

Thông tin trích dẫn cho nội dung do mô hình tạo.

Thông tin trích dẫn cho nội dung do mô hình tạo.

Các loại có thể có

Phân biệt đối xử đa hình: type

UrlCitation

Chú thích trích dẫn URL.

url string  (không bắt buộc)

URL.

title string  (không bắt buộc)

Tiêu đề của URL.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "url_citation".

start_index integer  (không bắt buộc)

Điểm bắt đầu của đoạn phản hồi được phân bổ cho nguồn này.

end_index integer  (không bắt buộc)

Kết thúc phân đoạn được phân bổ, không bao gồm.

FileCitation

Chú thích trích dẫn tệp.

document_uri string  (không bắt buộc)

URI của tệp.

file_name string  (không bắt buộc)

Tên của tệp.

source string  (không bắt buộc)

Nguồn được ghi công cho một phần văn bản.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "file_citation".

start_index integer  (không bắt buộc)

Điểm bắt đầu của đoạn phản hồi được phân bổ cho nguồn này.

end_index integer  (không bắt buộc)

Kết thúc phân đoạn được phân bổ, không bao gồm.

PlaceCitation

Chú giải trích dẫn địa điểm.

place_id string  (không bắt buộc)

Mã nhận dạng của địa điểm, ở định dạng "places/{place_id}".

name string  (không bắt buộc)

Tên của địa điểm.

url string  (không bắt buộc)

URI tham chiếu của địa điểm.

review_snippets ReviewSnippet  (không bắt buộc)

Đoạn trích trong bài đánh giá được dùng để tạo câu trả lời về các tính năng của một địa điểm cụ thể trên Google Maps.

Đóng gói một đoạn trích trong bài đánh giá của người dùng để trả lời một câu hỏi về các tính năng của một địa điểm cụ thể trong Google Maps.

Trường

title string  (không bắt buộc)

Tiêu đề của bài đánh giá.

url string  (không bắt buộc)

Đường liên kết tương ứng với bài đánh giá của người dùng trên Google Maps.

review_id string  (không bắt buộc)

Mã của đoạn trích thông tin đánh giá.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "place_citation".

start_index integer  (không bắt buộc)

Điểm bắt đầu của đoạn phản hồi được phân bổ cho nguồn này.

end_index integer  (không bắt buộc)

Kết thúc phân đoạn được phân bổ, không bao gồm.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "text".

ImageContent

Một khối nội dung hình ảnh.

data string  (không bắt buộc)

Nội dung hình ảnh.

uri string  (không bắt buộc)

URI của hình ảnh.

mime_type enum (string)  (không bắt buộc)

Loại MIME của hình ảnh.

Các giá trị có thể có:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (không bắt buộc)

Độ phân giải của nội dung nghe nhìn.

Các giá trị có thể có:

  • low
  • medium
  • high
  • ultra_high

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "image".

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "thought".

FunctionCallContent

Một khối nội dung lệnh gọi công cụ hàm.

name string  (bắt buộc)

Tên của công cụ cần gọi.

arguments object  (bắt buộc)

Các đối số cần truyền vào hàm.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "function_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

FunctionResultContent

Một khối nội dung kết quả của công cụ hàm.

name string  (không bắt buộc)

Tên của công cụ đã được gọi.

is_error boolean  (không bắt buộc)

Liệu lệnh gọi công cụ có dẫn đến lỗi hay không.

result array (FunctionResultSubcontent) hoặc string  (bắt buộc)

Kết quả của lệnh gọi công cụ.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "function_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong khối lệnh gọi hàm.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

CodeExecutionCallContent

Nội dung thực thi mã.

arguments CodeExecutionCallArguments  (bắt buộc)

Các đối số cần truyền đến quá trình thực thi mã.

Các đối số cần truyền đến quá trình thực thi mã.

Trường

language enum (string)  (không bắt buộc)

Ngôn ngữ lập trình của "code".

Các giá trị có thể có:

  • python
code string  (không bắt buộc)

Mã cần thực thi.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "code_execution_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

CodeExecutionResultContent

Nội dung kết quả thực thi mã.

result string  (bắt buộc)

Kết quả của quá trình thực thi mã.

is_error boolean  (không bắt buộc)

Liệu quá trình thực thi mã có dẫn đến lỗi hay không.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "code_execution_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong khối lệnh gọi thực thi mã.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

UrlContextCallContent

Nội dung theo bối cảnh của URL.

arguments UrlContextCallArguments  (bắt buộc)

Các đối số cần truyền đến ngữ cảnh URL.

Các đối số cần truyền đến ngữ cảnh URL.

Trường

urls mảng (chuỗi)  (không bắt buộc)

Các URL cần tìm nạp.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "url_context_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

UrlContextResultContent

Nội dung kết quả theo bối cảnh URL.

result UrlContextResult  (bắt buộc)

Kết quả của bối cảnh URL.

Kết quả của ngữ cảnh URL.

Trường

url string  (không bắt buộc)

URL đã được tìm nạp.

status enum (string)  (không bắt buộc)

Trạng thái truy xuất URL.

Các giá trị có thể có:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (không bắt buộc)

Liệu bối cảnh URL có gây ra lỗi hay không.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "url_context_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong khối lệnh gọi ngữ cảnh url.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

GoogleSearchCallContent

Nội dung trên Google Tìm kiếm.

arguments GoogleSearchCallArguments  (bắt buộc)

Các đối số cần truyền đến Google Tìm kiếm.

Các đối số cần truyền đến Google Tìm kiếm.

Trường

queries array (string)  (không bắt buộc)

Cụm từ tìm kiếm trên web để tìm kiếm trên web sau đó.

search_type enum (string)  (không bắt buộc)

Loại thông tin liên kết thực tế được bật cho hoạt động tìm kiếm.

Các giá trị có thể có:

  • web_search
  • image_search
type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "google_search_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

GoogleSearchResultContent

Nội dung trong kết quả tìm kiếm trên Google.

result GoogleSearchResult  (bắt buộc)

Kết quả của Google Tìm kiếm.

Kết quả của Google Tìm kiếm.

Trường

search_suggestions string  (không bắt buộc)

Đoạn nội dung trên web có thể được nhúng vào một trang web hoặc webview của ứng dụng.

is_error boolean  (không bắt buộc)

Liệu Google Tìm kiếm có xảy ra lỗi hay không.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "google_search_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong lệnh chặn cuộc gọi trên Google Tìm kiếm.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

McpServerToolCallContent

Nội dung lệnh gọi công cụ MCPServer.

name string  (bắt buộc)

Tên của công cụ đã được gọi.

server_name string  (bắt buộc)

Tên của máy chủ MCP được dùng.

arguments object  (bắt buộc)

Đối tượng JSON của các đối số cho hàm.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "mcp_server_tool_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

McpServerToolResultContent

Nội dung kết quả của công cụ MCPServer.

name string  (không bắt buộc)

Tên của công cụ được gọi cho lệnh gọi công cụ cụ thể này.

server_name string  (không bắt buộc)

Tên của máy chủ MCP được dùng.

result array (FunctionResultSubcontent) hoặc string  (bắt buộc)

Đầu ra từ lệnh gọi máy chủ MCP. Có thể là văn bản đơn giản hoặc nội dung đa dạng thức.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "mcp_server_tool_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong khối lệnh gọi công cụ máy chủ MCP.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

FileSearchCallContent

Nội dung tìm kiếm tệp.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "file_search_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

FileSearchResultContent

Nội dung kết quả tìm kiếm tệp.

result FileSearchResult  (không bắt buộc)

Kết quả của tính năng Tìm kiếm tệp.

Kết quả của tính năng Tìm kiếm tệp.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "file_search_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong lệnh gọi chặn tìm kiếm tệp.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

GoogleMapsCallContent

Nội dung trên Google Maps.

arguments GoogleMapsCallArguments  (không bắt buộc)

Các đối số cần truyền đến công cụ Google Maps.

Các đối số cần truyền đến công cụ Google Maps.

Trường

queries array (string)  (không bắt buộc)

Các truy vấn sẽ được thực thi.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "google_maps_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

GoogleMapsResultContent

Nội dung kết quả trên Google Maps.

result GoogleMapsResult  (bắt buộc)

Kết quả của Google Maps.

Kết quả của Google Maps.

Trường

địa điểm Địa điểm  (không bắt buộc)

Những địa điểm được tìm thấy.

Trường

place_id string  (không bắt buộc)

Mã nhận dạng của địa điểm, ở định dạng "places/{place_id}".

name string  (không bắt buộc)

Tên của địa điểm.

url string  (không bắt buộc)

URI tham chiếu của địa điểm.

review_snippets ReviewSnippet  (không bắt buộc)

Đoạn trích trong bài đánh giá được dùng để tạo câu trả lời về các tính năng của một địa điểm cụ thể trên Google Maps.

Đóng gói một đoạn trích trong bài đánh giá của người dùng để trả lời một câu hỏi về các tính năng của một địa điểm cụ thể trong Google Maps.

Trường

title string  (không bắt buộc)

Tiêu đề của bài đánh giá.

url string  (không bắt buộc)

Đường liên kết tương ứng với bài đánh giá của người dùng trên Google Maps.

review_id string  (không bắt buộc)

Mã của đoạn trích thông tin đánh giá.

widget_context_token string  (không bắt buộc)

Tên tài nguyên của mã thông báo bối cảnh tiện ích Google Maps.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "google_maps_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong khối lệnh gọi Google Maps.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

Ví dụ

Văn bản

{
  "type": "text",
  "text": "Hello, how are you?"
}

Hình ảnh

{
  "type": "image",
  "data": "BASE64_ENCODED_IMAGE",
  "mime_type": "image/png"
}

Âm thanh

{
  "type": "audio",
  "data": "BASE64_ENCODED_AUDIO",
  "mime_type": "audio/wav"
}

Tài liệu

{
  "type": "document",
  "data": "BASE64_ENCODED_DOCUMENT",
  "mime_type": "application/pdf"
}

Video

{
  "type": "video",
  "uri": "https://www.youtube.com/watch?v=9hE5-98ZeCg"
}

Suy nghĩ

{
  "type": "thought",
  "summary": [
    {
      "type": "text",
      "text": "The user is asking about the weather. I should use the get_weather tool."
    }
  ],
  "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh"
}

Lệnh gọi hàm

{
  "type": "function_call",
  "name": "get_weather",
  "id": "gth23981",
  "arguments": {
    "location": "Boston, MA"
  }
}

Kết quả hàm

{
  "type": "function_result",
  "name": "get_weather",
  "call_id": "gth23981",
  "result": [
    {
      "type": "text",
      "text": "{\"weather\":\"sunny\"}"
    }
  ]
}

Lệnh gọi thực thi mã

{
  "type": "code_execution_call",
  "id": "call_123456",
  "arguments": {
    "language": "python",
    "code": "print('hello world')"
  }
}

Kết quả thực thi mã

{
  "type": "code_execution_result",
  "call_id": "call_123456",
  "result": "hello world"
}

Lệnh gọi bối cảnh URL

{
  "type": "url_context_call",
  "id": "call_123456",
  "arguments": {
    "urls": [
      "https://www.example.com"
    ]
  }
}

Kết quả theo bối cảnh URL

{
  "type": "url_context_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.example.com",
      "status": "SUCCESS"
    }
  ]
}

Cuộc gọi qua Google Tìm kiếm

{
  "type": "google_search_call",
  "id": "call_123456",
  "arguments": {
    "queries": [
      "weather in Boston"
    ]
  }
}

Kết quả tìm kiếm trên Google

{
  "type": "google_search_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.google.com/search?q=weather+in+Boston",
      "title": "Weather in Boston"
    }
  ]
}

Lệnh gọi công cụ máy chủ Mcp

{
  "type": "mcp_server_tool_call",
  "id": "call_123456",
  "name": "get_forecast",
  "server_name": "weather_server",
  "arguments": {
    "city": "London"
  }
}

Kết quả công cụ máy chủ Mcp

{
  "type": "mcp_server_tool_result",
  "name": "get_forecast",
  "server_name": "weather_server",
  "call_id": "call_123456",
  "result": "sunny"
}

Cuộc gọi tìm kiếm tệp

{
  "type": "file_search_call",
  "id": "call_123456"
}

Kết quả tìm kiếm tệp

{
  "type": "file_search_result",
  "call_id": "call_123456",
  "result": [
    {
      "text": "search result chunk",
      "file_search_store": "file_search_store"
    }
  ]
}

Cuộc gọi qua Google Maps

{
  "type": "google_maps_call",
  "id": "call_123456",
  "arguments": {
    "query": "best food near me"
  }
}

Kết quả trên Google Maps

{
  "type": "google_maps_result",
  "call_id": "call_123456",
  "result": [
    {
      "places": [
        {
          "url": "https://www.google.com/maps/search/best+food+near+me",
          "name": "Tasty Restaurant"
        }
      ]
    }
  ]
}

Công cụ

Các loại có thể có

Phân biệt đối xử đa hình: type

Hàm

Một công cụ mà mô hình có thể sử dụng.

name string  (không bắt buộc)

Tên của hàm.

description string  (không bắt buộc)

Nội dung mô tả về hàm.

parameters object  (không bắt buộc)

Giản đồ JSON cho các tham số của hàm.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "function".

GoogleSearch

Một công cụ mà mô hình có thể dùng để tìm kiếm trên Google.

search_types mảng (enum (string))  (không bắt buộc)

Các loại liên kết thực tế để tìm kiếm cần bật.

Các giá trị có thể có:

  • web_search
  • image_search
type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "google_search".

CodeExecution

Một công cụ mà mô hình có thể dùng để thực thi mã.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "code_execution".

UrlContext

Một công cụ mà mô hình có thể dùng để tìm nạp ngữ cảnh URL.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "url_context".

ComputerUse

Một công cụ mà mô hình có thể dùng để tương tác với máy tính.

environment enum (string)  (không bắt buộc)

Môi trường đang hoạt động.

Các giá trị có thể có:

  • browser
excludedPredefinedFunctions array (string)  (không bắt buộc)

Danh sách các hàm được xác định trước bị loại trừ khỏi lệnh gọi mô hình.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "computer_use".

McpServer

MCPServer là một máy chủ mà mô hình có thể gọi để thực hiện các hành động.

name string  (không bắt buộc)

Tên của MCPServer.

url string  (không bắt buộc)

URL đầy đủ cho điểm cuối MCPServer. Ví dụ: "https://api.example.com/mcp"

headers object  (không bắt buộc)

Không bắt buộc: Các trường cho tiêu đề xác thực, thời gian chờ, v.v. (nếu cần).

allowed_tools AllowedTools  (không bắt buộc)

Các công cụ được phép.

Cấu hình cho các công cụ được phép.

Trường

mode ToolChoiceType  (không bắt buộc)

Chế độ lựa chọn công cụ.

Các giá trị có thể có:

  • auto
  • any
  • none
  • validated

tools array (string)  (không bắt buộc)

Tên của các công cụ được phép.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "mcp_server".

FileSearch

Một công cụ mà mô hình có thể dùng để tìm kiếm tệp.

file_search_store_names array (string)  (không bắt buộc)

Tên cửa hàng tìm kiếm tệp để tìm kiếm.

top_k số nguyên  (không bắt buộc)

Số lượng đoạn truy xuất ngữ nghĩa cần truy xuất.

metadata_filter string  (không bắt buộc)

Bộ lọc siêu dữ liệu để áp dụng cho các tài liệu và khối truy xuất ngữ nghĩa.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "file_search".

GoogleMaps

Một công cụ mà mô hình có thể dùng để gọi Google Maps.

enable_widget boolean  (không bắt buộc)

Có trả về mã thông báo ngữ cảnh tiện ích trong kết quả lệnh gọi công cụ của phản hồi hay không.

latitude number  (không bắt buộc)

Vĩ độ của vị trí người dùng.

longitude number  (không bắt buộc)

Kinh độ của vị trí người dùng.

type string  (không bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "google_maps".

Ví dụ

Chức năng

GoogleSearch

CodeExecution

UrlContext

ComputerUse

McpServer

FileSearch

GoogleMaps

Bật/Tắt

Trường

role string  (không bắt buộc)

Người khởi tạo lượt này. Phải là người dùng cho dữ liệu đầu vào hoặc mô hình cho đầu ra của mô hình.

content mảng (Nội dung) hoặc chuỗi  (không bắt buộc)

Nội dung của lượt tương tác.

Ví dụ

Lượt người dùng

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "user turn"
    }
  ]
}

Lượt của mô hình

{
  "role": "model",
  "content": [
    {
      "type": "text",
      "text": "model turn"
    }
  ]
}

InteractionSseEvent

Các loại có thể có

Phân biệt đối xử đa hình: event_type

InteractionStartEvent

interaction Tương tác  (bắt buộc)

Không có mô tả nào được cung cấp.

event_type enum (string)  (bắt buộc)

Không có mô tả nào được cung cấp.

Các giá trị có thể có:

  • interaction.start
event_id string  (không bắt buộc)

Mã thông báo event_id sẽ được dùng để tiếp tục luồng tương tác, bắt đầu từ sự kiện này.

InteractionCompleteEvent

interaction Tương tác  (bắt buộc)

Tương tác hoàn tất mà không có thông tin xuất ra để giảm kích thước tải trọng. Sử dụng các sự kiện ContentDelta trước đó cho đầu ra thực tế.

event_type enum (string)  (bắt buộc)

Không có mô tả nào được cung cấp.

Các giá trị có thể có:

  • interaction.complete
event_id string  (không bắt buộc)

Mã thông báo event_id sẽ được dùng để tiếp tục luồng tương tác, bắt đầu từ sự kiện này.

InteractionStatusUpdate

interaction_id string  (bắt buộc)

Không có mô tả nào được cung cấp.

status enum (string)  (bắt buộc)

Không có mô tả nào được cung cấp.

Các giá trị có thể có:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
event_type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "interaction.status_update".

event_id string  (không bắt buộc)

Mã thông báo event_id sẽ được dùng để tiếp tục luồng tương tác, bắt đầu từ sự kiện này.

ContentStart

index số nguyên  (bắt buộc)

Không có mô tả nào được cung cấp.

content Nội dung  (bắt buộc)

Không có mô tả nào được cung cấp.

event_type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "content.start".

event_id string  (không bắt buộc)

Mã thông báo event_id sẽ được dùng để tiếp tục luồng tương tác, bắt đầu từ sự kiện này.

ContentDelta

index số nguyên  (bắt buộc)

Không có mô tả nào được cung cấp.

delta object  (bắt buộc)

Không có mô tả nào được cung cấp.

Các loại có thể có

Phân biệt đối xử đa hình: type

TextDelta

text string  (bắt buộc)

Không có mô tả nào được cung cấp.

annotations Chú thích  (không bắt buộc)

Thông tin trích dẫn cho nội dung do mô hình tạo.

Thông tin trích dẫn cho nội dung do mô hình tạo.

Các loại có thể có

Phân biệt đối xử đa hình: type

UrlCitation

Chú thích trích dẫn URL.

url string  (không bắt buộc)

URL.

title string  (không bắt buộc)

Tiêu đề của URL.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "url_citation".

start_index integer  (không bắt buộc)

Điểm bắt đầu của đoạn phản hồi được phân bổ cho nguồn này.

end_index integer  (không bắt buộc)

Kết thúc phân đoạn được phân bổ, không bao gồm.

FileCitation

Chú thích trích dẫn tệp.

document_uri string  (không bắt buộc)

URI của tệp.

file_name string  (không bắt buộc)

Tên của tệp.

source string  (không bắt buộc)

Nguồn được ghi công cho một phần văn bản.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "file_citation".

start_index integer  (không bắt buộc)

Điểm bắt đầu của đoạn phản hồi được phân bổ cho nguồn này.

end_index integer  (không bắt buộc)

Kết thúc phân đoạn được phân bổ, không bao gồm.

PlaceCitation

Chú giải trích dẫn địa điểm.

place_id string  (không bắt buộc)

Mã nhận dạng của địa điểm, ở định dạng "places/{place_id}".

name string  (không bắt buộc)

Tên của địa điểm.

url string  (không bắt buộc)

URI tham chiếu của địa điểm.

review_snippets ReviewSnippet  (không bắt buộc)

Đoạn trích trong bài đánh giá được dùng để tạo câu trả lời về các tính năng của một địa điểm cụ thể trên Google Maps.

Đóng gói một đoạn trích trong bài đánh giá của người dùng để trả lời một câu hỏi về các tính năng của một địa điểm cụ thể trong Google Maps.

Trường

title string  (không bắt buộc)

Tiêu đề của bài đánh giá.

url string  (không bắt buộc)

Đường liên kết tương ứng với bài đánh giá của người dùng trên Google Maps.

review_id string  (không bắt buộc)

Mã của đoạn trích thông tin đánh giá.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "place_citation".

start_index integer  (không bắt buộc)

Điểm bắt đầu của đoạn phản hồi được phân bổ cho nguồn này.

end_index integer  (không bắt buộc)

Kết thúc phân đoạn được phân bổ, không bao gồm.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "text".

ImageDelta

data string  (không bắt buộc)

Không có mô tả nào được cung cấp.

uri string  (không bắt buộc)

Không có mô tả nào được cung cấp.

mime_type enum (string)  (không bắt buộc)

Không có mô tả nào được cung cấp.

Các giá trị có thể có:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (không bắt buộc)

Độ phân giải của nội dung nghe nhìn.

Các giá trị có thể có:

  • low
  • medium
  • high
  • ultra_high

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "image".

AudioDelta

data string  (không bắt buộc)

Không có mô tả nào được cung cấp.

uri string  (không bắt buộc)

Không có mô tả nào được cung cấp.

mime_type enum (string)  (không bắt buộc)

Không có mô tả nào được cung cấp.

Các giá trị có thể có:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "audio".

DocumentDelta

data string  (không bắt buộc)

Không có mô tả nào được cung cấp.

uri string  (không bắt buộc)

Không có mô tả nào được cung cấp.

mime_type enum (string)  (không bắt buộc)

Không có mô tả nào được cung cấp.

Các giá trị có thể có:

  • application/pdf
type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "document".

VideoDelta

data string  (không bắt buộc)

Không có mô tả nào được cung cấp.

uri string  (không bắt buộc)

Không có mô tả nào được cung cấp.

mime_type enum (string)  (không bắt buộc)

Không có mô tả nào được cung cấp.

Các giá trị có thể có:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (không bắt buộc)

Độ phân giải của nội dung nghe nhìn.

Các giá trị có thể có:

  • low
  • medium
  • high
  • ultra_high

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "video".

ThoughtSummaryDelta

content ThoughtSummaryContent  (không bắt buộc)

Một mục tóm tắt mới sẽ được thêm vào suy nghĩ.

Các loại có thể có

Phân biệt đối xử đa hình: type

TextContent

Một khối nội dung văn bản.

text string  (bắt buộc)

Nội dung văn bản.

annotations Chú thích  (không bắt buộc)

Thông tin trích dẫn cho nội dung do mô hình tạo.

Thông tin trích dẫn cho nội dung do mô hình tạo.

Các loại có thể có

Phân biệt đối xử đa hình: type

UrlCitation

Chú thích trích dẫn URL.

url string  (không bắt buộc)

URL.

title string  (không bắt buộc)

Tiêu đề của URL.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "url_citation".

start_index integer  (không bắt buộc)

Điểm bắt đầu của đoạn phản hồi được phân bổ cho nguồn này.

end_index integer  (không bắt buộc)

Kết thúc phân đoạn được phân bổ, không bao gồm.

FileCitation

Chú thích trích dẫn tệp.

document_uri string  (không bắt buộc)

URI của tệp.

file_name string  (không bắt buộc)

Tên của tệp.

source string  (không bắt buộc)

Nguồn được ghi công cho một phần văn bản.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "file_citation".

start_index integer  (không bắt buộc)

Điểm bắt đầu của đoạn phản hồi được phân bổ cho nguồn này.

end_index integer  (không bắt buộc)

Kết thúc phân đoạn được phân bổ, không bao gồm.

PlaceCitation

Chú giải trích dẫn địa điểm.

place_id string  (không bắt buộc)

Mã nhận dạng của địa điểm, ở định dạng "places/{place_id}".

name string  (không bắt buộc)

Tên của địa điểm.

url string  (không bắt buộc)

URI tham chiếu của địa điểm.

review_snippets ReviewSnippet  (không bắt buộc)

Đoạn trích trong bài đánh giá được dùng để tạo câu trả lời về các tính năng của một địa điểm cụ thể trên Google Maps.

Đóng gói một đoạn trích trong bài đánh giá của người dùng để trả lời một câu hỏi về các tính năng của một địa điểm cụ thể trong Google Maps.

Trường

title string  (không bắt buộc)

Tiêu đề của bài đánh giá.

url string  (không bắt buộc)

Đường liên kết tương ứng với bài đánh giá của người dùng trên Google Maps.

review_id string  (không bắt buộc)

Mã của đoạn trích thông tin đánh giá.

type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "place_citation".

start_index integer  (không bắt buộc)

Điểm bắt đầu của đoạn phản hồi được phân bổ cho nguồn này.

end_index integer  (không bắt buộc)

Kết thúc phân đoạn được phân bổ, không bao gồm.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "text".

ImageContent

Một khối nội dung hình ảnh.

data string  (không bắt buộc)

Nội dung hình ảnh.

uri string  (không bắt buộc)

URI của hình ảnh.

mime_type enum (string)  (không bắt buộc)

Loại MIME của hình ảnh.

Các giá trị có thể có:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (không bắt buộc)

Độ phân giải của nội dung nghe nhìn.

Các giá trị có thể có:

  • low
  • medium
  • high
  • ultra_high

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "image".

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "thought_summary".

ThoughtSignatureDelta

chữ ký chuỗi  (không bắt buộc)

Chữ ký khớp với nguồn phụ trợ sẽ là một phần của quá trình tạo.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "thought_signature".

FunctionCallDelta

name string  (bắt buộc)

Không có mô tả nào được cung cấp.

arguments object  (bắt buộc)

Không có mô tả nào được cung cấp.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "function_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

FunctionResultDelta

name string  (không bắt buộc)

Không có mô tả nào được cung cấp.

is_error boolean  (không bắt buộc)

Không có mô tả nào được cung cấp.

result object hoặc string  (bắt buộc)

Mức chênh lệch kết quả của lệnh gọi công cụ.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "function_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong khối lệnh gọi hàm.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

CodeExecutionCallDelta

arguments CodeExecutionCallArguments  (bắt buộc)

Không có mô tả nào được cung cấp.

Các đối số cần truyền đến quá trình thực thi mã.

Trường

language enum (string)  (không bắt buộc)

Ngôn ngữ lập trình của "code".

Các giá trị có thể có:

  • python
code string  (không bắt buộc)

Mã cần thực thi.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "code_execution_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

CodeExecutionResultDelta

result string  (bắt buộc)

Không có mô tả nào được cung cấp.

is_error boolean  (không bắt buộc)

Không có mô tả nào được cung cấp.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "code_execution_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong khối lệnh gọi hàm.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

UrlContextCallDelta

arguments UrlContextCallArguments  (bắt buộc)

Không có mô tả nào được cung cấp.

Các đối số cần truyền đến ngữ cảnh URL.

Trường

urls mảng (chuỗi)  (không bắt buộc)

Các URL cần tìm nạp.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "url_context_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

UrlContextResultDelta

result UrlContextResult  (bắt buộc)

Không có mô tả nào được cung cấp.

Kết quả của ngữ cảnh URL.

Trường

url string  (không bắt buộc)

URL đã được tìm nạp.

status enum (string)  (không bắt buộc)

Trạng thái truy xuất URL.

Các giá trị có thể có:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (không bắt buộc)

Không có mô tả nào được cung cấp.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "url_context_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong khối lệnh gọi hàm.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

GoogleSearchCallDelta

arguments GoogleSearchCallArguments  (bắt buộc)

Không có mô tả nào được cung cấp.

Các đối số cần truyền đến Google Tìm kiếm.

Trường

queries array (string)  (không bắt buộc)

Cụm từ tìm kiếm trên web để tìm kiếm trên web sau đó.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "google_search_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

GoogleSearchResultDelta

result GoogleSearchResult  (bắt buộc)

Không có mô tả nào được cung cấp.

Kết quả của Google Tìm kiếm.

Trường

search_suggestions string  (không bắt buộc)

Đoạn nội dung trên web có thể được nhúng vào một trang web hoặc webview của ứng dụng.

is_error boolean  (không bắt buộc)

Không có mô tả nào được cung cấp.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "google_search_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong khối lệnh gọi hàm.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

McpServerToolCallDelta

name string  (bắt buộc)

Không có mô tả nào được cung cấp.

server_name string  (bắt buộc)

Không có mô tả nào được cung cấp.

arguments object  (bắt buộc)

Không có mô tả nào được cung cấp.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "mcp_server_tool_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

McpServerToolResultDelta

name string  (không bắt buộc)

Không có mô tả nào được cung cấp.

server_name string  (không bắt buộc)

Không có mô tả nào được cung cấp.

result object hoặc string  (bắt buộc)

Mức chênh lệch kết quả của lệnh gọi công cụ.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "mcp_server_tool_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong khối lệnh gọi hàm.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

FileSearchCallDelta

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "file_search_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

FileSearchResultDelta

result FileSearchResult  (không bắt buộc)

Không có mô tả nào được cung cấp.

Kết quả của tính năng Tìm kiếm tệp.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "file_search_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong khối lệnh gọi hàm.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

GoogleMapsCallDelta

arguments GoogleMapsCallArguments  (không bắt buộc)

Các đối số cần truyền đến công cụ Google Maps.

Các đối số cần truyền đến công cụ Google Maps.

Trường

queries array (string)  (không bắt buộc)

Các truy vấn sẽ được thực thi.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "google_maps_call".

id string  (bắt buộc)

Mã nhận dạng duy nhất cho lệnh gọi công cụ cụ thể này.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

GoogleMapsResultDelta

result GoogleMapsResult  (bắt buộc)

Kết quả của Google Maps.

Kết quả của Google Maps.

Trường

địa điểm Địa điểm  (không bắt buộc)

Những địa điểm được tìm thấy.

Trường

place_id string  (không bắt buộc)

Mã nhận dạng của địa điểm, ở định dạng "places/{place_id}".

name string  (không bắt buộc)

Tên của địa điểm.

url string  (không bắt buộc)

URI tham chiếu của địa điểm.

review_snippets ReviewSnippet  (không bắt buộc)

Đoạn trích trong bài đánh giá được dùng để tạo câu trả lời về các tính năng của một địa điểm cụ thể trên Google Maps.

Đóng gói một đoạn trích trong bài đánh giá của người dùng để trả lời một câu hỏi về các tính năng của một địa điểm cụ thể trong Google Maps.

Trường

title string  (không bắt buộc)

Tiêu đề của bài đánh giá.

url string  (không bắt buộc)

Đường liên kết tương ứng với bài đánh giá của người dùng trên Google Maps.

review_id string  (không bắt buộc)

Mã của đoạn trích thông tin đánh giá.

widget_context_token string  (không bắt buộc)

Tên tài nguyên của mã thông báo bối cảnh tiện ích Google Maps.

type object  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "google_maps_result".

call_id string  (bắt buộc)

Mã nhận dạng khớp với mã nhận dạng trong khối lệnh gọi hàm.

chữ ký chuỗi  (không bắt buộc)

Một hàm băm chữ ký để xác thực phụ trợ.

event_type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "content.delta".

event_id string  (không bắt buộc)

Mã thông báo event_id sẽ được dùng để tiếp tục luồng tương tác, bắt đầu từ sự kiện này.

ContentStop

index số nguyên  (bắt buộc)

Không có mô tả nào được cung cấp.

event_type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "content.stop".

event_id string  (không bắt buộc)

Mã thông báo event_id sẽ được dùng để tiếp tục luồng tương tác, bắt đầu từ sự kiện này.

ErrorEvent

error Error  (không bắt buộc)

Không có mô tả nào được cung cấp.

Thông báo lỗi từ một lượt tương tác.

Trường

code string  (không bắt buộc)

Một URI xác định loại lỗi.

message string  (không bắt buộc)

Thông báo lỗi mà con người có thể đọc được.

event_type string  (bắt buộc)

Không có mô tả nào được cung cấp.

Luôn đặt thành "error".

event_id string  (không bắt buộc)

Mã thông báo event_id sẽ được dùng để tiếp tục luồng tương tác, bắt đầu từ sự kiện này.

Ví dụ

Bắt đầu tương tác

{
  "event_type": "interaction.start",
  "interaction": {
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-3-flash-preview",
    "object": "interaction",
    "status": "in_progress"
  }
}

Tương tác hoàn tất

{
  "event_type": "interaction.complete",
  "interaction": {
    "created": "2025-12-09T18:45:40Z",
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-3-flash-preview",
    "object": "interaction",
    "role": "model",
    "status": "completed",
    "updated": "2025-12-09T18:45:40Z",
    "usage": {
      "input_tokens_by_modality": [
        {
          "modality": "text",
          "tokens": 11
        }
      ],
      "total_cached_tokens": 0,
      "total_input_tokens": 11,
      "total_output_tokens": 364,
      "total_thought_tokens": 1120,
      "total_tokens": 1495,
      "total_tool_use_tokens": 0
    }
  }
}

Thông tin cập nhật về trạng thái tương tác

{
  "event_type": "interaction.status_update",
  "interaction_id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
  "status": "in_progress"
}

Bắt đầu nội dung

{
  "event_type": "content.start",
  "content": {
    "type": "text"
  },
  "index": 1
}

Chênh lệch nội dung

{
  "event_type": "content.delta",
  "delta": {
    "type": "text",
    "text": "Elara\u2019s life was a symphony of quiet moments. A librarian, she found solace in the hushed aisles, the scent of aged paper, and the predictable rhythm of her days. Her small apartment, meticulously ordered, reflected this internal calm, save"
  },
  "index": 1
}

Dừng nội dung

{
  "event_type": "content.stop",
  "index": 1
}

Sự kiện lỗi

{
  "event_type": "error",
  "error": {
    "message": "Failed to get completed interaction: Result not found.",
    "code": "not_found"
  }
}