Kết nối các AI agent với các trang tài liệu của bạn
Để Claude Code, Codex, ChatGPT hoặc các tập lệnh của riêng bạn soạn thảo, sắp xếp và xuất bản các trang tài liệu. Các gói (Pro trở lên), quyền đối với trang tài liệu, phạm vi trang web và quy tắc xuất bản, cùng với các liên kết đến hướng dẫn đầy đủ về AI agent & API.
Các AI agent như Claude Code, Codex, Cursor, Claude hoặc ChatGPT có thể đọc và viết trên các trang tài liệu của bạn: soạn thảo bài viết, sửa các trang được người đọc đánh giá thấp, giải đáp các khoảng trống nội dung, dịch hoặc xuất bản. Bài viết này đề cập đến những nội dung cụ thể cho các trang tài liệu. Các token, trình kết nối, chi phí và lỗi được giải thích trong AI agent & API.
Trước khi bạn bắt đầu
- AI agent & API có sẵn trên các gói Pro, Doanh nghiệp và Tùy chỉnh, bao gồm các trình kết nối cho Claude và ChatGPT. Các gói Miễn phí và Starter không bao gồm tính năng này; các token và ứng dụng sẽ ngừng hoạt động nếu không gian làm việc chuyển sang một trong các gói đó.
- Một agent hoạt động với tư cách là người đã tạo token hoặc kết nối nó, trong phạm vi vai trò của người đó. Nó không bao giờ có thể thực hiện nhiều thao tác trên một trang web hơn những gì người đó có thể làm.
- Các lệnh gọi API không tốn tín dụng. Việc dịch trang và tạo các trang web bằng AI sẽ tốn tín dụng, và chỉ với một token có thể chi tiêu chúng.
Kết nối một agent
Mở menu không gian làm việc và chọn AI agent & API, hoặc chọn AI agent & API trong menu Cài đặt của một trang tài liệu (nó sẽ mở hoạt động cho trang web đó).
- Mã thông báo API cho Claude Code, Codex, Cursor hoặc một tập lệnh: Các token → Token mới, sau đó là trình hướng dẫn bốn bước (Mục đích, Quyền, Giới hạn, Xem lại). Chọn một cài đặt trước cho trang tài liệu như Người viết hoặc Người xuất bản, chọn các trang web trong Giới hạn → Trang tài liệu, và sao chép token, mã này chỉ được hiển thị một lần. Xem Tạo mã thông báo API.
- Trình kết nối cho Claude.ai hoặc ChatGPT: dán URL trình kết nối từ Ứng dụng đã kết nối vào ứng dụng, đăng nhập và chọn Các trang web và Quyền truy cập. Xem Kết nối các ứng dụng và agent AI.
Các cài đặt trước cho trang tài liệu
| Cài đặt trước | Mô tả trên màn hình | Dành cho |
|---|---|---|
| Người viết | "Agent soạn thảo; một người xem xét và xuất bản." | Soạn thảo bài viết và mục nhật ký thay đổi, tải lên hình ảnh |
| Người xuất bản | "Tự động hóa đáng tin cậy có thể thay đổi những gì người đọc thấy." | Mọi thứ cho các trang tài liệu, bao gồm xuất bản, cài đặt và tạo trang web |
| Trợ lý hỗ trợ | "Câu trả lời từ các tài liệu đã xuất bản. Không gì khác." | Một bot trợ giúp chỉ tìm kiếm các trang công khai, đã xuất bản |
| Chỉ đọc | "Nghiên cứu, kiểm toán và kiểm tra bản dịch." | Đọc nội dung |
| Nhà phân tích | "Đọc nội dung và tín hiệu từ người đọc để đề xuất sửa lỗi." | Đọc nội dung và thông tin chi tiết |
Nhà sản xuất và Agent không gian làm việc thêm video và tín dụng chi tiêu. Mọi quyền và người có thể cấp quyền: Quyền của agent.
Quyền đối với trang tài liệu
| Quyền | Cho phép |
|---|---|
content:read |
Đọc các trang web, trang, bài viết (cả bản nháp), bản sửa đổi, nhật ký thay đổi và các trang web |
articles:write |
Tạo bài viết nháp và chỉnh sửa các bài viết chưa được đăng |
structure:write |
Tạo và chỉnh sửa các phần; di chuyển, ẩn và đổi tên trang |
site-pages:write |
Chỉnh sửa các trang web như trang chủ, liên hệ và pháp lý |
changelog:write |
Tạo và chỉnh sửa các mục nhật ký thay đổi dưới dạng bản nháp |
media:write |
Tải lên hình ảnh |
site:publish |
Xuất bản: thay đổi những gì người đọc thấy, chỉnh sửa nội dung trực tiếp, đánh dấu trang đã sẵn sàng |
insights:read |
Đọc các khoảng trống tìm kiếm, câu hỏi chưa được trả lời và phản hồi trang |
site:configure |
Thay đổi cài đặt trang web, giao diện và điều hướng |
sites:create |
Tạo các trang tài liệu mới |
help:read |
Chỉ tìm kiếm các trang công khai, đã xuất bản (cho trợ lý hỗ trợ) |
Việc đọc được mở cho bất kỳ thành viên nào. Viết và sắp xếp: chủ sở hữu, quản trị viên, biên tập viên và Người tạo nội dung. Xuất bản và cài đặt trang web: chủ sở hữu, quản trị viên và biên tập viên ("Chỉ chủ sở hữu, quản trị viên và biên tập viên mới có thể cấp quyền xuất bản."). Tạo trang web: chủ sở hữu và quản trị viên.
Các trang web mà một token bao gồm
Trong Giới hạn → Trang tài liệu, chọn Tất cả trang web ("Mọi trang tài liệu trong không gian làm việc này, bao gồm cả các trang mới.") hoặc Các trang web đã chọn. Một token hoặc ứng dụng đã kết nối chỉ nhìn thấy và thay đổi các trang web mà nó bao gồm. Nếu một bài viết cũng xuất hiện trên một trang web nằm ngoài phạm vi của nó, thay đổi đó sẽ bị từ chối: "Bài viết này cũng được hiển thị trên một trang web mà token này không thể thay đổi."
Nội dung trực tiếp cần quyền xuất bản
Nếu không có site:publish, agent không thể thay đổi những gì người đọc thấy. Việc chỉnh sửa một bài viết đang trực tiếp sẽ bị từ chối ("Nội dung này đang trực tiếp trên một trang web đã xuất bản, vì vậy việc thay đổi nó cần quyền site:publish."), và agent có thể gửi bản nháp của mình để xem xét thay thế. Bạn sẽ nhận được thông báo, "agent đã yêu cầu xem xét page trên site": "Không có gì được xuất bản. Hãy đọc bài viết và xuất bản nó khi nó sẵn sàng."
Mọi thay đổi mà agent thực hiện đều hiển thị trong lịch sử của trang là "Agent name (token)". Việc xuất bản bị giới hạn ở 10 lần mỗi giờ cho mỗi token. Một trang web bị tạm dừng sẽ ở chế độ chỉ đọc đối với các agent: "Trang web này đã bị tạm dừng hoặc ngoại tuyến và ở chế độ chỉ đọc."
Những gì agent có thể làm trên một trang web
Liệt kê các trang web và đọc cây trang, tìm kiếm và đọc các trang, xem trước Markdown, tạo và cập nhật bài viết, gửi chúng để xem xét, sắp xếp các phần và trang, chỉnh sửa các trang web và nhật ký thay đổi, tải lên hình ảnh, đọc thông tin chi tiết và đánh dấu các khoảng trống là đã được giải quyết, thay đổi cài đặt, giao diện, điều hướng và chuyển hướng, tạo trang web, dịch trang, tạo các trang web, xuất bản và hoàn tác. Mỗi thao tác cần quyền tương ứng.