Chat với một agent

Hướng dẫn này chỉ cho bạn cách làm việc với một agent trong một space.

Tạo một space

Mở Không gian trên thanh bên
Nhấp nút + bên cạnh tiêu đề Không gian
Nhập Tên — mục này là bắt buộc. Tên để trống sẽ bị từ chối; hộp thoại vẫn mở
Tùy chọn thêm agent từ không gian làm việc
Nếu không gian làm việc có bất kỳ kho mã nào, một trình chọn kho mã sẽ hiện ra. Ban đầu mọi kho mã đều được chọn; hãy thu hẹp lại (kể cả bỏ chọn một kho mã) để chỉ còn những kho mã mà space này sẽ cấp phát worktree cho
Xác nhận

Control Center mở space và bắt đầu cấp phát một worktree copy-on-write cho mỗi kho mã được chọn ở chế độ nền.

Gửi tin nhắn đầu tiên

Nhập tin nhắn của bạn vào trình soạn rồi nhấn Enter. Agent được điều phối và bắt đầu truyền phát phản hồi của nó.

Nếu space vẫn đang được cấp phát, tin nhắn của bạn được tạm giữ chứ không bị mất — trình soạn giữ nó lại và tự động gửi đi khi các worktree đã sẵn sàng.

Trong khi agent làm việc, bạn thấy lượt của nó hiện dần theo luồng: các phân đoạn lập luận, lời gọi công cụ (đọc tệp, ghi tệp, lệnh shell) và văn bản trả lời, tất cả nằm trong một tin nhắn thuộc lượt của agent.

Điều hướng một agent đang chạy

Khi một agent đang làm việc, văn bản hội thoại thông thường không xếp hàng một lượt mới. Nó trở thành một thẻ điều hướng đang chờ trong dải phía trên trình soạn và được chèn vào lượt chạy trực tiếp tại ranh giới lượt kế tiếp. Không có thông báo nổi — chính thẻ đó là phản hồi.

Ba điều thay đổi hành vi đó:

Tin nhắn chứa @mention luôn được gửi dưới dạng tin nhắn, không bao giờ là điều hướng
Tin nhắn bắt đầu bằng lệnh slash luôn được xử lý như chính lệnh đó
Tin nhắn có tệp đính kèm luôn được gửi dưới dạng tin nhắn — hàng chờ điều hướng chỉ dành cho văn bản
Nếu mọi lượt chạy trực tiếp đều đã kết thúc, văn bản sẽ rơi xuống và được gửi dưới dạng một tin nhắn bình thường

Phê duyệt một hành động bị chặn

Khi một agent gặp một hành động mà rào chắn của nó gác — một lệnh phá hủy, một công cụ đặc quyền — máy chủ chặn lượt chạy và phát một yêu cầu phê duyệt tới mọi máy khách đang kết nối. Nếu bạn đang mở cuộc hội thoại đó, yêu cầu sẽ hiện ngay trong cuộc trò chuyện, phía trên trình soạn, dưới dạng cùng loại thẻ lựa chọn được đánh số dùng cho ask_user (từ chối, phê duyệt, và tùy chọn phê duyệt trong tám giờ). Không có bỏ qua: một agent bị chặn đang chờ một quyết định.

Nếu bạn đang ở nơi khác trong ứng dụng, một bảng nổi luôn ở trên cùng trong giao diện vẫn liệt kê những gì đang chờ, để bạn có thể gỡ chặn agent mà không phải đi tìm space. Bảng nổi này ẩn một yêu cầu ngay khi cuộc hội thoại của space đó hiện trên màn hình, nên bạn không bao giờ trả lời cùng một lời nhắc hai lần.

Không có thời gian chờ: một agent bị chặn sẽ đợi cho đến khi có người quyết định. Yêu cầu tương tự cũng xuất hiện trong dải cần chú ý của Hộp thư và trên máy khách điện thoại.

Trả lời câu hỏi của agent

Một agent cần biết một sở thích, một yêu cầu còn thiếu, hay một ngã rẽ thực sự phải gọi ask_user. Viết câu hỏi dưới dạng tin nhắn chat sẽ kết thúc lượt và bạn phải nhắc lại. Công cụ này hiển thị một thẻ đánh số trong cuộc hội thoại — các lựa chọn, ô văn bản tự do tùy chọn, hoặc cả hai — và lượt chạy sẽ chờ câu trả lời của bạn.

Nhấn một lựa chọn để gửi lựa chọn đó (số ở cuối biến thành mũi tên khi trỏ chuột vào). Câu trả lời chọn nhiều mục và tự nhập dùng nút Tiếp tục (⌘↵ / Ctrl↵). Nút Bỏ qua bảo agent chọn một mặc định hợp lý và đừng hỏi lại.

