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

Định cấu hình tính năng tuỳ chỉnh mã của Gemini Code Assist

Tài liệu này mô tả cách thiết lập chế độ tuỳ chỉnh mã của Gemini Code Assist trong API Console, bằng Google Cloud CLI hoặc bằng Terraform bằng cách kết nối Gemini Code Assist với các kho lưu trữ mã riêng tư của bạn. Tính năng tuỳ chỉnh mã của Gemini Code Assist cho phép bạn nhận các đề xuất về mã dựa trên thư viện nội bộ, API riêng tư và kiểu mã hoá của tổ chức.

Trước khi bắt đầu

Thiết lập Gemini Code Assist bằng gói thuê bao Enterprise.
Xác minh rằng bạn có các vai trò Quản lý danh tính và quyền truy cập sau đây trên dự án sở hữu gói thuê bao:
- Quản trị viên chỉ mục kho lưu trữ mã (roles/cloudaicompanion.codeRepositoryIndexesAdmin)
- Người dùng Gemini cho Google Cloud (roles/cloudaicompanion.user)
Tạo hoặc định cấu hình tài khoản người dùng. Mỗi nhà phát triển trong tổ chức của bạn đang sử dụng Gemini Code Assist phải có danh tính người dùng trong Google Cloud và có quyền truy cập vào dự án Google Cloud của bạn. Để biết thêm thông tin, hãy xem bài viết Cấp vai trò trong bảng điều khiển Google Cloud. Xác minh để đảm bảo mỗi người dùng đều có các vai trò sau:
- Người dùng Gemini cho Google Cloud
- Người dùng nhóm kho lưu trữ
Tính năng tuỳ chỉnh mã sử dụng Developer Connect để truy cập và lập chỉ mục các kho lưu trữ riêng tư của bạn. Đảm bảo rằng khu vực Developer Connect nơi có kết nối kho lưu trữ Developer Connect của bạn cũng là một vị trí được hỗ trợ để tuỳ chỉnh mã. Bạn không thể sử dụng tính năng tuỳ chỉnh mã nếu kết nối Developer Connect ở một khu vực không được hỗ trợ. Để biết danh sách các khu vực được hỗ trợ, hãy xem các giới hạn về việc tuỳ chỉnh mã.

Chọn kho lưu trữ được lập chỉ mục

Theo phương pháp hay nhất, bạn nên lập chỉ mục các kho lưu trữ có những đặc điểm sau:

Mã có kiểu hoặc cấu trúc tương tự như những gì bạn muốn nhà phát triển của mình viết.
Các thư viện hoặc API riêng tư mà bạn muốn gọi từ cơ sở mã hiện tại.

Không bắt buộc: Chọn những tệp không được lập chỉ mục

Theo mặc định, tính năng tuỳ chỉnh mã sẽ lập chỉ mục tất cả các tệp mã được hỗ trợ trong các kho lưu trữ mà bạn chỉ định.

Để ngăn việc lộ mã mà bạn không muốn lập chỉ mục, bạn có thể sử dụng các mẫu nhánh để kiểm soát quyền truy cập vào chỉ mục và sử dụng một nhánh ổn định, chẳng hạn như main.

Ngoài ra, bạn cũng có thể loại trừ các tệp khỏi chỉ mục bằng cách tạo tệp .aiexclude.

Định cấu hình chế độ tuỳ chỉnh mã của Gemini Code Assist

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

Giao diện dòng lệnh

Trong API Console, hãy chuyển đến trang Tuỳ chỉnh mã.

Chuyển đến phần Tuỳ chỉnh mã cho Gemini Code Assist

