Phiên tác nhân AI

Chương này trình bày cách VelaTerm chạy các tác nhân lập trình AI dưới dạng các phiên riêng theo từng loại tác nhân: các tác nhân được hỗ trợ, trạng thái theo thời gian thực, tự động tiếp tục hội thoại, nhập và phân nhánh hội thoại, chế độ quyền, cài đặt khởi chạy, hướng dẫn cài đặt và bảng Info. Chế độ hội thoại được trình bày trong một chương riêng: Chế độ hội thoại.

1. Các tác nhân được hỗ trợ

VelaTerm có thể khởi động các tác nhân sau: Claude Code (hiển thị là “Claude”), Codex, OpenCode, Copilot, Cursor, Antigravity, Cline, Pi, OMP, Crush, Kimi Code, Kiro, Grok Build và Zoo Code. Với mỗi tác nhân, CLI riêng của tác nhân đó phải được cài đặt và đăng nhập sẵn.

Khả năng của từng tác nhân không giống nhau:

• Tác nhân tự báo cáo nghĩa là chính tác nhân thông báo cho VelaTerm khi bắt đầu làm việc, khi cần bạn và khi hoàn tất, nên trạng thái hiển thị chính xác. Codex báo cáo mọi giai đoạn nếu phiên bản Codex hỗ trợ hook vòng đời; các phiên bản Codex cũ hơn chỉ báo cáo khi một lượt kết thúc. Ở những dòng có ✗ trong cột “cần bạn”, tác nhân không báo cáo câu hỏi hoặc yêu cầu cấp quyền, nên phiên hiển thị “đang làm việc” cho đến khi lượt kết thúc.
• Đọc từ màn hình nghĩa là VelaTerm nhận biết trạng thái của tác nhân từ giao diện terminal của tác nhân đó.
• Với Copilot, Cursor, Antigravity, Kimi Code, Kiro và Grok Build, VelaTerm thêm các mục cấu hình riêng vào cấu hình người dùng của tác nhân ở lần đầu tiên bạn khởi động một phiên như vậy. Các mục này không có tác dụng khi tác nhân chạy bên ngoài VelaTerm.
• Các tác nhân bạn tự khởi động trong một terminal thông thường không bị ảnh hưởng; tính năng báo cáo trạng thái chỉ áp dụng cho các phiên tác nhân do VelaTerm khởi động.

2. Tạo phiên tác nhân

• Menu ngữ cảnh. Nhấp chuột phải vào một dự án, nhóm hoặc phiên. Cấp đầu tiên của menu có ba tác nhân: ban đầu là Claude, Codex và OpenCode, về sau là ba loại tác nhân bạn tạo gần đây nhất. “Thêm phiên tác nhân” liệt kê mọi tác nhân, các cấu hình sẵn đã lưu, “Tạo mới với đối số khởi chạy…” và “Phiên tác nhân mới” (bộ chọn có ô tìm kiếm).
• Bộ chọn phiên tác nhân mới. ⌘N trên macOS (Ctrl+Alt+N trên Windows, Linux và trong trình duyệt thông thường) mở danh sách tác nhân và cấu hình sẵn có ô tìm kiếm, trong đó các lựa chọn gần đây được đánh dấu “Dùng gần nhất”. Xem Cài đặt và phím tắt §9.
• Phiên con. Menu con “Phiên con mới” của một phiên tạo phiên mới ngay bên dưới phiên đó. Cũng có thể khởi chạy phiên từ bên trong một cuộc hội thoại; xem Tạo phiên và hợp tác Git.

Tạo mới với đối số khởi chạy… mở hộp thoại gồm loại tác nhân (“Loại tác nhân”), tên tùy chọn (“Tên phiên (để trống để đặt tự động)”), “Đối số khởi chạy (tùy chọn)”, “Tệp thực thi (tùy chọn)” để chỉ định một tệp thực thi thay thế chỉ dùng cho phiên này, thiết lập quyền, “Mở ở” (“Chế độ terminal” hoặc “Chế độ hội thoại”) đối với các tác nhân hỗ trợ cả hai, và lựa chọn “Worktree”. “Lưu thành cấu hình sẵn” lưu các thiết lập dưới một tên, kèm biểu tượng tùy chọn. Cấu hình sẵn xuất hiện trong menu và trong bộ chọn, và khởi động với tệp thực thi, đối số và thiết lập quyền đã lưu.

