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

Sử dụng tính năng trò chuyện dựa trên tác nhân như một lập trình viên cặp

Tài liệu này mô tả cách định cấu hình và sử dụng chế độ tác nhân Gemini Code Assist làm lập trình viên cặp trong môi trường phát triển tích hợp (IDE).

Chế độ tác nhân có trong IDE VS Code.

Ở chế độ đại lý, bạn có thể làm những việc sau đây và nhiều việc khác:

Đặt câu hỏi về mã của bạn.
Sử dụng bối cảnh và các công cụ tích hợp để cải thiện nội dung được tạo.
Định cấu hình các máy chủ MCP để mở rộng khả năng của tác nhân.
Nhận giải pháp cho các tác vụ phức tạp có nhiều bước.
Tạo mã từ tài liệu thiết kế, vấn đề và nhận xét TODO.
Kiểm soát hành vi của trợ lý bằng cách nhận xét, chỉnh sửa và phê duyệt kế hoạch cũng như việc sử dụng công cụ trong quá trình thực thi.

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

Các hạn chế sau đây áp dụng khi sử dụng chế độ đại lý:

Tác nhân không thể gọi các công cụ Gemini Code Assist. Bạn phải thoát khỏi chế độ đặc vụ để sử dụng các công cụ này.
Nhân viên hỗ trợ không thể sử dụng tính năng tuỳ chỉnh mã. Bạn phải thoát khỏi chế độ đại lý để sử dụng tính năng tuỳ chỉnh mã.
Các dự án có nhiều thư mục gốc không được hỗ trợ ở chế độ tác nhân. Nếu bạn sử dụng chế độ tác nhân trong một dự án có nhiều thư mục gốc, thì tác nhân sẽ chỉ có quyền truy cập vào thư mục gốc đầu tiên mà tác nhân gặp phải.
Nhật ký của Gemini cho Google Cloud không được hỗ trợ ở chế độ tác nhân.

Trước khi bắt đầu

Thiết lập phiên bản Gemini Code Assist mà bạn muốn dùng trong IDE:
- Gemini Code Assist dành cho cá nhân
- Gemini Code Assist Tiêu chuẩn hoặc Doanh nghiệp
Đặt kênh phát hành Gemini Code Assist thành bản dựng Người dùng nội bộ:
1. Mở Bảng lệnh (Cmd + Shift + P), sau đó chọn Mở tệp JSON Cài đặt người dùng.
2. Thêm dòng sau vào tệp JSON cài đặt người dùng:
```
"geminicodeassist.updateChannel": "Insiders",
```

Sử dụng chế độ tác nhân

Ở chế độ tác nhân, bạn có thể yêu cầu Gemini hoàn thành các mục tiêu cấp cao và các nhiệm vụ phức tạp.

Để khai thác tối đa chế độ trợ lý, hãy làm theo các phương pháp hay nhất về câu lệnh và cung cấp càng nhiều thông tin chi tiết càng tốt.

Cách chuyển sang chế độ nhân viên hỗ trợ:

VS Code

Để mở cuộc trò chuyện Gemini Code Assist, trong thanh hoạt động của IDE, hãy nhấp vào spark Gemini Code Assist.
Nhấp vào nút bật/tắt Agent (Nhân viên hỗ trợ) để chuyển sang chế độ nhân viên hỗ trợ. Nút bật/tắt sẽ được đánh dấu khi chuyển sang chế độ nhân viên hỗ trợ và có màu xám khi ở chế độ trò chuyện thông thường.
Trong cuộc trò chuyện với Gemini Code Assist, hãy nhập câu lệnh của bạn.

Gemini trả lời câu lệnh của bạn hoặc yêu cầu bạn cấp quyền sử dụng một công cụ.

Để dừng tác nhân, hãy nhấp vào Dừng.

Để sử dụng chế độ trò chuyện Gemini Code Assist tiêu chuẩn, hãy nhấp vào New chat (Cuộc trò chuyện mới) để tạo một cuộc trò chuyện mới.

Chế độ tác nhân Gemini Code Assist được hỗ trợ bởi Gemini CLI.

IntelliJ

Gemini Code Assist không hỗ trợ tính năng này trong IntelliJ hoặc các IDE khác của JetBrains.

Định cấu hình các công cụ cho chế độ tác nhân

Công cụ là một danh mục rộng gồm các dịch vụ mà một tác nhân có thể sử dụng cho ngữ cảnh và hành động trong phản hồi của tác nhân đối với câu lệnh của bạn. Một số công cụ ví dụ là các công cụ tích hợp như grep và đọc hoặc ghi tệp, máy chủ Giao thức ngữ cảnh mô hình (MCP) cục bộ hoặc từ xa và các hàm thực thi của chúng, hoặc các triển khai dịch vụ riêng.

Định cấu hình máy chủ MCP

Để kiểm soát những máy chủ có sẵn ở chế độ đại lý, hãy thêm các máy chủ đó vào tệp JSON cài đặt Gemini theo tài liệu về máy chủ.

