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ế độ đạ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 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ế

Một số tính năng của Gemini Code Assist ở chế độ trò chuyện tiêu chuẩn có thể không hoạt động ở chế độ tác nhân hoặc có thể hoạt động khác với chế độ trò chuyện tiêu chuẩn.

Tính năng đọc thuộc lòng không hoạt động ở chế độ tác nhân. Khi ở chế độ tác nhân, Gemini sẽ không trích dẫn nguồn và bạn không thể tắt các đề xuất mã trùng khớp với nguồn được trích dẫn.

Trước khi bắt đầu

VS Code

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

IntelliJ

Thiết lập phiên bản Gemini Code Assist mà bạn muốn dùng trong IDE:

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 tác 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

Nhấp vào spark Gemini trong thanh cửa sổ công cụ. Đăng nhập nếu bạn thấy lời nhắc đăng nhập.
Chọn thẻ Nhân viên hỗ trợ.
Mô tả việc bạn muốn tác nhân thực hiện.
Khi nhân viên hỗ trợ thực hiện các bước để hoàn thành nhiệm vụ, bạn sẽ có thể xem xét và phê duyệt mọi thay đổi.
Không bắt buộc: Để tự động phê duyệt các thay đổi, hãy chọn cài đặt Lựa chọn về tác nhân rồi nhấp vào hộp đánh dấu bên cạnh Tự động phê duyệt các thay đổi.

Thận trọng: Đặc vụ có quyền truy cập vào hệ thống tệp và các thao tác trên thiết bị đầu cuối của máy, cũng như mọi công cụ mà bạn đã định cấu hình để sử dụng. Hãy hết sức cẩn thận khi bạn tự động phê duyệt các thay đổi.

Đị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.

Kiểm soát việc sử dụng các công cụ tích hợp

Chế độ tác nhân có quyền truy cập vào các công cụ tích hợp sẵn như tìm kiếm tệp, đọc tệp, ghi tệp, lệnh trên thiết bị đầu cuối và nhiều công cụ khác.

VS Code

Bạn có thể sử dụng chế độ cài đặt coreTools và excludeTools để kiểm soát những công cụ mà Gemini có quyền truy cập ở chế độ tác nhân.

coreTools: Cho phép bạn chỉ định danh sách các công cụ mà bạn muốn mô hình có thể sử dụng. Bạn cũng có thể chỉ định các hạn chế theo lệnh cho những công cụ hỗ trợ lệnh đó. Ví dụ: việc thêm nội dung sau vào tệp JSON cài đặt Gemini sẽ chỉ cho phép thực thi lệnh shell ls -l:"coreTools": ["ShellTool(ls -l)"].
excludeTools: Cho phép bạn chỉ định danh sách các công cụ mà bạn không muốn mô hình sử dụng. Bạn cũng có thể chỉ định các hạn chế theo lệnh cho những công cụ hỗ trợ lệnh đó. Ví dụ: việc thêm nội dung sau vào tệp JSON cài đặt Gemini sẽ chặn việc sử dụng lệnh rm -rf: "excludeTools": ["ShellTool(rm -rf)"].

Một công cụ có trong cả excludeTools và coreTools sẽ bị loại trừ.

Để định cấu hình các công cụ tích hợp có sẵn ở chế độ tác nhân, hãy làm như sau:

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.
Để hạn chế việc sử dụng công cụ của tác nhân trong danh sách các công cụ được phê duyệt, hãy thêm dòng sau vào tệp JSON cài đặt Gemini:
```
"coreTools": ["TOOL_NAME_1,TOOL_NAME_2"]
```
Thay thế TOOL_NAME_1 và TOOL_NAME_2 bằng tên của các công cụ tích hợp sẵn mà bạn muốn tác nhân có quyền truy cập.

