Cách khiến tác tử của bạn dùng YOU

Trỏ tác tử AI tới chủ đề định hướng dành cho tác tử đi kèm bản cài you-agent-factory và để nó tự điều khiển CLI you; MCP và ACP là các mức tích hợp sâu hơn.

Nó là gì

Tệp nhị phân đã cài mang theo tài liệu tham chiếu của chính nó, và một chủ đề được viết riêng cho tác tử AI: phần định hướng kèm bảng lệnh, giải thích you-agent-factory là gì, có những lệnh nào, và nên dùng lệnh nào. Nó in ra dưới dạng markdown thuần, không kèm định dạng bao ngoài — đúng thứ một tác tử muốn đọc.

you docs agents

Hãy tự chạy nó một lần trước khi giao cho tác tử. Nó cho bạn biết chính xác tác tử sẽ học được gì, và là cách nhanh nhất hiện có để nắm bề mặt lệnh.

Khi nào dùng

Hãy dùng ngay khi bạn có một tác tử chạy được lệnh và một factory đáng tái sử dụng. Đó là khác biệt giữa một tác tử dựng lại vòng rà soát từ đầu mỗi phiên và một tác tử với tay lấy đúng factory rà soát đóng gói mà bạn đã cài sẵn.

Các bước

Không có máy chủ nào phải khởi động và không có tích hợp nào phải đăng ký. Toàn bộ thiết lập là một câu chỉ dẫn đặt ngay chỗ tác tử vốn đã đọc hướng dẫn dự án.

Bước 1 — bảo đảm tệp nhị phân có ở đó

Cài you-agent-factory và cấu hình nhà cung cấp trên chính máy mà tác tử chạy. Tác tử không dùng được một tệp nhị phân không nằm trên PATH, và một factory không có nhà cung cấp thì chẳng thực thi được gì.

Bước 2 — thêm một chỉ dẫn vào hướng dẫn dự án của tác tử

Before using you-agent-factory, run `you docs agents` and read the output.
It is the agent orientation topic and command matrix for the installed binary.
Then use the `you` CLI directly for anything it covers — prefer `you run --named`
against an installed packaged factory over reimplementing a workflow yourself.
Run `you docs` for the full topic index, and `you docs <topic>` for depth.

Đặt chỉ dẫn đó vào tệp mà tác tử nạp tự động — AGENTS.md, CLAUDE.md, tệp quy tắc của Cursor, hay bất cứ tệp nào nền tảng của bạn đọc. Điểm mấu chốt là tác tử học bề mặt lệnh từ chính tệp nhị phân nó đang có, chứ không phải từ một bản sao tài liệu có thể lỗi thời.

Bước 3 — để nó tự khám phá các chủ đề còn lại

you docs

Có 21 chủ đề, bao phủ việc soạn factory, chạy, cấu hình, worker giả lập, ghi và phát lại, guard, quan hệ, công việc, phiên, bộ điều phối, quy trình JavaScript, MCP, workstation, worker, tài nguyên, mô hình, đầu vào theo lô và mẫu. Tác tử cần chiều sâu ở chủ đề nào thì lấy đúng chủ đề đó.

Bước 4 — xác minh bằng một lần chạy thật

you factory list --dir ~/.you-agent-factory/factories
you run --named @you/subagent --output primary "Summarise the working tree"

Xác nhận vòng lặp hoạt động bằng cách yêu cầu tác tử làm trọn một việc nhỏ: liệt kê những gì đã cài, rồi chạy một factory đóng gói và báo lại kết quả. Yêu cầu chỉ in kết quả cuối sẽ giữ ngữ cảnh của tác tử gọn gàng.

Tác tử với tới được những gì

Chỉ qua CLI, một tác tử đã có thể cài và liệt kê factory, chạy một factory với một yêu cầu, gửi công việc vào phiên đang hoạt động, kiểm tra hạng mục công việc và phiên, liệt kê cùng xem chi tiết các mô hình đã phát hiện, và đọc mọi chủ đề tham chiếu đi kèm. Chừng đó gần như bao trọn những gì người vận hành làm thủ công.

Tích hợp sâu hơn

Có hai máy chủ giao thức dành cho những nền tảng muốn công cụ có cấu trúc thay vì shell. Máy chủ Model Context Protocol phơi bày các công cụ Factory Session qua stdio, để một nền tảng MCP gọi chúng như những công cụ có tên. Máy chủ Agent Client Protocol lại lưu trữ chính you-agent-factory như một tác tử mà trình soạn thảo có thể điều khiển.

Phục vụ các công cụ Factory Session qua Model Context Protocol

you mcp serve

Lưu trữ you-agent-factory như một tác tử Agent Client Protocol

you serve acp

Ba bề mặt này rất dễ nhầm. Lưu trữ dưới dạng tác tử Agent Client Protocol là cung cấp you-agent-factory cho một trình soạn thảo bên ngoài. Thêm một nhà cung cấp Agent Client Protocol là cấu hình một tác tử bên ngoài mà chính you-agent-factory sẽ điều phối công việc tới. Còn phục vụ qua Model Context Protocol là một máy chủ công cụ hoàn toàn khác, và không khởi động cổng HTTP hay bảng điều khiển nào.

Lỗi thường gặp

Sự cố phổ biến nhất là tác tử chẳng bao giờ đọc chủ đề định hướng mà cứ đoán cờ. Hãy đặt chỉ dẫn ở nơi tác tử thật sự nhìn tới — tệp hướng dẫn dự án nó nạp mỗi phiên — chứ không phải trong một tin nhắn dùng một lần. Lỗi thứ hai là cho rằng nhất thiết phải có máy chủ giao thức; với hầu hết tác tử, CLI vừa đơn giản hơn vừa làm được nhiều hơn.Tác tử tự trị gửi công việc qua CLI. Biểu mẫu gửi trên bảng điều khiển và endpoint work qua HTTP vẫn là đường của người vận hành, không phải kênh điều khiển song song dành cho tác tử.

Bảo mật / Ranh giới tin cậy