Phiên Claude, Codex, OpenCode, Pi và OMP mặc định mở trong chế độ hội thoại; các tác nhân khác mở trong chế độ terminal. Có thể thay đổi cho từng tác nhân trong Cài đặt ▸ Tác nhân ▸ “Chế độ xem mặc định”.

3. Chấm trạng thái: ai đang làm việc, ai đang cần bạn

Chấm bên cạnh mỗi phiên tác nhân được cập nhật theo thời gian thực:

Khi tác nhân dừng lại để chờ bạn (có câu hỏi, yêu cầu cấp quyền hoặc một lượt đã kết thúc), bạn sẽ nhận được thông báo hệ thống, phiên được đánh dấu chưa đọc và huy hiệu trên Dock tính cả phiên đó. Nếu bạn đang xem đúng phiên đó, thông báo sẽ không xuất hiện. Trên bản macOS đã ký, nhấp vào thông báo sẽ mở phiên tương ứng. Mục “Thông báo: Bật/Tắt” trên thanh trạng thái bật hoặc tắt thông báo hệ thống; dấu chưa đọc và huy hiệu vẫn được giữ. Khi có huy hiệu, đầu thanh bên hiển thị một nút để xóa tất cả huy hiệu.

Các bộ đếm “Đang làm việc”, “Đang chờ” và “Đã xem” trên thanh trạng thái lọc thanh bên theo các phiên ở trạng thái tương ứng; xem Quản lý giao diện và phiên làm việc §6.

4. Tự động tiếp tục: đóng rồi mở lại, cuộc hội thoại vẫn tiếp tục

Mô hình cần nhớ chỉ gói gọn trong một câu: mỗi nút phiên tác nhân trong cây là một cuộc hội thoại liên tục.

• Ở lần chạy đầu tiên, VelaTerm ghi nhớ ID hội thoại riêng của tác nhân.
• Từ đó về sau, dù bạn đã đóng thẻ hay thoát ứng dụng, mở lại nút sẽ tiếp tục đúng cuộc hội thoại đó. Trước khi tiếp tục, VelaTerm kiểm tra xem cuộc hội thoại còn tồn tại hay không; nếu hội thoại đã bị xóa, phiên sẽ bắt đầu mới thay vì báo lỗi.
• Muốn có cuộc hội thoại mới, hãy tạo một nút phiên mới. Trong chế độ hội thoại, /clear thay phiên hiện tại bằng một phiên trống mới ở cùng vị trí.

Tiếp tục phiên… ở cuối menu Phiên mới giúp thêm một cuộc hội thoại bạn đã có, ví dụ cuộc hội thoại đã chạy trong một terminal thông thường. Chọn “Loại tác nhân”, dán ID hội thoại của tác nhân rồi chọn “Tiếp tục và mở”. Mọi loại tác nhân trong §1 đều có thể tiếp tục theo cách này.

Nhập phiên… trong menu ngữ cảnh của dự án liệt kê các cuộc hội thoại Codex, Claude, OpenCode và Kiro hiện có mà thư mục làm việc trùng khớp chính xác với thư mục dự án. Tìm theo tiêu đề, tác nhân hoặc ID phiên (“Tìm theo tiêu đề, tác nhân hoặc ID phiên”), chọn các dòng rồi chọn “Nhập”. Các cuộc hội thoại sẽ được thêm vào cây dự án; mở một cuộc hội thoại để tiếp tục. Việc nhập không sao chép hay thay đổi lịch sử riêng của tác nhân. Những cuộc hội thoại đã có trong VelaTerm, kể cả các cuộc hội thoại đã lưu trữ, được đánh dấu “Đã nhập”. Hội thoại nằm trong thư mục con hoặc trong worktree riêng chỉ xuất hiện khi thư mục đó được mở thành một dự án riêng. Lịch sử Kiro chỉ xem được với các bản ghi chỉ chứa văn bản. Khi kết nối tới một VelaTerm từ xa, danh sách được lấy từ máy tính từ xa đó.

