Định cấu hình tính năng ghi nhật ký Gemini Code Assist Tiêu chuẩn và Doanh nghiệp

Tài liệu này mô tả cách định cấu hình tính năng ghi nhật ký Gemini Code Assist Standard (Hỗ trợ mã Gemini tiêu chuẩn) và Enterprise (Doanh nghiệp) cho một dự án bằng cách sử dụng Google API Console hoặc API.

Các điểm hạn chế

Tính năng ghi dữ liệu nhật ký của Gemini Standard và Enterprise trong Google Cloud chỉ giới hạn ở các lượt tương tác của người dùng với Gemini Code Assist trong IDE.

Ngoài ra, Gemini cho Google Cloud không ghi nhật ký dữ liệu cho Gemini Code Assist Standard và Enterprise nếu người dùng tắt tính năng đo từ xa của VS Code.

Trước khi bắt đầu

Đảm bảo dự án trên Google Cloud được đính kèm với một tài khoản thanh toán.

(Không bắt buộc) Cấp quyền IAM

Để định cấu hình tính năng ghi nhật ký Gemini Code Assist Standard và Enterprise, bạn phải có các quyền Quản lý danh tính và quyền truy cập cụ thể. Các quyền này được nêu chi tiết trong các phần sau. Hãy nhớ thêm các quyền này vào vai trò IAM tuỳ chỉnh.

Ngoài ra, bạn có thể cấp vai trò đã xác định sẵn trong IAM là Quản trị viên chế độ cài đặt Gemini cho Google Cloud (roles/cloudaicompanion.settingsAdmin). Vai trò này bao gồm tất cả các quyền cần thiết để làm việc với tất cả chế độ cài đặt dành cho quản trị viên của Gemini cho Google Cloud.

(Không bắt buộc) Liên kết quyền với chế độ cài đặt và mục tiêu

Nếu đang định cấu hình chế độ cài đặt quản trị viên Gemini Code Assist Standard và Enterprise trong Google API Console, thì bạn có thể bỏ qua phần này.

Để định cấu hình chế độ cài đặt quản trị viên Gemini Code Assist Tiêu chuẩn và Doanh nghiệp bằng API Gemini cho Google Cloud, trước tiên, bạn phải tạo chế độ cài đặt, sau đó tạo liên kết để "liên kết" các chế độ cài đặt và mục tiêu đó (chẳng hạn như thực thể, chủ đề hoặc dự án) cho các sản phẩm cụ thể (chẳng hạn như Gemini Cloud Assist hoặc Gemini Code Assist).

Tất cả quyền tạo và cập nhật chế độ cài đặt đều ở cấp dự án.

Định cấu hình tính năng ghi nhật ký của Gemini Code Assist

Các phần sau đây cung cấp các bước cần thiết để bật tính năng thu thập và lưu trữ hoạt động của Gemini Code Assist Standard và Enterprise trong tính năng Ghi nhật ký trên đám mây, bao gồm:

  • Nhật ký câu lệnh và phản hồi của Gemini Code Assist Standard và Enterprise, chẳng hạn như dữ liệu đầu vào của người dùng, thông tin theo bối cảnh và phản hồi.

  • Nhật ký siêu dữ liệu Gemini Code Assist Tiêu chuẩn và Doanh nghiệp, chẳng hạn như siêu dữ liệu đo từ xa và các dòng mã mà người dùng chấp nhận.

Để biết thêm thông tin chi tiết về cả hai loại nhật ký, hãy xem bài viết Xem nhật ký Gemini.

Bật tính năng ghi nhật ký cho Gemini Code Assist

Chọn một trong các tùy chọn sau:

Giao diện dòng lệnh

  1. Đảm bảo bạn đã bật API Nhật ký trên đám mây trong dự án.

  2. Đảm bảo rằng bạn có các quyền sau đây trong tính năng Quản lý danh tính và quyền truy cập trên dự án sở hữu gói thuê bao:

    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  3. Trong API Console, hãy chuyển đến trang Quản trị viên cho Gemini.

    Chuyển đến Gemini cho Google Cloud

    Trang Gemini cho Google Cloud sẽ tải.

  4. Nhấp vào Cài đặt trong trình đơn điều hướng bên trái.

    Trang Cài đặt sẽ tải.

  5. (Không bắt buộc) Nhấp vào Ghi nhật ký siêu dữ liệu của tính năng Hỗ trợ mã để ghi lại siêu dữ liệu do người dùng Gemini Code Assist Tiêu chuẩn và Doanh nghiệp tạo trong dự án.

  6. (Không bắt buộc) Nhấp vào Ghi nhật ký cho câu lệnh và câu trả lời của tính năng Trợ giúp mã để ghi lại câu lệnh và câu trả lời do người dùng Gemini Code Assist Standard và Enterprise tạo trong dự án.

  7. Nhấp vào Save Changes (Lưu thay đổi).

API

Để bật tính năng ghi nhật ký cho Gemini Code Assist Tiêu chuẩn và Gemini Code Assist Doanh nghiệp, hãy sử dụng phương thức loggingSetting.

  1. Đảm bảo bạn đã bật API Ghi nhật ký trên đám mây trong dự án.

  2. Đảm bảo rằng bạn có các quyền sau đây trong tính năng Quản lý danh tính và quyền truy cập trên dự án sở hữu gói thuê bao:

    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  3. Tạo chế độ cài đặt và giá trị dành riêng cho chế độ cài đặt:

    1. Lấy mã thông báo:

      TOKEN=$(gcloud auth print-access-token)

  4. Bật nhật ký siêu dữ liệu Gemini Code Assist Tiêu chuẩn và Doanh nghiệp.

    1. Chạy lệnh sau để tạo chế độ cài đặt:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "log_metadata": true,
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=SETTING_ID"

      Thay thế nội dung sau:

      • CONTAINER_PROJECT_NAME: Nhập mã dự án mẹ.
      • SETTING_ID: Nhập một tên chế độ cài đặt riêng biệt, chẳng hạn như gcalm1 cho Gemini Code Assist log metadata.

      Nếu thành công, lệnh này sẽ trả về một nội dung phản hồi cho biết log_metadata được đặt thành true:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_metadata": true
}

    2. Chạy lệnh sau để tạo liên kết cài đặt nhật ký siêu dữ liệu Gemini Code Assist Standard và Enterprise:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "target": "projects/TARGET_PROJECT_NAME"
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID/settingBindings?setting_binding_id=BINDING_ID"

    Thay thế nội dung sau:

    • TARGET_PROJECT_NAME: Nhập dự án mục tiêu mà bạn muốn áp dụng chế độ cài đặt.
    • SETTING_ID: Sử dụng cùng một SETTING_ID khi bạn tạo chế độ cài đặt, nhưng thêm b1 vào. Ví dụ: sử dụng gcalmb1 cho Gemini Code Assist log metadata.

    Nếu thành công, lệnh này sẽ trả về siêu dữ liệu thao tác ở định dạng sau:

    {
  "name": "projects/<var>CONTAINER_PROJECT_NAME</var>/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
    "createTime": "2025-01-23T15:27:50.076075570Z",
    "target": "projects/<var>TARGET_PROJECT_NAME</var>/locations/global/loggingSettings/<var>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

  5. Bật nhật ký người dùng Gemini Code Assist Tiêu chuẩn và Doanh nghiệp.

    1. Chạy lệnh sau để tạo chế độ cài đặt:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "log_prompts_and_responses": true,
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=SETTING_ID"

      Thay thế nội dung sau:

      • CONTAINER_PROJECT_NAME: Nhập mã dự án mẹ.
      • SETTING_ID: Nhập một tên chế độ cài đặt riêng biệt, chẳng hạn như gcapar1 cho Gemini Code Assist prompts and responses.

      Nếu thành công, lệnh này sẽ trả về một nội dung phản hồi cho biết log_prompts_and_responses được đặt thành true:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_prompts_and_responses": true
}

    2. Chạy lệnh sau để tạo liên kết cài đặt nhật ký người dùng Gemini Code Assist Standard và Enterprise:

      curl \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "target": "projects/TARGET_PROJECT_NAME"
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID/settingBindings?setting_binding_id=BINDING_ID"

    Thay thế nội dung sau:

    • TARGET_PROJECT_NAME: Nhập dự án mục tiêu mà bạn muốn áp dụng chế độ cài đặt.
    • SETTING_ID: Sử dụng cùng một SETTING_ID khi bạn tạo chế độ cài đặt, nhưng thêm b1 vào. Ví dụ: sử dụng gcaparb1 cho Gemini Code Assist prompts and responses.

    Nếu thành công, lệnh này sẽ trả về siêu dữ liệu thao tác ở định dạng sau:

    {
  "name": "projects/<var>CONTAINER_PROJECT_NAME</var>/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
    "createTime": "2025-01-23T15:27:50.076075570Z",
    "target": "projects/<var>TARGET_PROJECT_NAME</var>/locations/global/loggingSettings/<var>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Tắt tính năng ghi nhật ký cho Gemini Code Assist

Chọn một trong các tùy chọn sau:

Giao diện dòng lệnh

  1. Đảm bảo rằng bạn có các quyền sau đây trong tính năng Quản lý danh tính và quyền truy cập trên dự án sở hữu gói thuê bao:

    • loggingSettings.delete
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsDelete
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  2. Trong API Console, hãy chuyển đến trang Quản trị viên cho Gemini.

    Chuyển đến Gemini cho Google Cloud

    Trang Gemini cho Google Cloud sẽ tải.

  3. Nhấp vào Cài đặt trong trình đơn điều hướng bên trái.

    Trang Cài đặt sẽ tải.

  4. Nhấp vào Ghi nhật ký siêu dữ liệu của tính năng Hỗ trợ mã để tắt tính năng ghi siêu dữ liệu từ việc sử dụng Gemini Code Assist Tiêu chuẩn và Doanh nghiệp trong dự án.

  5. Nhấp vào Save Changes (Lưu thay đổi).

API

Để bật tính năng ghi nhật ký cho Gemini Code Assist Tiêu chuẩn và Gemini Code Assist Doanh nghiệp, hãy sử dụng phương thức loggingSetting.

  1. Đảm bảo rằng bạn có các quyền sau đây trong tính năng Quản lý danh tính và quyền truy cập trên dự án sở hữu gói thuê bao:

    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • serviceusage.services.enable

  2. Tạo chế độ cài đặt và giá trị dành riêng cho chế độ cài đặt:

    1. Lấy mã thông báo:

      TOKEN=$(gcloud auth print-access-token)

  3. Chạy lệnh sau để tắt chế độ cài đặt Gemini Code Assist Tiêu chuẩn và nhật ký siêu dữ liệu Doanh nghiệp:

      curl -X POST \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' \
    -d '{
      "log_metadata": false,
      } ' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_metadata_id=SETTING_ID"

    Thay thế nội dung sau:

    • CONTAINER_PROJECT_NAME: Nhập mã dự án mẹ.

    • SETTING_ID: Nhập tên chế độ cài đặt hiện có, chẳng hạn như gcalm1 cho Gemini Code Assist log metadata.

      Nếu thành công, lệnh này sẽ trả về một nội dung phản hồi cho biết log_metadata được đặt thành false:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_metadata": false
}

  4. Chạy lệnh sau để tắt chế độ cài đặt Gemini Code Assist Standard (Tiêu chuẩn hỗ trợ mã Gemini) và Enterprise user logs (Nhật ký người dùng doanh nghiệp):

      curl -X POST \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' \
    -d '{
      "log_prompts_and_responses": false,
      } ' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=SETTING_ID"

    Thay thế nội dung sau:

    • CONTAINER_PROJECT_NAME: Nhập mã dự án mẹ.

    • SETTING_ID: Nhập tên chế độ cài đặt hiện có, chẳng hạn như gcapar1 cho Gemini Code Assist prompts and responses.

      Nếu thành công, lệnh này sẽ trả về một nội dung phản hồi cho biết log_prompts_and_responses được đặt thành false:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_prompts_and_responses": false
}

Bước tiếp theo