Đây là một cơ chế tách biệt với thẻ phê duyệt ở trên: phê duyệt là “tôi có được làm việc này không?”, còn câu hỏi là “ý bạn là lựa chọn nào trong số này?”. Việc hỏi có mặt trên harness tích hợp ở mọi chế độ, kể cả những chế độ chỉ đọc (nó không thay đổi gì), và nó được cố ý không bọc trong một lời nhắc phê duyệt — một hộp thoại đặt trước một hộp thoại sẽ đóng khi lỗi mà không có người phê duyệt nào được kết nối. Một lượt chạy không có cuộc hội thoại để hiển thị vào thì đơn giản là không nhận được công cụ này.

Dừng một agent

Khi có lượt chạy đang hoạt động, nút gửi của trình soạn biến thành nút Dừng. Xóa trống trình soạn rồi nhấn nút đó — thao tác này dừng mọi agent đang chạy trong cuộc hội thoại đó.

Không có nút dừng nào trong tiêu đề của space và cũng không có phím tắt cho việc này. Để chỉ dừng một lượt chạy khi có nhiều lượt đang hoạt động, hãy mở tab hoạt động của lượt chạy đó — tiêu đề của tab mang nút tạm dừng/tiếp tục và dừng chỉ áp dụng cho lượt chạy đó (nút dừng hỏi bạn xác nhận). Quan sát → Trực tiếp liệt kê mọi agent đang chạy trong không gian làm việc bằng cùng nút điều khiển đó.

Một lượt chạy đã dừng được đánh dấu là đã dừng. Hãy gửi một tin nhắn mới để điều phối lại.

Dùng lệnh slash

Nhập / trong trình soạn để xem danh sách lệnh. Những lệnh thay đổi cách cuộc hội thoại hoạt động:

Lệnh	Tác dụng
`/plan`	Chuyển space sang chế độ Kế hoạch. Một `/plan` trần chỉ bật chế độ; `/plan <request>` bật chế độ và gửi phần còn lại làm tin nhắn của bạn
`/goal <text>`	Ghi lại mục tiêu làm việc của cuộc hội thoại
`/loop <text>`	Lặp cho đến khi một tác vụ hoàn tất
`/compact`	Gộp lịch sử cũ hơn vào một bản tóm tắt được neo và tiếp tục trên ngữ cảnh đã nén
`/todo …`	Xem và chỉnh sửa danh sách việc cần làm được lưu của cuộc hội thoại này

Các skill xuất hiện trong cùng danh sách dưới không gian tên skill: riêng của chúng, nên chúng không bao giờ trùng với các lệnh ở trên — một skill tên là plan hay compact vẫn truy cập được:

Lệnh	Nó chạy gì
`/skill:<name>`	Một skill đã cài trong không gian làm việc, hoặc được gắn vào agent
`/skill:<repo>:<name>`	Một skill do một trong các kho mã được checkout trong space này cung cấp

Các skill của kho mã được gắn nhãn theo kho mã mà chúng đến từ đó, vì chỉ một cái tên không cho biết nó mã hóa quy ước của dịch vụ nào và hai kho mã có thể mỗi bên đều cung cấp một skill testing. Bạn không cần gõ tiền tố để tìm một skill: gõ tên skill trần cũng khớp với các mục có không gian tên.

Một agent chỉ mang các skill của kho mã mà nó đang làm việc trong đó — xem Skill theo phạm vi kho mã. Trình soạn không bị giới hạn theo cách đó: bạn có thể gọi skill của bất kỳ kho mã nào bằng cách nêu tên nó.

/compact và /todo bị chặn ngay trong trình soạn và không bao giờ được lưu thành tin nhắn — một dòng /compact trong bản ghi sẽ đẩy mốc cắt của lần nén kế tiếp lùi lại một lượt. /plan đổi chế độ đã lưu của space thay vì được truyền đi dưới dạng văn bản. Vì vậy không lệnh nào trong ba lệnh này là “một tin nhắn bạn gửi cho agent”; đừng mong thấy chúng trong lịch sử.

Yêu cầu kế hoạch trước

Trước một thay đổi phức tạp, hãy chuyển space sang chế độ Kế hoạch bằng /plan, hộp chọn chế độ trên thanh công cụ của trình soạn, hoặc Shift+Tab. Sau đó agent nghiên cứu ở chế độ chỉ đọc và giao một kế hoạch có cấu trúc để bạn phê duyệt trước khi mọi công việc bắt đầu. Xem Dùng chế độ kế hoạch.

Tiếp cận một agent mà không cần space riêng

Bạn không cần một space riêng cho mỗi agent. Trong bất kỳ space nào:

@alice can you look at the failing tests in src/auth_test.dart?

Agent được nhắc đến sẽ được thêm vào space và được điều phối với ngữ cảnh của space đó. Xem @-mention agent để biết cách khớp tên.

Hướng dẫn liên quan

Dùng space
@-mention agent
Dùng chế độ kế hoạch
Thiết lập tích hợp Slack để làm điều tương tự từ Slack

Khái niệm liên quan

Chế độ