Trang Tuỳ chỉnh mã cho Gemini Code Assist sẽ tải.
Tạo chỉ mục. Việc tuỳ chỉnh mã dựa vào một chỉ mục để phân tích và phân tích cú pháp kho lưu trữ của bạn nhằm đưa ra các đề xuất và tra cứu nhanh hơn về việc tạo mã.
1. Nhấp vào Tạo rồi định cấu hình thông tin chi tiết về chỉ mục:
  - Chọn khu vực được định cấu hình trong Developer Connect trong dự án trên Đám mây.
  - Nhập tên cho chỉ mục của bạn. Ghi lại tên chỉ mục. Bạn cần có nó cho một số bước trong tài liệu này.
2. Nhấp vào Tạo.
Quá trình tạo chỉ mục thường mất 30 phút để hoàn tất, nhưng cũng có thể mất đến 1 giờ. Khi quá trình lập chỉ mục hoàn tất, bạn sẽ nhận được thông báo trong Google API Console.

Google giới hạn số lượng chỉ mục kho lưu trữ mã là một cho mỗi dự án và tổ chức.
Kiểm soát quyền truy cập vào chỉ mục bằng cách sử dụng nhóm kho lưu trữ.

Nhóm kho lưu trữ là một vùng chứa cho cấu hình lập chỉ mục, bao gồm các kho lưu trữ và mẫu nhánh của chúng. Các nhóm kho lưu trữ được thiết kế để kiểm soát IAM chi tiết, cho phép nhà phát triển truy cập vào dữ liệu được lập chỉ mục từ các nhóm đó, nơi họ có quyền cloudaicompanion.repositoryGroups.use.

Nhóm kho lưu trữ chứa các kho lưu trữ Developer Connect hoặc đường liên kết từ cùng một dự án và vị trí.
Trên trang Tuỳ chỉnh mã cho Gemini Code Assist, hãy nhấp vào Thêm kho lưu trữ, rồi chọn Thêm kho lưu trữ nguồn.

Một danh sách hiển thị các kho lưu trữ hiện có trong Developer Connect cho khu vực mà bạn đã định cấu hình ở bước trước để tạo chỉ mục.

Nếu bạn cần thêm kho lưu trữ mới vào nhóm kho lưu trữ, hãy nhấp vào Liên kết kho lưu trữ rồi làm theo các bước trong Google API Console.

Ngoài ra, bạn có thể chọn rồi chỉnh sửa một hoặc nhiều kho lưu trữ để thêm một nhánh mới.
Chọn nhóm kho lưu trữ mà bạn muốn thêm kho lưu trữ mới. Hoặc nhấp vào Tạo một nhóm kho lưu trữ mới để tạo và định cấu hình một nhóm kho lưu trữ mới.
Để bắt đầu lập chỉ mục các kho lưu trữ đã chọn, hãy nhấp vào Lập chỉ mục.

Thời gian lập chỉ mục sẽ khác nhau tuỳ thuộc vào quy mô của kho lưu trữ.

CLI

Xác minh rằng bạn đã định cấu hình Developer Connect và kết nối với kho lưu trữ của mình:
Trong môi trường shell, hãy chạy lệnh gcloud components update để xác minh rằng bạn đã cập nhật tất cả các thành phần đã cài đặt của gcloud lên phiên bản mới nhất. Đối với bước này, bạn có thể cài đặt và khởi động gcloud hoặc sử dụng Cloud Shell Editor.
```
gcloud components update
```
Tạo chỉ mục. Việc tuỳ chỉnh mã dựa vào một chỉ mục để phân tích và phân tích cú pháp kho lưu trữ của bạn nhằm đưa ra các đề xuất và tra cứu nhanh hơn về việc tạo mã.
1. Để tạo chỉ mục, trong môi trường shell, hãy sử dụng lệnh gemini code-repository-indexes create:
```
gcloud gemini code-repository-indexes create INDEX_NAME \
    --project=PROJECT_ID \
    --location=REGION
```
  Thay thế nội dung sau:
  - INDEX_NAME: tên chỉ mục của bạn. Lưu ý quan trọng: Ghi lại tên chỉ mục của bạn. Bạn cần mã này cho một số bước trong tài liệu này.
  - PROJECT_ID: mã dự án của bạn trên Google Cloud.
  - REGION: khu vực được định cấu hình trong Developer Connect trong dự án trên Cloud.
  Quá trình tạo chỉ mục thường mất 30 phút để hoàn tất, nhưng cũng có thể mất đến 1 giờ.
  
  Google giới hạn số lượng chỉ mục kho lưu trữ mã là một cho mỗi dự án và tổ chức.