5. Phân nhánh: tách một nhánh từ cuộc hội thoại

Với các phiên Claude, Codex, Pi và OMP đã có hội thoại, nhấp chuột phải → “Phân nhánh phiên”. Thao tác này tạo một nút ngang cấp bắt đầu từ lịch sử hiện tại của cuộc hội thoại gốc và giữ nguyên hội thoại gốc, tương tự một nhánh git. Hãy dùng tính năng này để thử hai hướng giải quyết từ cùng một ngữ cảnh.

6. Quyền

Thiết lập quyền quyết định tác nhân được làm những gì mà không cần hỏi bạn.

• Claude, Codex và OpenCode có các chế độ được đặt tên. Claude: “Chế độ kế hoạch”, “Luôn hỏi”, “Tự nhận thay đổi”, “Tự động”, “Bỏ qua hỏi”. Codex: “Chỉ đọc”, “Tự động”, “Toàn quyền”. OpenCode: “Luôn hỏi”, “Bỏ qua hỏi”.
• Copilot, Cursor, Antigravity, Cline, OMP, Crush, Kimi Code, Kiro, Grok Build và Zoo Code chỉ có một công tắc, “Bỏ qua mọi xác nhận quyền”, công tắc này khởi chạy tác nhân với tùy chọn bỏ qua xác nhận của chính tác nhân. Trong chế độ hội thoại, OMP có “Luôn hỏi” và “Bỏ qua hỏi”.
• Pi chạy công cụ mà không hỏi, nên không có thiết lập quyền.

Nơi thay đổi thiết lập:

• Cho từng phiên: biểu mẫu “Chỉnh sửa” của phiên (“Quyền”, hoặc ô đánh dấu “Bỏ qua mọi xác nhận quyền”); trong chế độ terminal, mục quyền trên thanh trạng thái (“Quyền: Hỏi” / “Quyền: Bỏ qua”, hoặc tên chế độ hiện tại); trong chế độ hội thoại, nút điều khiển quyền bên dưới ô nhập tin nhắn.
• Mặc định cho phiên mới: Cài đặt ▸ Tác nhân ▸ “Quyền”. Menu trên thanh trạng thái và trong chế độ hội thoại cũng có “Đặt làm mặc định”.

Một số thay đổi chỉ có hiệu lực sau khi tác nhân khởi động lại. Khi đó, VelaTerm đưa ra hai lựa chọn “Khởi động lại ngay” hoặc “Để sau”; khởi động lại vẫn tiếp tục cuộc hội thoại nhưng sẽ ngắt tác vụ đang chạy. “Bỏ qua hỏi”, “Toàn quyền” và “Bỏ qua mọi xác nhận quyền” bỏ qua mọi bước xác nhận, vì vậy hãy sử dụng một cách thận trọng.

7. Cài đặt khởi chạy và hướng dẫn cài đặt

Đối số khởi chạy. Biểu mẫu “Chỉnh sửa” của phiên có mục “Đối số khởi chạy (tùy chọn)” để thêm đối số dòng lệnh cho phiên đó. Cài đặt ▸ Tác nhân lưu giá trị mặc định cho từng loại tác nhân.

Đường dẫn tệp thực thi. Nếu một tác nhân được cài đặt ở vị trí nằm ngoài PATH, hãy đặt “Đường dẫn tệp thực thi (tùy chọn)” của tác nhân đó trong Cài đặt ▸ Tác nhân. Khi để trống, lệnh sẽ được tìm trên PATH.

Chưa cài đặt? Khi khởi động một tác nhân chưa được cài đặt, phiên sẽ hiển thị thẻ “<Agent> chưa được cài đặt” kèm lệnh cài đặt được khuyến nghị cho hệ thống của bạn.

