Tác nhân (agent) làm được những gì
Tác nhân (agent) có thể đọc các hệ thống của bạn và, khi bạn cho phép, thay đổi chúng - bình luận vào một ticket, chuyển ticket sang In Review, mở một pull request. Trang này liệt kê những gì nó chạm tới được và những gì kiểm soát một thao tác ghi.
Một bộ kết nối đọc được và không ghi được cho tới khi bạn bật quyền Ghi cho nó. Ngay cả khi đó, từng thay đổi thực hiện từ khung trò chuyện vẫn được đưa ra cho bạn xem trước khi xảy ra.
Ba cửa kiểm soát
Mọi thao tác ghi từ khung trò chuyện đều phải đi qua cả ba.
1. Quyền, theo từng bộ kết nối
Cài đặt → Kết nối, rồi chọn bộ kết nối. Jira, Confluence và Bitbucket mỗi loại đều có hai công tắc:
| Công tắc | Cho phép | Mặc định |
|---|---|---|
| Đọc | Tìm kiếm và đọc trực tiếp hệ thống đó, từ khung trò chuyện và từ một máy khách MCP đã kết nối. Những gì bạn đã lập chỉ mục vẫn tìm kiếm được khi tắt quyền Đọc | Bật |
| Ghi | Tạo, cập nhật và xóa nội dung ở đó thay mặt bạn | Tắt |
Tắt quyền Ghi có hiệu lực ngay lập tức. Việc này không hoàn tác những thay đổi đã thực hiện. Các công cụ của một bộ kết nối chỉ hoạt động trên gói bản quyền có bao gồm bộ kết nối đó.
Subversion không có công tắc Ghi vì nó chỉ đọc. Việc thêm hoặc gỡ bỏ các nguồn dữ liệu được lập chỉ mục có quyền riêng, tách biệt với các công tắc của bộ kết nối.
2. Hỏi trước, Tự động hoặc Chỉ đọc
Bên cạnh mô hình trong khung trò chuyện, hãy chọn cách tác nhân xử lý một thay đổi. Mỗi lần bạn mở Proxyma, chế độ trở về Hỏi trước.
| Chế độ | Kết quả |
|---|---|
| Hỏi trước | Mỗi thay đổi dừng lại trong cuộc trò chuyện và chờ bạn. |
| Tự động | Các thay đổi được tiến hành mà không hỏi. Quyền Ghi vẫn phải đang bật. |
| Chỉ đọc | Mọi thay đổi trong khung trò chuyện đều bị từ chối. Việc đọc vẫn diễn ra như thường. |
Ở chế độ Hỏi trước, một thay đổi cho bạn xem công cụ cùng các tham số của nó:
| Lựa chọn | Kết quả |
|---|---|
| Cho phép một lần | Thay đổi này được tiến hành; thay đổi kế tiếp lại hỏi lần nữa. |
| Cho phép trong cuộc trò chuyện này | Những thay đổi còn lại trong cuộc trò chuyện này được tiến hành mà không hỏi lại. |
| Từ chối | Thay đổi không diễn ra, và tác nhân tiếp tục công việc. |
Nếu bạn không trả lời trong vòng năm phút, trang sẽ từ chối thay đổi thay bạn. Nếu trang đã đóng, thay đổi bị từ chối sau 30 phút.
Một máy khách MCP có thể chạy công cụ ghi khi quyền Ghi đang bật, và không ai được hỏi để chấp thuận thay đổi đó.
3. Thông tin đăng nhập của chính bạn
Mọi hành động đều chạy bằng mã truy cập bạn đã lưu trong Cài đặt.
- Với token của bạn, tác nhân không làm được điều gì mà chính bạn không làm được. Nếu Jira từ chối bạn thì nó cũng từ chối tác nhân.
- Một chỉnh sửa được ghi nhận là của chủ sở hữu token. Với token của bạn, bình luận do tác nhân viết sẽ hiện dưới tên bạn.
Chia sẻ một nguồn dữ liệu cho phép đồng nghiệp tìm kiếm trong đó. Họ cần token của riêng mình trước khi tác nhân hành động thay họ.
Nó chạm tới được những gì
Việc đọc Jira, Confluence, Bitbucket và Subversion cần quyền Đọc đang bật. Cột Thay đổi cần quyền Ghi đang bật và, trong khung trò chuyện ở chế độ Hỏi trước, sự chấp thuận của bạn.
Jira
| Đọc | Thay đổi |
|---|---|
| Tìm kiếm bằng JQL, đọc trọn vẹn một issue kèm các bình luận của nó, liệt kê các dự án, liệt kê fix version, liệt kê các trường máy chủ có, liệt kê các loại issue của một dự án và các trường mỗi loại cần | Tạo một issue; sửa summary, description, priority, assignee, labels, fix versions, components, due date và các trường tùy chỉnh; chuyển issue qua một bước chuyển trạng thái trong quy trình; thêm, sửa và xóa bình luận; đặt ước lượng thời gian; ghi nhận công việc đã làm; tạo và gỡ liên kết giữa các issue; đính kèm một tệp tin; tạo một fix version; xóa một issue. Mọi loại issue mà dự án có - Epic, Story, Task, Bug, Sub-task hoặc loại do bạn tự đặt - và một Story có thể được đặt dưới một Epic |
Confluence
| Đọc | Thay đổi |
|---|---|
| Tìm kiếm bằng CQL, đọc một trang, liệt kê các space | Tạo, cập nhật, di chuyển và xóa một trang; thêm và gỡ nhãn; đính kèm một tệp tin; thêm, sửa và xóa bình luận |
Bitbucket
| Đọc | Thay đổi |
|---|---|
| Liệt kê các nhánh, thẻ và commit; đọc một pull request cùng phần thảo luận của nó; đọc phần khác biệt của một pull request hoặc một commit; liệt kê và đọc các tệp tin trong một kho mã mà không cần clone; tải toàn bộ một kho mã tại một nhánh, một thẻ hoặc một commit (chỉ qua MCP) | Mở một pull request; bình luận vào nó, vào một tệp tin hoặc vào một dòng trong phần khác biệt, và trả lời một bình luận; phê duyệt hoặc yêu cầu chỉnh sửa; hợp nhất nó; tạo và xóa một nhánh; tạo một thẻ |
Hợp nhất và phê duyệt một pull request không thể đảo ngược từ Proxyma, và một lượt phê duyệt được tính vào các điều kiện hợp nhất của kho mã dưới tên bạn. Ở chế độ Hỏi trước, cả hai đều xin chấp thuận trước - hãy đọc pull request trước khi bạn chấp thuận. Ở chế độ Tự động thì không.
Subversion
Chỉ đọc. Tác nhân liệt kê thư mục và đọc tệp tin từ máy chủ mà không cần checkout. Nó không bao giờ commit.
Việc này cần tên đăng nhập và mật khẩu SVN của chính bạn được lưu trong Cài đặt. Trên máy chủ VisualSVN dùng Windows Authentication, tên đăng nhập có kèm tên miền; với Subversion Authentication, đó là tên trong danh sách người dùng của máy chủ.
Tệp tin, trang web và web công cộng
| Đọc | Thay đổi |
|---|---|
| Mọi thứ bạn đã lập chỉ mục, đồng thời theo ngữ nghĩa và theo từ khóa; một trang hoặc một tệp tin tại bất kỳ URL nào; một lượt tìm kiếm trên web công cộng, không cần thiết lập gì | Thêm và gỡ bỏ các nguồn dữ liệu được lập chỉ mục - một thư mục, một trang web cần thu thập nội dung, một dự án Jira, một space Confluence, một kho mã |
Tác nhân không bao giờ thay đổi các tài liệu bạn lập chỉ mục; nó đọc chúng ngay tại chỗ.
Tệp Office. Khi được yêu cầu, tác nhân tạo hoặc chỉnh sửa tệp Word, Excel và PowerPoint, kể cả biểu đồ. Trên Home Server và Enterprise Server, nó làm việc với tệp đính kèm trong một container cô lập. Trên Desktop, nó còn có thể lưu vào máy tính của bạn, và hỏi bạn trước mỗi lần trừ khi bạn đã chọn Cho phép trong cuộc trò chuyện này hoặc Tự động.
Mọi thứ khác mà các hệ thống đó làm được
Tác nhân cũng có thể gọi trực tiếp bất kỳ điểm cuối nào của API Jira, Confluence và Bitbucket - ví dụ người theo dõi, hạn chế truy cập trang hoặc thiết lập kho mã.
Trong khung trò chuyện, lời gọi chỉ đọc (GET) cần quyền Đọc đang bật và chạy mà không hỏi; mọi lời gọi khác cần quyền Ghi đang bật và, ở chế độ Hỏi trước, sự chấp thuận của bạn. Từ một máy khách MCP, việc đọc cần quyền Đọc đang bật và việc thay đổi cần quyền Ghi đang bật. Nó không chạm tới được hệ thống bạn chưa cấu hình, và không làm được ở đó điều mà token nó đang dùng không làm được.
Tác nhân phụ
Tác nhân giao từng phần công việc cho các tác nhân phụ: những tác nhân khác, mỗi tác nhân có ngữ cảnh riêng. Chúng dùng mô hình và các giới hạn của tác nhân, trừ khi bạn chọn khác trong Cài đặt → Tác nhân → Tác nhân phụ; một mô hình rẻ hơn ở đó giúp việc đọc dài không tính theo giá của tác nhân. Tác nhân phụ có các công cụ của tác nhân và đi qua cùng ba cửa kiểm soát. Ở chế độ Hỏi trước, các thay đổi của nó chờ bạn chấp thuận, và lời nhắc nêu tên tác nhân phụ.
Tác nhân phụ chạy nền, nên bạn có thể tiếp tục trò chuyện trong khi chúng làm việc; tác nhân chỉ chờ một tác nhân phụ khi bước tiếp theo của nó cần câu trả lời đó. Tác nhân sẽ cho bạn biết kết quả của từng tác nhân phụ khi nó báo cáo. Mỗi tác nhân phụ có một khung trong luồng trò chuyện cho thấy nó đang làm gì, kèm nút Dừng riêng, và khung đó thu gọn lại khi tác nhân phụ kết thúc.
Nút bên cạnh mô hình dưới ô nhập tin nhắn mở cửa sổ tác nhân: mọi tác nhân trong cuộc trò chuyện, kể cả những tác nhân đã xong, cùng mức sử dụng và chi phí của từng tác nhân. Tổng thời gian ở đó tính khoảng thời gian có ít nhất một tác nhân làm việc, và nhấp vào một tác nhân phụ sẽ hiện các bước của nó. Khi các tác nhân phụ đang làm việc, mỗi tác nhân phụ có một robot thế chỗ nút này, tối đa ba robot; nhấp vào một robot để tới khung của tác nhân phụ đó trong luồng trò chuyện. Quá ba tác nhân, +N mở cửa sổ tác nhân. Trên Enterprise Server, quản trị viên thấy các nút này.
Khi chạm giới hạn tốc độ của nhà cung cấp, điều dễ xảy ra khi nhiều tác nhân phụ chạy cùng lúc, các tác nhân chờ và thử lại tối đa 10 phút. Tác nhân phụ vẫn không thể tiếp tục sẽ báo lý do cho tác nhân chính.
Bộ nhớ
Tác nhân lưu các thông tin nó học được và sở thích của bạn, và xem chúng trước khi tìm trong các nguồn của bạn. Cài đặt → Bộ nhớ liệt kê mọi thứ nó đã lưu: sửa một mục, chuyển mục giữa Về bạn và Kiến thức, hoặc đánh dấu nhiều mục rồi xóa. Trên Enterprise Server, mỗi người dùng chỉ thấy bộ nhớ của mình.
Nó làm việc trong bao lâu
Một vòng lặp là một lần gọi mô hình cùng các lời gọi công cụ mà lần gọi đó thực hiện. Cài đặt → Tác nhân → Số vòng lặp tối đa của tác nhân giới hạn số vòng lặp cho mỗi câu trả lời: 20, 50 (mặc định), 100 hoặc Không giới hạn. Khi chạm giới hạn, tác nhân dừng lại và hỏi: Tiếp tục cho nó thêm chừng ấy vòng lặp nữa, còn Dừng ở đây để nó trả lời bằng những gì đã có. Số vòng lặp tối đa của tác nhân phụ giới hạn từng tác nhân phụ: bằng giới hạn của tác nhân trừ khi bạn đặt khác, với cùng các lựa chọn. Tác nhân phụ chạm giới hạn sẽ báo cáo những gì nó đã có. Giới hạn thời gian của tác nhân phụ dừng một tác nhân phụ sau 5 đến 120 phút (mặc định 30) và yêu cầu nó một lần báo cáo những gì đã tìm được; thời gian chờ bạn chấp thuận không được tính. Cài đặt → Tìm kiếm → Giới hạn thời gian tìm kiếm cho một lần tìm kiếm trong các nguồn của bạn từ 1 đến 15 phút (mặc định 5); các công cụ khác dừng sau một phút. Trên Enterprise Server, Siêu quản trị viên đặt cả bốn giá trị này.
Nhấn Dừng để kết thúc một lượt chạy bất cứ lúc nào. Càng nhiều vòng lặp thì càng nhiều lần gọi mô hình, và càng tốn chi phí.
Với nhà cung cấp Anthropic, hoặc một nhà cung cấp tương thích OpenAI đã bật Gửi chỉ dẫn bộ nhớ đệm (OpenRouter, đứng trước các mô hình Claude, Qwen hoặc Gemini), Cài đặt → Tác nhân → Bộ nhớ đệm prompt giữ cuộc hội thoại trong bộ nhớ đệm cho lượt tiếp theo. Tự động (mặc định) giữ 5 phút, và 1 giờ khi tác nhân phụ đang chạy nền hoặc khi bạn nghỉ lâu hơn giữa các lượt; ghi cache 1 giờ đắt hơn. Bộ nhớ đệm prompt của tác nhân phụ theo thiết lập này trừ khi bạn chọn khác.
Những điều nó sẽ không làm
- Ghi bất cứ thứ gì khi quyền Ghi đang tắt. Các công cụ từ chối thực hiện.
- Hành động mà không hỏi trong khung trò chuyện, trừ khi bạn đã chọn Tự động, hoặc trước đó đã chọn Cho phép trong cuộc trò chuyện này ngay trong cuộc trò chuyện ấy. Máy khách MCP thì không được hỏi.
- Dùng thông tin đăng nhập của bất kỳ ai khác.
- Để một tác nhân phụ bỏ qua các cửa kiểm soát. Thay đổi của tác nhân phụ chịu cùng quyền, chế độ và sự chấp thuận như của chính tác nhân.
- Gửi tài liệu của bạn tới bất cứ đâu mà bạn không cấu hình. Các lượt tìm kiếm web của nó vẫn được gửi tới DuckDuckGo, hoặc tới Google nếu bạn thêm khóa tìm kiếm Google trong Cài đặt → Tìm kiếm → Tìm kiếm web, kể cả khi dùng mô hình chạy nội bộ - xem phần câu hỏi và giải đáp.
Nếu có gì đó trục trặc
Một hành động bị từ chối sẽ báo lại lý do do chính hệ thống kia đưa ra - ví dụ thiếu quyền trong Jira, bước chuyển trạng thái không hợp lệ, hoặc thao tác hợp nhất bị một điều kiện kiểm tra chặn. Tác nhân được hướng dẫn chuyển tiếp lý do đó thay vì tìm cách làm vòng qua.
Mọi thay đổi đều xuất hiện dưới tên chủ sở hữu token trong lịch sử của Jira, các phiên bản trang của Confluence và nhật ký hoạt động của Bitbucket.
Kiểm tra mọi thứ hoạt động
- Trong Chat, hãy hỏi: Chạy tự kiểm tra.
- Chọn Chỉ đọc, hoặc Đọc và ghi rồi nêu một dự án Jira, một space Confluence hoặc một kho mã Bitbucket dùng để thử. Không có gì được ghi vào nơi khác, và mọi thứ bài kiểm tra tạo ra sẽ bị xóa khi kết thúc.
- Đính kèm một tệp PDF hoặc Word khi được yêu cầu.
- Đọc báo cáo: mỗi mục là PASS, FAIL, SKIPPED (không có trong phiên bản hoặc giấy phép của bạn, hoặc chưa thiết lập) hoặc NEEDS YOU, kèm cách khắc phục cho từng lỗi.
- Làm theo danh sách ngắn các bước kiểm tra được đưa ra ở cuối - những bước chỉ người dùng mới làm được trong ứng dụng.
Để báo lỗi, hãy yêu cầu lưu báo cáo, rồi đính kèm tệp đó vào Gửi góp ý.