Kiểm soát quyền truy cập vào chỉ mục bằng cách sử dụng nhóm kho lưu trữ. Nhóm kho lưu trữ là một vùng chứa cho cấu hình lập chỉ mục, bao gồm các kho lưu trữ và mẫu nhánh của chúng. Các nhóm kho lưu trữ được thiết kế để kiểm soát IAM chi tiết, cho phép nhà phát triển truy cập vào dữ liệu được lập chỉ mục từ các nhóm đó, trong đó họ có quyền cloudaicompanion.repositoryGroups.use.

Nhóm kho lưu trữ chứa các kho lưu trữ Developer Connect hoặc các đường liên kết từ cùng một dự án và vị trí.

Quản trị viên thực hiện các thao tác sau:
- Tạo mã cho tài nguyên Chỉ mục kho lưu trữ.
- Trong cùng một dự án và vị trí, hãy định cấu hình một kết nối Developer Connect mới.
- Liên kết các kho lưu trữ Git trong mối kết nối.
- Lấy tên tài nguyên của các đường liên kết, chọn mẫu nhánh để lập chỉ mục cho từng đường liên kết và đặt đường liên kết đó vào một hoặc nhiều nhóm kho lưu trữ.
Để tạo một nhóm kho lưu trữ, trong môi trường shell, hãy sử dụng lệnh gemini code-repository-indexes repository-groups create:
```
gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories='[{"resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "BRANCH_NAMES"}]'
```
Lưu ý: Bạn có thể sử dụng biểu thức chính quy trong cú pháp RE2 để chỉ định tên nhánh.

Thay thế nội dung sau:
- REPOSITORY_GROUP: tên của nhóm kho lưu trữ, chẳng hạn như default.
- REPOSITORY_RESOURCE_NAME: tên của kho lưu trữ trong kết nối Developer Connect. Để tìm tên của kho lưu trữ, hãy chuyển đến trang Kho lưu trữ Git trong Google Cloud Console, rồi trong thẻ Kho lưu trữ, hãy tìm mã nhận dạng kết nối trong cột Kết nối của bảng. Để sao chép tên tài nguyên, hãy nhấp vào trình đơn more_vert để xem các lựa chọn khác, rồi chọn Sao chép đường dẫn tài nguyên.
- BRANCH_NAMES: tên của các nhánh mà bạn muốn lập chỉ mục, chẳng hạn như main|dev.
Bạn cũng có thể tạo một nhóm kho lưu trữ với các kho lưu trữ được xác định trong tệp JSON (hoặc YAML), được định dạng như sau:
JSON
```
[
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "main|dev"
  },
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "dev"
  }
]
```
YAML
```
- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: main|dev

- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: dev
```
Để tạo một nhóm kho lưu trữ dựa trên tệp JSON hoặc YAML, trong môi trường shell, hãy dùng lệnh gemini code-repository-indexes repository-groups create:
JSON
```
gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.json
```
YAML
```
gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.yaml
```
Nếu muốn, bạn có thể mã hoá và kiểm soát dữ liệu bằng khoá mã hoá do khách hàng quản lý (CMEK) thông qua Cloud Key Management Service. Để tìm hiểu thêm về cách sử dụng CMEK, hãy xem bài viết Mã hoá dữ liệu bằng khoá mã hoá do khách hàng quản lý.
Cấp vai trò IAM cho nhóm kho lưu trữ trong một dự án.

