Hướng dẫn cài đặt agent

Hai tài liệu

• Hướng dẫn MCP cho agent bên ngoài

  docs/external-agent-mcp.md

  Tài liệu ở mức tool cho mọi MCP client: cách tạo và sản xuất một video, cùng các quy tắc giúp phiên làm việc không gặp sự cố.

  • Bắt đầu nhanh với agent_preflight và agent_continue
  • Quy tắc bắt buộc: chép ref model, tải lên rồi gắn ảnh tham chiếu, không tự đặt confirmed
  • Chế độ token, cấu trúc phản hồi, lỗi, hết thời gian chờ và kết quả chưa rõ
  • Cài đặt client, ảnh tham chiếu, chỉnh ảnh, phim dài và cách viết prompt

• Cài đặt trọn gói do agent làm

  docs/agent-zero-touch-setup.md

  Quy trình cho agent cài đặt studio giúp khách hàng rồi làm video cho họ. Người dùng chỉ mang ý tưởng, thanh toán và đồng ý ở vài thời điểm.

  • Những lúc người dùng cần tham gia và mỗi lúc mất bao lâu
  • Tài khoản, token và biến môi trường, từng bước
  • Kết nối và kiểm tra, biến ý tưởng thành brief, làm và bàn giao video
  • Khi có lỗi, giới hạn chi tiêu, gia hạn token và những gì chưa làm được

Cả hai đều là file Markdown (tiếng Anh); đường dẫn tính từ thư mục gốc của repository.

Nên đọc bản nào

Khi tài liệu và server nói khác nhau

Server là nguồn đúng cho token của bạn: tools/list, agent_preflight, list_video_models và instructions trong phản hồi initialize. Khi tài liệu nói khác, hãy làm theo server.

Quy tắc chung của cả hai tài liệu:

• Không tạo tài khoản, nhập mật khẩu hay xử lý thông tin thanh toán thay người dùng. Đưa họ các bước và chờ.
• Không in, ghi log hay commit token. Chỉ nhắc tới tên biến môi trường.
• Không gọi tool tính phí khi người dùng chưa đồng ý giá.
• Chỉ đặt confirmed và rights_confirmed sau khi người dùng đã đồng ý.
• Nói rõ khi một việc chưa làm được. Không tự chế cách thay thế.