Trang này được dịch bởi Cloud Translation API.

Đị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 bảng điều khiển Google Cloud hoặc API.

Hạn chế

Tính năng ghi dữ liệu nhật ký trong Gemini Standard và Enterprise Google Cloud chỉ giới hạn ở các hoạt động tương tác của người dùng với tính năng 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 Tiêu chuẩn và Doanh nghiệp nếu người dùng tắt tính năng đo từ xa của VS Code.

Trước khi bạn bắt đầu

Đảm bảo dự án Google Cloud của bạn đượ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ý của 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 (IAM) 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 Gemini Code Assist Tiêu chuẩn và chế độ cài đặt quản trị viên của phiên bản Doanh nghiệp trong bảng điều khiển Google Cloud , 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:

Bảng điều khiển

Đảm bảo bạn đã bật API Nhật ký trên đám mây trong dự án.
Đảm bảo rằng bạn có các quyền Quản lý danh tính và quyền truy cập (IAM) sau đây 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
Trong bảng điều khiển Google Cloud , hãy chuyển đến trang Quản trị viên cho Gemini.

Chuyển đến Gemini để Google Cloud

Trang Gemini cho Google Cloud sẽ tải.
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.
(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.
(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.
Nhấp vào Lưu thay đổi.

Giao diện lập trình ứng dụng (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.

Đảm bảo bạn đã bật API Ghi nhật ký trên đám mây trong dự án.
Đảm bảo rằng bạn có các quyền Quản lý danh tính và quyền truy cập (IAM) sau đây 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
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)
```

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

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=META_LOG_SETTING_ID"

Thay thế nội dung sau:

CONTAINER_PROJECT_NAME: Nhập mã dự án của dự án lưu trữ tài nguyên liên kết. Đây là dự án mẹ của liên kết.
META_LOG_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/META_LOG_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_metadata": true
}

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/META_LOG_SETTING_ID/settingBindings?setting_binding_id=META_LOG_BINDING_ID"

Thay thế nội dung sau:

TARGET_PROJECT_NAME: Nhập dự án mục tiêu mà liên kết sẽ được liên kết. Tên này thường giống với tên 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 cài đặt.
META_LOG_BINDING_ID: Sử dụng cùng một META_LOG_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>META_LOG_SETTING_ID</var>/settingBindings/<var>META_LOG_BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

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

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=USER_LOG_SETTING_ID"

Thay thế nội dung sau:

CONTAINER_PROJECT_NAME: Nhập mã dự án của dự án lưu trữ tài nguyên liên kết. Đây là dự án mẹ của liên kết.
USER_LOG_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/USER_LOG_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_prompts_and_responses": true
}

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/USER_LOG_SETTING_ID/settingBindings?setting_binding_id=USER_LOG_BINDING_ID"

Thay thế nội dung sau:

TARGET_PROJECT_NAME: Nhập dự án mục tiêu mà liên kết sẽ được liên kết. Tên này thường giống với tên 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 cài đặt.
USER_LOG_BINDING_ID: Sử dụng cùng một USER_LOG_SETTING_ID khi bạn tạo chế độ cài đặt, nhưng thêm vào đó b1. 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>USER_LOG_SETTING_ID</var>/settingBindings/<var>USER_LOG_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:

Bảng điều khiển

Đảm bảo rằng bạn có các quyền Quản lý danh tính và quyền truy cập (IAM) sau đây 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
Trong bảng điều khiển Google Cloud , hãy chuyển đến trang Quản trị viên cho Gemini.

Chuyển đến Gemini để Google Cloud

Trang Gemini cho Google Cloud sẽ tải.
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.
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.
Nhấp vào Lưu thay đổi.

Giao diện lập trình ứng dụng (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.

Đảm bảo rằng bạn có các quyền Quản lý danh tính và quyền truy cập (IAM) sau đây 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
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)
```

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=META_LOG_SETTING_ID"

Thay thế nội dung sau:

CONTAINER_PROJECT_NAME: Nhập mã dự án mẹ.
META_LOG_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/META_LOG_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_metadata": false
}
```

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=USER_LOG_SETTING_ID"

Thay thế nội dung sau:

CONTAINER_PROJECT_NAME: Nhập mã dự án mẹ.
USER_LOG_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/USER_LOG_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_prompts_and_responses": false
}
```

Định cấu hình tính năng ghi nhật ký Gemini Code Assist Tiêu chuẩn và Doanh nghiệp Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Hạn chế

Trước khi bạn bắt đầu

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

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

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

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

Bảng điều khiển

Giao diện lập trình ứng dụng (API)

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

Bảng điều khiển

Giao diện lập trình ứng dụng (API)

Bước tiếp theo

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