Bạn chỉ nhận được đề xuất từ các kho lưu trữ trong chỉ mục. Mỗi kho lưu trữ thuộc về một hoặc nhiều nhóm kho lưu trữ. Để truy cập vào các đề xuất, bạn phải cấp vai trò IAM Người dùng nhóm kho lưu trữ Cloud AI Companion (roles/cloudaicompanion.repositoryGroupsUser) (chứa quyền IAM cloudaicompanion.repositoryGroups.user bắt buộc) cho nhóm kho lưu trữ theo một trong những cách sau:
- Cấp cho các chủ thể quyền truy cập vào toàn bộ chỉ mục.
- Cấp cho các tài khoản chính quyền truy cập vào một tập hợp con của chỉ mục.
Toàn bộ chỉ mục
1. Để liên kết một chính sách IAM cho một dự án, trong môi trường shell, hãy dùng lệnh projects add-iam-policy-binding:
  gcloud projects add-iam-policy-binding PROJECT_ID \ --member='PRINCIPAL' \ --role='roles/cloudaicompanion.repositoryGroupsUser'
  Thay thế nội dung sau:
  - PRINCIPAL: địa chỉ email của người dùng chính cần có quyền truy cập – ví dụ: user:test-user@gmail.com cho một cá nhân hoặc group:admins@example.com cho một nhóm.
  Để biết thêm thông tin, hãy xem gcloud projects set-iam-policy.
2. Khi được nhắc chỉ định một điều kiện, hãy nhập None.
Một phần của chỉ mục
Bạn có thể tạo nhiều nhóm kho lưu trữ và chỉ định vai trò IAM cho các nguyên tắc IAM khác nhau.

Để thiết lập một chính sách IAM, bạn phải chuẩn bị tệp JSON hoặc YAML chính sách IAM. Tệp này sẽ chứa danh sách các nhóm IAM và vai trò được chỉ định. Ví dụ:
```
  bindings:
  - members:
    - group:my-group@example.com
    - user:test-user@example.com
    role: roles/cloudaicompanion.repositoryGroupsUser
```
Để biết thêm thông tin chi tiết và cú pháp, hãy xem phần Tìm hiểu về chính sách cho phép.

Lưu ý: Bạn có thể chỉ định vai trò tuỳ chỉnh cho các nhóm IAM, nhưng vai trò tuỳ chỉnh đó phải có tất cả các quyền của vai trò roles/cloudaicompanion.repositoryGroupsUser.

Để thiết lập chính sách IAM, trong môi trường shell, hãy sử dụng lệnh gemini code-repository-indexes repository-groups set-iam-policy:
```
  gcloud gemini code-repository-indexes repository-groups set-iam-policy GROUP_NAMEPOLICY_FILE \
      --project=PROJECT_ID \
      --location=REGION \
      --code-repository-index=INDEX_NAME
```
Thay thế nội dung sau:
- GROUP_NAME: tên nhóm kho lưu trữ mà bạn đã tạo ở bước trước để kiểm soát quyền truy cập vào chỉ mục bằng cách sử dụng nhóm kho lưu trữ.
- POLICY_FILE: chính sách IAM.
  
  Để biết thêm thông tin, hãy xem gcloud gemini code-repository-indexes repository-groups set-iam-policy.

Terraform

Xác minh rằng bạn đã định cấu hình Developer Connect và kết nối với kho lưu trữ của mình:
Tạo chỉ mục. Việc tuỳ chỉnh mã dựa vào một chỉ mục để phân tích và phân tích cú pháp kho lưu trữ của bạn nhằm đưa ra các đề xuất và tra cứu nhanh hơn về việc tạo mã.
```
resource "google_gemini_code_repository_index" "example" {
  location = "REGION"
  code_repository_index_id = "INDEX_NAME"
}
```
Thay thế nội dung sau:
- INDEX_NAME: tên chỉ mục của bạn. Lưu ý quan trọng: Ghi lại tên chỉ mục của bạn. Bạn cần có khoá này để thực hiện một số bước trong tài liệu này.
- PROJECT_ID: mã dự án của bạn trên Google Cloud.
- REGION: khu vực được định cấu hình trong Developer Connect trong dự án trên Cloud.
Quá trình tạo chỉ mục thường mất 30 phút để hoàn tất, nhưng cũng có thể mất đến 1 giờ.