Bạn có thể liệt kê bao nhiêu công cụ tích hợp tuỳ thích. Theo mặc định, tất cả các công cụ tích hợp đều có sẵn cho nhân viên.
Để hạn chế việc sử dụng công cụ của tác nhân đối với các lệnh công cụ cụ thể, hãy thêm dòng sau vào tệp JSON cài đặt Gemini:
```
"coreTools": ["TOOL_NAME(COMMAND)"]
```
Thay thế nội dung sau:
- TOOL_NAME: tên của công cụ tích hợp
- COMMAND: tên của lệnh công cụ tích hợp mà bạn muốn tác nhân có thể sử dụng.
Để loại trừ một công cụ khỏi việc sử dụng tác nhân, hãy thêm dòng sau vào tệp JSON cài đặt Gemini:
```
"excludeTools": ["TOOL_NAME_1,TOOL_NAME_2"]
```
Thay thế TOOL_NAME_1 và TOOL_NAME_2 bằng tên của các công cụ tích hợp mà bạn muốn loại trừ khỏi việc sử dụng tác nhân.
Để loại trừ một lệnh công cụ khỏi việc sử dụng tác nhân, hãy thêm dòng sau vào tệp JSON cài đặt Gemini:
```
"excludeTools": ["TOOL_NAME(COMMAND)"]
```
Thay thế nội dung sau:
- TOOL_NAME: tên của công cụ tích hợp
- COMMAND: tên của lệnh công cụ tích hợp mà bạn muốn loại trừ khỏi việc sử dụng tác nhân.

Để biết thêm thông tin về chế độ cài đặt cấu hình coreTools và excludeTools, hãy xem tài liệu về cấu hình 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 máy chủ MCP

VS Code

Để 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ủ.

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 2 máy chủ MCP Cloudflare từ xa và cài đặt các 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 có sẵn để tác nhân sử dụng ở chế độ tác nhân.

IntelliJ

Để kiểm soát những máy chủ có sẵn ở chế độ tác nhân, hãy thêm các máy chủ đó vào một tệp mcp.json rồi đặt tệp đó vào thư mục cấu hình cho IDE của bạn.

Cài đặt mọi phần phụ thuộc mà máy chủ MCP của bạn yêu cầu.
Tạo một tệp mcp.json trong thư mục cấu hình của IDE.

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"]
    }
  }
}

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

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

Một số máy chủ MCP yêu cầu xác thực. Làm theo tài liệu về máy chủ để tạo mọi mã thông báo người dùng cần thiết, sau đó chỉ định các mã thông báo đó một cách thích hợp. Máy chủ cục bộ có thể chấp nhận các biến môi trường; máy chủ từ xa có thể chấp nhận thông tin đăng nhập trong tiêu đề.

VS Code

Đố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 cho thấy cách chỉ định mã truy cập cá nhân cho các máy chủ MCP cục bộ và từ xa của GitHub:

{
  "mcpServers": {
    "github-remote": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN"
      }
    },
    "github-local": {
      "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
      }
    }
  }
}

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

IntelliJ

Đố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 mcp.json.

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

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

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 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	Thông tin 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.

Trợ lý sẽ đưa thông tin trong tệp ngữ cảnh của bạn vào cùng với mọi câu lệnh mà bạn gửi cho trợ lý.

IntelliJ

Tạo một tệp có tên là GEMINI.md hoặc AGENT.md ở gốc của dự án.
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.

Trợ lý sẽ đưa thông tin trong tệp ngữ cảnh của bạn vào cùng với mọi câu lệnh mà bạn gửi cho trợ lý. Bạn cũng có thể thêm ngữ cảnh bằng cách thêm tệp theo cách thủ công bằng cú pháp @FILENAME, trong đó FILENAME là tên của tệp có thông tin theo ngữ cảnh mà bạn muốn đưa vào.

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.

VS Code

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ý.
/mcp: Liệt kê các máy chủ Giao thức ngữ 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.

Để 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.

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.

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 tác nhân.

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

VS Code

Sử dụng chế độ yolo để tự động cho phép tất cả các hành động của tác nhân. Bạn chỉ có thể sử dụng chế độ Yolo trong không gian làm việc đáng tin cậy.

Cách định cấu hình chế độ yolo:

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. Khi sử dụng không gian làm việc bị hạn chế, bất kể chế độ cài đặt này là gì, tác nhân sẽ nhắc trước khi thực hiện hành động.

IntelliJ

Để tự động phê duyệt các thay đổi, trong thẻ Gemini Chat Agent, hãy chọn cài đặt Lựa chọn về Agent rồi nhấp vào hộp đánh dấu bên cạnh Tự động phê duyệt các thay đổi.

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

Lời nhắc bổ sung

Hãy thử các câu lệnh sau bằng 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

VS Code

IntelliJ

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

Kiểm soát việc sử dụng các công cụ tích hợp

VS Code

IntelliJ

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

VS Code

IntelliJ

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

VS Code

IntelliJ

Tạo tệp ngữ cảnh

VS Code

IntelliJ

Sử dụng lệnh

VS Code

IntelliJ

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

VS Code

IntelliJ

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