Đị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 và Enterprise cho một dự án bằng cách sử dụng Google API Console hoặc một API.

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

Việc ghi nhật ký dữ liệu 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 số liệu đo từ xa của VS Code.

Trước khi bắt đầu

Xác minh rằng dự án của bạn trên Google Cloud được liên kết với một tài khoản thanh toán.

Xác minh quyền IAM

Để định cấu hình nhật ký Gemini Code Assist Standard và Enterprise, bạn có thể cấp vai trò được xác định trước Quản trị viên chế độ cài đặt Gemini cho Google Cloud (roles/cloudaicompanion.settingsAdmin) Quản lý danh tính và quyền truy cập. Vai trò này bao gồm tất cả các quyền bắt buộc cần thiết để làm việc với mọi chế độ cài đặt quản trị viên Gemini cho Google Cloud.

Ngoài ra, bạn có thể cập nhật mọi vai trò IAM tuỳ chỉnh. Bạn phải có các quyền IAM cụ thể, được trình bày chi tiết trong các phần sau.

Định cấu hình nhật ký Gemini Code Assist

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

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

  • Nhật ký siêu dữ liệu của 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à số dòng mã mà người dùng chấp nhận.

Để biết thêm thông tin về cả hai loại nhật ký này, hãy xem bài viết Xem nhật ký của 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. Xác minh rằng bạn đã bật API Cloud Logging trong dự án.

  2. Xác minh rằng bạn có các quyền IAM sau đây đối với dự án sở hữu gói thuê bao:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • 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 Code Assist để 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 Trợ lý mã để ghi lại các 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 dùng tài nguyên loggingSettings để xác định chế độ cài đặt ghi nhật ký mà bạn muốn, đồng thời dùng tài nguyên loggingSettings.settingBindings để liên kết chế độ cài đặt với một dự án:

  1. Xác minh rằng bạn đã bật API Cloud Logging trong dự án.

  2. Xác minh rằng bạn có các quyền IAM sau đây đối với dự án sở hữu gói thuê bao:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • 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ý Gemini Code Assist Tiêu chuẩn và Doanh nghiệp. Nhật ký người dùng và nhật ký siêu dữ liệu được bật tương ứng với các trường log_prompts_and_responses và log_metadata. Nếu bạn không muốn bật một trong các trường, hãy loại trừ trường đó khỏi yêu cầu.

    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,
    "log_metadata": true,
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=LOGS_SETTING_ID"

      Thay thế nội dung sau:

      • CONTAINER_PROJECT_NAME: Nhập mã dự án của dự án nơi lưu trữ tài nguyên liên kết. Đây là dự án mẹ của liên kết.
      • LOGS_SETTING_ID: Nhập một tên chế độ cài đặt riêng biệt, chẳng hạn như gcalm.

      Nếu lệnh 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 và log_metadata được đặt thành true:

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

    2. Chạy lệnh sau để tạo chế độ cài đặt liên kết nhật ký 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/LOGS_SETTING_ID/settingBindings?setting_binding_id=LOGS_BINDING_ID"

    Thay thế nội dung sau:

    • TARGET_PROJECT_NAME: Nhập dự án đích mà bạn muốn liên kết. Điều này thường giống với dự án vùng chứa. Tuy nhiên, bạn có thể liên kết một chế độ cài đặt với nhiều dự án để không phải sao chép tài nguyên chế độ cài đặt.
    • LOGS_BINDING_ID: Sử dụng cùng một LOGS_SETTING_ID khi bạn tạo chế độ cài đặt, nhưng hãy thêm b1 vào cuối. Ví dụ: sử dụng gcalmb1.

    Nếu lệnh thành công, lệnh này sẽ trả về siêu dữ liệu của 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>LOGS_SETTING_ID</var>/settingBindings/<var>LOGS_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. Xác minh rằng bạn có các quyền IAM sau đây đối với dự án sở hữu gói thuê bao:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • 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 Code Assist để 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

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

  1. Xác minh rằng bạn có các quyền IAM sau đây đối với dự án sở hữu gói thuê bao:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • 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 nhật ký Gemini Code Assist Tiêu chuẩn và Doanh nghiệp:

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

    Thay thế nội dung sau:

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

    • LOGS_SETTING_ID: Nhập tên chế độ cài đặt hiện có, chẳng hạn như gcalm.

      Nếu lệnh 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 và log_metadata được đặt thành false:

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

Bước tiếp theo