Google giới hạn số lượng chỉ mục kho lưu trữ mã là một cho mỗi dự án và tổ chức.
Kiểm soát quyền truy cập vào chỉ mục bằng cách sử dụng nhóm kho lưu trữ. Nhóm kho lưu trữ là một vùng chứa cho cấu hình lập chỉ mục, bao gồm các kho lưu trữ và mẫu nhánh của chúng. Các nhóm kho lưu trữ được thiết kế để kiểm soát IAM chi tiết, cho phép nhà phát triển truy cập vào dữ liệu được lập chỉ mục từ các nhóm đó, trong đó họ có quyền cloudaicompanion.repositoryGroups.use.

Nhóm kho lưu trữ chứa các kho lưu trữ Developer Connect hoặc đường liên kết từ cùng một dự án và vị trí.

Quản trị viên thực hiện các thao tác sau:
- Tạo mã cho tài nguyên Chỉ mục kho lưu trữ.
- Trong cùng một dự án và vị trí, hãy định cấu hình một kết nối Developer Connect mới.
- Liên kết các kho lưu trữ Git trong mối kết nối.
- Lấy tên tài nguyên của các đường liên kết, chọn mẫu nhánh để lập chỉ mục cho từng đường liên kết và đặt đường liên kết đó vào một hoặc nhiều nhóm kho lưu trữ.
```
resource "google_gemini_repository_group" "example" {
  location = "REGION"
  code_repository_index = "INDEX_NAME"
  repository_group_id = "REPOSITORY_GROUP"
  repositories {
    resource = "REPOSITORY_RESOURCE_NAME"
    branch_pattern = "BRANCH_NAMES"
  }
}
```
Lưu ý: Bạn có thể sử dụng biểu thức chính quy theo cú pháp RE2 để chỉ định tên nhánh.

Thay thế nội dung sau:
- REPOSITORY_GROUP: tên của nhóm kho lưu trữ, chẳng hạn như default.
- REPOSITORY_RESOURCE_NAME: tên của kho lưu trữ trong kết nối Developer Connect. Để tìm tên của kho lưu trữ, hãy chuyển đến trang Kho lưu trữ Git trong Google Cloud Console, rồi trong thẻ Kho lưu trữ, hãy tìm mã nhận dạng kết nối trong cột Kết nối của bảng. Để sao chép tên tài nguyên, hãy nhấp vào trình đơn more_vert để xem các lựa chọn khác, rồi chọn Sao chép đường dẫn tài nguyên.
- BRANCH_NAMES: tên của các nhánh mà bạn muốn lập chỉ mục, chẳng hạn như main|dev.
Bạn cũng có thể tạo một nhóm kho lưu trữ với các kho lưu trữ được xác định trong tệp JSON (hoặc YAML), được định dạng như sau:
JSON
```
[
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "main|dev"
  },
  {
      "resource": "REPOSITORY_RESOURCE_NAME", "branchPattern": "dev"
  }
]
```
YAML
```
- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: main|dev

- resource: REPOSITORY_RESOURCE_NAME
  branchPattern: dev
```
Để tạo một nhóm kho lưu trữ dựa trên tệp JSON hoặc YAML, trong môi trường shell, hãy dùng lệnh gemini code-repository-indexes repository-groups create:
JSON
```
gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.json
```
YAML
```
gcloud gemini code-repository-indexes repository-groups create REPOSITORY_GROUP \
    --project=PROJECT_ID \
    --location=REGION \
    --code-repository-index=INDEX_NAME \
    --repositories=FILEPATH.yaml
```
Nếu muốn, bạn có thể mã hoá và kiểm soát dữ liệu bằng khoá mã hoá do khách hàng quản lý (CMEK) thông qua Cloud Key Management Service. Để tìm hiểu thêm về cách sử dụng CMEK, hãy xem bài viết Mã hoá dữ liệu bằng khoá mã hoá do khách hàng quản lý.
Cấp vai trò IAM cho nhóm kho lưu trữ trong một dự án.