VS Code

Cài đặt mọi phần phụ thuộc mà máy chủ MCP của bạn yêu cầu.
Mở tệp JSON cài đặt Gemini nằm trong ~/.gemini/settings.json, trong đó ~ là thư mục chính của bạn.

Thêm máy chủ MCP cục bộ hoặc từ xa vào tệp JSON chế độ cài đặt Gemini theo hướng dẫn của máy chủ.

Ví dụ sau đây sẽ thêm máy chủ MCP Cloudflare từ xa và cài đặt máy chủ GitHub và GitLab trên máy cục bộ.

{
    "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
      }
    },
    "gitlab": {
      "command": "npx",
      "args": [
          "-y",
          "@modelcontextprotocol/server-gitlab"
      ]
    },
        "cloudflare-observability": {
            "command": "npx",
            "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
        },
        "cloudflare-bindings": {
            "command": "npx",
            "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"]
        }
    }
}

Mở bảng lệnh rồi chọn Nhà phát triển: Tải lại cửa sổ.

Các máy chủ MCP mà bạn đã định cấu hình sẽ có sẵn để tác nhân sử dụng ở chế độ tác nhân.

IntelliJ

Gemini Code Assist không hỗ trợ tính năng này trong IntelliJ hoặc các IDE khác của JetBrains.

Xác thực máy chủ MCP

Đối với những máy chủ MCP yêu cầu xác thực, bạn có thể thêm chúng vào tệp JSON cài đặt Gemini.

Ví dụ sau đây sẽ thêm mã truy cập cá nhân cho GitHub:

{
//other settings...

"github": {
  "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
  "args": ["stdio"],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
  }
},

// other settings...
}

Trong đó ACCESS_TOKEN là mã thông báo truy cập của người dùng.

Tạo tệp ngữ cảnh

Ngữ cảnh cho phép một tác nhân tạo ra câu trả lời phù hợp hơn cho một câu lệnh nhất định. Bạn có thể lấy bối cảnh từ các tệp trong IDE, các tệp trong thư mục hệ thống cục bộ, các câu trả lời của công cụ và thông tin chi tiết về câu lệnh. Để biết thêm thông tin, hãy xem phần Ngữ cảnh chế độ tác nhân.

VS Code

Tạo một tệp có tên là GEMINI.md ở một vị trí phù hợp với phạm vi mà bạn muốn áp dụng ngữ cảnh. Bảng sau đây trình bày chi tiết các vị trí của tệp bối cảnh cho nhiều phạm vi:

Phạm vi	Vị trí
Tất cả dự án của bạn	`~/.gemini/GEMINI.md`
Một dự án cụ thể	Thư mục làm việc của bạn hoặc bất kỳ thư mục mẹ nào cho đến thư mục gốc của dự án (được xác định bằng thư mục `.git`) hoặc thư mục chính của bạn.
Một thành phần, mô-đun hoặc phần phụ cụ thể của một dự án	Thư mục con của thư mục đang làm việc.

Hệ thống bộ nhớ của tác nhân được tạo bằng cách tải các tệp ngữ cảnh từ nhiều vị trí. Ngữ cảnh từ các tệp cụ thể hơn, chẳng hạn như các tệp cho các thành phần hoặc mô-đun cụ thể, sẽ ghi đè hoặc bổ sung nội dung từ các tệp ngữ cảnh chung hơn, chẳng hạn như tệp ngữ cảnh chung tại ~/.gemini/GEMINI.md.

Viết mọi quy tắc, thông tin hướng dẫn về phong cách hoặc bối cảnh mà bạn muốn tác nhân sử dụng ở định dạng Markdown rồi lưu tệp. Để biết thêm thông tin, hãy xem tệp ngữ cảnh mẫu trên GitHub.

IntelliJ

Gemini Code Assist không hỗ trợ tính năng này trong IntelliJ hoặc các IDE khác của JetBrains.

Sử dụng lệnh

Lệnh dấu gạch chéo / giúp bạn nhanh chóng chạy các lệnh tương tự như lệnh trong cửa sổ dòng lệnh.

Bạn có thể dùng các lệnh Gemini CLI sau đây ở chế độ tác nhân:

/tools: Hiển thị danh sách các công cụ có trong phiên hoạt động ở chế độ đại lý. Các lệnh phụ bao gồm:
- desc hoặc descriptions: Cho biết nội dung mô tả chi tiết của từng công cụ.
- nodesc hoặc nodescriptions: Ẩn nội dung mô tả công cụ và chỉ hiện tên công cụ.
/memory: Quản lý ngữ cảnh hướng dẫn của tác nhân được tải từ các tệp GEMINI.md. Các lệnh phụ bao gồm:
- show: Hiển thị toàn bộ nội dung được nối của bộ nhớ hiện tại được tải từ tất cả các tệp GEMINI.md có sẵn.
- refresh: Tải lại bộ nhớ từ tất cả các tệp GEMINI.md ở những vị trí có sẵn. Để biết thông tin về cách tệp GEMINI.md đóng góp vào bộ nhớ phân cấp của tác nhân, hãy xem tài liệu về Cấu hình Gemini CLI.
/mcp: Liệt kê các máy chủ Giao thức bối cảnh mô hình (MCP) đã định cấu hình, trạng thái kết nối, thông tin chi tiết về máy chủ và các công cụ có sẵn. Các lệnh phụ bao gồm:
- desc hoặc descriptions: Cho biết nội dung mô tả chi tiết về các máy chủ và công cụ MCP.
- nodesc hoặc nodescriptions: Ẩn nội dung mô tả máy chủ MCP và chỉ hiện tên máy chủ MCP.
- schema: Hiện giản đồ JSON đầy đủ cho các thông số đã định cấu hình của máy chủ MCP.
/stats: Hiển thị số liệu thống kê chi tiết về phiên ở chế độ nhân viên hỗ trợ và thời lượng.

Để biết thêm thông tin về các lệnh Gemini CLI, hãy xem phần Các lệnh Gemini CLI. Xin lưu ý rằng không phải lệnh nào của Gemini CLI cũng dùng được ở chế độ tác nhân.

Luôn cho phép các hành động của trợ lý

Bạn có thể tự động cho phép tất cả các hành động của trợ lý.

Cách tự động cho phép tất cả các hành động của trợ lý:

Mở tệp JSON chứa chế độ cài đặt người dùng của VS Code:
1. Mở Bảng lệnh (ctrl/command + Shift + P).
2. Chọn Lựa chọn ưu tiên: Mở phần Cài đặt người dùng (JSON).

Thêm nội dung sau vào tệp JSON cài đặt người dùng VS Code:

//other settings...

"geminicodeassist.agentYoloMode": "true",
//other settings...

Mở bảng lệnh rồi chọn Nhà phát triển: Tải lại cửa sổ.

Chế độ tác nhân sử dụng chế độ yolo và sẽ không yêu cầu cấp quyền trước khi thực hiện hành động khi bạn gửi cho chế độ này một câu lệnh.

Tạo tiện ích Gemini CLI

Bạn có thể sử dụng các tiện ích Gemini CLI để định cấu hình và mở rộng chức năng chế độ tác nhân Gemini Code Assist.

Tác nhân tìm kiếm các tiện ích ở hai vị trí:

WORKSPACE/.gemini/extensions trong đó WORKSPACE là không gian làm việc hiện tại của bạn.
~/.gemini/extensions, trong đó ~ là thư mục chính của bạn.

Tác nhân sẽ tải tất cả các tiện ích từ cả hai vị trí, nhưng nếu có một tiện ích có cùng tên ở cả hai vị trí, thì tiện ích trong thư mục không gian làm việc sẽ được ưu tiên. Mỗi tiện ích là một thư mục chứa tệp gemini-extension.json. Tệp này chứa cấu hình cho tiện ích.

Để biết thêm thông tin, hãy xem bài viết Tiện ích Gemini CLI.

Lời nhắc bổ sung

Hãy thử các câu lệnh sau với thông tin của riêng bạn:

"Kho lưu trữ này có chức năng gì? Giúp tôi hiểu rõ cấu trúc."
"[Lớp/hàm] này làm gì?"
"Thêm một tính năng vào cơ sở mã này – "[đường liên kết hoặc đường dẫn đến cơ sở mã]"."
"Tái cấu trúc hàm [A] và [B] để sử dụng phương thức chung [C]."
"Khắc phục vấn đề trên GitHub [link-to-github-issue]."
"Xây dựng một ứng dụng để thực hiện [mục tiêu] với giao diện người dùng cho phép người dùng thực hiện [tác vụ] trong [môi trường]."
"Di chuyển các phiên bản thư viện trong kho lưu trữ này từ [X] sang [Y]."
"Tối ưu hoá hiệu suất của mã Go này để chạy nhanh hơn."
"Sử dụng [tên của API] để xây dựng tính năng này".
"Triển khai một thuật toán để thực hiện [x], [Y] và [Z]."

Bước tiếp theo

Đọc bài viết Tổng quan về Gemini Code Assist.
Khám phá một số ví dụ về máy chủ MCP.
Tìm thêm các máy chủ MCP trên GitHub.
Gửi ý kiến phản hồi từ IDE.

Sử dụng tính năng trò chuyện dựa trên tác nhân như một lập trình viên cặ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.

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

Trước khi bắt đầu

Sử dụng chế độ tác nhân

VS Code

IntelliJ

Định cấu hình các công cụ cho chế độ tác nhân

Định cấu hình máy chủ MCP

VS Code

IntelliJ

Xác thực máy chủ MCP

Tạo tệp ngữ cảnh

VS Code

IntelliJ

Sử dụng lệnh

Luôn cho phép các hành động của trợ lý

Tạo tiện ích Gemini CLI

Lời nhắc bổ sung

Bước tiếp theo

Sử dụng tính năng trò chuyện dựa trên tác nhân như một lập trình viên cặp