• “Cài đặt ngay” chạy lệnh cài đặt trong phiên. Khi tìm thấy chương trình đã cài, đường dẫn của chương trình được lưu vào Cài đặt và một hộp thoại đưa ra hai lựa chọn “Khởi chạy lại ngay” hoặc “Để sau”.
• “Thử khởi chạy lại” khởi động lại phiên, chẳng hạn sau khi bạn tự cài đặt tác nhân.
• Nếu tác nhân đã được cài đặt ngoài PATH, hãy nhập đường dẫn đầy đủ vào “Đường dẫn tệp thực thi” rồi chọn “Dùng đường dẫn này”, hoặc dùng “Chọn tệp…”.
• “Tài liệu cài đặt” mở tài liệu cài đặt của tác nhân; “Tôi sẽ tự cài” đóng thẻ này.

Sau khi cài đặt, mỗi tác nhân vẫn cần được đăng nhập hoặc cấu hình khóa API riêng.

8. Bảng Info: mức sử dụng, ngữ cảnh và tài nguyên

Khi một phiên tác nhân đang mở, thẻ Info của bảng bên phải hiển thị:

• Agent: loại tác nhân, tên phiên, thư mục làm việc, nhánh Git, thời điểm khởi động và thời gian đã chạy. Với phiên Kiro, mục này còn có liên kết tới chế độ xem chỉ đọc của lịch sử hội thoại.
• Usage (Claude, Codex, Grok Build): mức sử dụng hạn mức tài khoản, ví dụ trong khung năm giờ và khung bảy ngày, kèm thời điểm đặt lại. Nút ↻ làm mới ngay lập tức. Việc tự động làm mới và khoảng thời gian làm mới được đặt trong Cài đặt ▸ Hành vi (“Tự động làm mới mức sử dụng”, “Làm mới mức sử dụng”). Khi làm mới thất bại, các giá trị gần nhất vẫn hiển thị kèm nhãn “stale”.
• This turn (Claude, Codex, Grok Build, OpenCode, Pi, OMP, Kiro): mô hình, mức độ lấp đầy của cửa sổ ngữ cảnh, số token và các công cụ của lượt hiện tại.
• Resources: CPU và bộ nhớ của các tiến trình thuộc phiên; tùy chọn “system” hiển thị thêm số liệu của toàn bộ máy tính.

9. Bản ghi hội thoại, xuất và lưu trữ

• Nhấp chuột phải → “Xuất phiên…” (Claude và Codex, khi đã có hội thoại) ghi toàn bộ cuộc hội thoại ra một tệp Markdown, bao gồm phần suy luận và mọi lượt gọi công cụ cùng đầu vào và kết quả.
• “Tổng hợp vào kho kiến thức theo phiên” trong menu của phiên giao cho một tác nhân trích xuất những kiến thức có thể tái sử dụng từ cuộc hội thoại; xem Kho kiến thức theo phiên.
• Có thể đọc các phiên đã lưu trữ trong chế độ xem “Phiên đã lưu trữ” của kho kiến thức. Hội thoại của Claude, Codex, OpenCode, Pi, OMP, Grok Build và Kiro hiển thị dưới dạng tin nhắn; với các tác nhân khác, bản ghi terminal được hiển thị nếu có. Khi khôi phục một phiên đã lưu trữ, ID hội thoại được giữ nguyên nên phiên vẫn tiếp tục như bình thường. Xem Quản lý giao diện và phiên làm việc §8.

10. Các hành vi khác

• Tự động đặt tên: phiên chưa được đặt tên sẽ lấy tên từ tin nhắn đầu tiên của bạn.
• Thay đổi chủ đề: khi chuyển giữa sáng và tối, các phiên Claude đang chạy trong chế độ terminal được cập nhật theo mà không cần khởi động lại.
• Kỹ năng Vela: Cài đặt ▸ Chung ▸ “Kỹ năng Vela” cài đặt cho Claude Code và Codex các kỹ năng dùng để khởi chạy phiên con, mở tệp, cũng như đọc hoặc gửi tin nhắn tới các phiên khác; xem Lệnh trong phiên.
• Windows: Claude Code và Codex được hỗ trợ đầy đủ (chạy trong PowerShell); các tác nhân khác được hỗ trợ ở mức tốt nhất có thể.