Bạn chỉ nhận được đề xuất từ các kho lưu trữ trong chỉ mục. Mỗi kho lưu trữ thuộc về một hoặc nhiều nhóm kho lưu trữ. Để truy cập vào các đề xuất, bạn phải cấp vai trò IAM Người dùng nhóm kho lưu trữ Cloud AI Companion (roles/cloudaicompanion.repositoryGroupsUser) (chứa quyền IAM cloudaicompanion.repositoryGroups.user bắt buộc) cho nhóm kho lưu trữ theo một trong những cách sau:
- Cấp cho các chủ thể quyền truy cập vào toàn bộ chỉ mục.
- Cấp cho các tài khoản chính quyền truy cập vào một tập hợp con của chỉ mục.
Toàn bộ chỉ mục
1. Để liên kết một chính sách IAM cho một dự án, trong môi trường shell, hãy dùng lệnh projects add-iam-policy-binding:
  gcloud projects add-iam-policy-binding PROJECT_ID \ --member='PRINCIPAL' \ --role='roles/cloudaicompanion.repositoryGroupsUser'
  Thay thế nội dung sau:
  - PRINCIPAL: địa chỉ email của người dùng chính cần có quyền truy cập – ví dụ: user:test-user@gmail.com cho một cá nhân hoặc group:admins@example.com cho một nhóm.
    
    Để biết thêm thông tin, hãy xem gcloud projects set-iam-policy.
2. Khi được nhắc chỉ định một điều kiện, hãy nhập None.
Một phần của chỉ mục
Bạn có thể tạo nhiều nhóm kho lưu trữ và chỉ định vai trò IAM cho các nguyên tắc IAM khác nhau.
```
  data "google_iam_policy" "foo" {
    binding {
      role = "roles/cloudaicompanion.repositoryGroupsUser"
      members = ["test-user@example.com"]
    }
  }

  resource "google_gemini_repository_group_iam_policy" "foo" {
    project = "PROJECT_ID"
    location = "REGION"
    code_repository_index_id = "INDEX_NAME"
    repository_group_id = "GROUP_NAME"
    policy_data = data.google_iam_policy.foo.policy_data
  }

  data "google_gemini_repository_group_iam_policy" "foo" {
    project = "PROJECT_ID"
    location = "REGION"
    code_repository_index_id = "INDEX_NAME"
    repository_group_id = "GROUP_NAME"
    depends_on = [
      google_gemini_repository_group_iam_policy.foo
    ]
  }
```
Bạn cũng có thể tạo một liên kết:
```
  resource "google_gemini_repository_group_iam_binding" "foo" {
    project = "PROJECT_ID"
    location = "REGION"
    code_repository_index_id = "INDEX_NAME"
    repository_group_id = "GROUP_NAME"
    role = "roles/cloudaicompanion.repositoryGroupsUser"
    members = ["test-user@example.com"]
  }
```
Thay thế nội dung sau:
- GROUP_NAME: tên nhóm kho lưu trữ mà bạn đã tạo ở bước trước để kiểm soát quyền truy cập vào chỉ mục bằng cách sử dụng nhóm kho lưu trữ.

Kiểm tra trạng thái lập chỉ mục

Tuỳ thuộc vào số lượng kho lưu trữ mà bạn muốn lập chỉ mục và kích thước của chúng, việc lập chỉ mục nội dung có thể mất đến 24 giờ. Đối với các kho lưu trữ lớn, quá trình lập chỉ mục có thể mất nhiều thời gian hơn. Quá trình lập chỉ mục diễn ra 24 giờ một lần, ghi nhận mọi thay đổi được thực hiện trong kho lưu trữ.

Tìm nhật ký indexing. Để biết thêm thông tin, hãy xem phần Ghi nhật ký ngôn ngữ truy vấn.
Giao diện dòng lệnh
1. Trong Google API Console, hãy chuyển đến Trình khám phá nhật ký.
  
  Chuyển đến Trình khám phá nhật ký
2. Sử dụng bộ lọc tên nhật ký để xem nhật ký indexing.
CLI
Để tìm kiếm nhật ký lập chỉ mục, trong môi trường shell, hãy dùng lệnh logging read:
```
gcloud logging read "logName="projects/PROJECT_ID/logs/indexing""
```
Thay PROJECT_ID bằng mã dự án nơi nhóm kho lưu trữ được đặt.

Ví dụ: để xem lỗi trong nhật ký indexing, hãy chạy lệnh sau:
```
gcloud logging read "logName="projects/PROJECT_ID/logs/indexing" AND severity>=ERROR"
```
Xem xét các trạng thái lập chỉ mục có liên quan, chẳng hạn như:
- Bắt đầu lập chỉ mục kho lưu trữ – ví dụ: Indexing repository REPOSITORY_NAME. Total number of repositories: 10, succeeded: 6, failed: 0.
- Kết thúc quá trình lập chỉ mục kho lưu trữ riêng lẻ – ví dụ:
  - Thành công: Successfully finished indexing repository REPOSITORY_NAME. Total number of repositories: 10, succeeded: 7, failed: 0.
  - Không thành công: Failed to index repository REPOSITORY_NAME. Error: [<error message>]. Total number of repositories: 10, succeeded: 7, failed: 1.
- Kết thúc lập chỉ mục kho lưu trữ – ví dụ:
  - Thành công: Finished indexing process. Repositories attempted: 10. Repositories successfully indexed: 9. Repositories unsuccessfully fetched: 0.
  - Không thành công: Finished indexing process. Repositories attempted: 10. Repositories successfully indexed: 9. Repositories unsuccessfully fetched: 1. Repositories that were not successfully fetched will be retried in the next run.
Trong các trạng thái chỉ mục, REPOSITORY_NAME là kho lưu trữ mà bạn muốn xem xét.
Xem xét các lỗi lập chỉ mục liên quan, chẳng hạn như:
- Không tìm nạp được kho lưu trữ.
- Không liệt kê được các tệp trong kho lưu trữ.
- Không truy xuất được thông tin kho lưu trữ từ chỉ mục.
- Không truy xuất được tệp từ chỉ mục.
- Lỗi nội bộ.

Sử dụng tính năng tuỳ chỉnh mã

Sau khi thiết lập chế độ tuỳ chỉnh mã, bạn sẽ bắt đầu thấy các đề xuất hoàn thành mã và tạo mã. Các đề xuất này có thể dựa trên mã riêng tư mà bạn đã lập chỉ mục, ngoài các kết quả từ khả năng nhận biết toàn bộ cơ sở mã.

Để tìm hiểu thêm về cách sử dụng tính năng tuỳ chỉnh mã và các phương pháp hay nhất, hãy xem bài viết Sử dụng tính năng tuỳ chỉnh mã.

Tắt tính năng tuỳ chỉnh mã

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

Giao diện dòng lệnh

Trong API Console, hãy chuyển đến trang Gemini Products (Các sản phẩm của Gemini).

Chuyển đến Các sản phẩm của Gemini

Trang Các sản phẩm của Gemini sẽ tải.
Trong trình đơn điều hướng, hãy nhấp vào Tuỳ chỉnh mã.

Trang Tuỳ chỉnh mã sẽ tải.
Để xoá chỉ mục, hãy nhấp vào Xoá chỉ mục.

Một thông báo cảnh báo sẽ xuất hiện. Nếu bạn muốn tiếp tục và xoá chỉ mục, hãy nhập tên chỉ mục rồi nhấp vào Xoá.

CLI

Để liệt kê tất cả các nhóm kho lưu trữ cho chỉ mục hiện tại, trong môi trường shell, hãy dùng lệnh gemini code-repository-indexes repository-groups list:
```
gcloud gemini code-repository-indexes repository-groups list --location=REGION \
    --project=PROJECT_ID \
    --code-repository-index=INDEX_NAME --uri
```
Thay thế nội dung sau:
- REGION: khu vực được định cấu hình trong Developer Connect trong dự án trên Cloud. Xin lưu ý rằng các lệnh sẽ không thành công nếu bạn chỉ định một khu vực không được hỗ trợ. Xem các giới hạn về việc tuỳ chỉnh mã để biết danh sách các khu vực được hỗ trợ.
- PROJECT_ID: mã dự án của bạn trên Google Cloud.
- INDEX_NAME: tên của chỉ mục mà bạn đã tạo trong bước trước để tạo chỉ mục.

Để xoá một nhóm kho lưu trữ khỏi chỉ mục hiện tại, hãy sử dụng lệnh gemini code-repository-indexes repository-groups delete:

gcloud gemini code-repository-indexes repository-groups delete REPOSITORY_GROUP \
    --location=REGION \
    --project=PROJECT_ID \
    --code-repository-index=INDEX_NAME

Lặp lại các bước trước đó cho từng nhóm kho lưu trữ cho đến khi bạn xoá tất cả các nhóm kho lưu trữ khỏi chỉ mục.
Không bắt buộc: Để xoá chỉ mục, trong môi trường shell, hãy dùng lệnh gemini code-repository-indexes delete:
```
gcloud gemini code-repository-indexes delete INDEX_NAME \
    --location=REGION \
    --project=PROJECT_ID
```

Bước tiếp theo

Bắt đầu sử dụng Gemini Code Assist:
- VS Code, IntelliJ và các IDE khác được JetBrains hỗ trợ: Lập trình bằng Gemini Code Assist
- Cloud Shell: Viết mã bằng Gemini Code Assist
- Máy trạm trên đám mây: Lập trình bằng Gemini Code Assist
Tìm hiểu cách sử dụng tính năng tuỳ chỉnh mã và các phương pháp hay nhất.
Tìm hiểu cách mã hoá dữ liệu bằng khoá mã hoá do khách hàng quản lý (CMEK).
Tìm hiểu thêm về Developer Connect.
Tìm hiểu cách thức và thời điểm Gemini cho Google Cloud sử dụng dữ liệu của bạn.

Định cấu hình tính năng tuỳ chỉnh mã của Gemini Code Assist 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.

Trước khi bắt đầu

Chọn kho lưu trữ được lập chỉ mục

Không bắt buộc: Chọn những tệp không được lập chỉ mục

Định cấu hình chế độ tuỳ chỉnh mã của Gemini Code Assist

Giao diện dòng lệnh

CLI

JSON

YAML

JSON

YAML

Toàn bộ chỉ mục

Một phần của chỉ mục

Terraform

JSON

YAML

JSON

YAML

Toàn bộ chỉ mục

Một phần của chỉ mục

Kiểm tra trạng thái lập chỉ mục

Giao diện dòng lệnh

CLI

Sử dụng tính năng tuỳ chỉnh mã

Tắt tính năng tuỳ chỉnh mã

Giao diện dòng lệnh

CLI

Bước tiếp theo

Định cấu hình tính năng tuỳ chỉnh mã của Gemini Code Assist