Chọn quyền cho một AI agent
Mọi quyền mà một API token hoặc ứng dụng được kết nối có thể nắm giữ, những gì quyền đó cho phép, cài đặt sẵn nào bao gồm quyền đó và những vai trò nào (chủ sở hữu, quản trị viên, biên tập viên, người sáng tạo nội dung) có thể cấp quyền đó.
Mỗi API token và ứng dụng được kết nối đều mang một tập hợp các quyền (khả năng) quyết định những gì một agent có thể làm trong không gian làm việc của bạn. Bài viết này liệt kê từng quyền, những gì quyền đó cho phép, cài đặt sẵn nào bao gồm quyền đó và những vai trò nào có thể cấp quyền đó.
Cách thức hoạt động của quyền
- Một agent hoạt động với tư cách là người tạo ra token đó, trong phạm vi vai trò của người đó cho phép. Nó không bao giờ có thể làm nhiều hơn những gì chủ sở hữu của nó có thể làm trong ứng dụng, và nó chỉ thấy các bản ghi, video và bộ sưu tập mà chủ sở hữu của nó có thể thấy.
- Vai trò của bạn quyết định những gì bạn có thể cấp. Trong trình hướng dẫn token và trên màn hình kết nối, một quyền mà vai trò của bạn không thể cấp sẽ bị làm mờ với dòng chữ "Vai trò của bạn không thể cấp quyền này." (hoặc "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." đối với việc xuất bản). Một cài đặt sẵn chứa một trong các quyền đó sẽ bị làm mờ với dòng chữ "Vai trò của bạn không thể cấp mọi khả năng trong cài đặt sẵn này."
- Vai trò được kiểm tra trên mỗi lệnh gọi, không chỉ khi token được tạo. Nếu vai trò của chủ sở hữu thay đổi sau đó, các lệnh gọi cần một quyền mà vai trò mới không cho phép sẽ bị từ chối và token sẽ hiển thị Vượt quá vai trò trong danh sách token: "Vai trò của chủ sở hữu đã thay đổi. Các lệnh gọi cần các khả năng bị gạch bỏ sẽ bị từ chối."
- Mỗi quyền có một loại, được hiển thị dưới dạng huy hiệu trong trình hướng dẫn: Đọc, Chỉnh sửa, Xuất bản, Quản lý hoặc Sử dụng tín dụng.
- Một agent chỉ thấy các công cụ (MCP) và điểm cuối (REST) mà các quyền của nó cho phép. Việc gọi một công cụ mà nó không có sẽ trả về "Token này thiếu khả năng …"
Cài đặt sẵn
Bước đầu tiên của trình hướng dẫn token (Nó dùng để làm gì?) cung cấp các cài đặt sẵn. Chọn một cài đặt sẵn sẽ đánh dấu các quyền của nó; bạn có thể thay đổi bất kỳ quyền nào trong số đó ở bước tiếp theo, và trình hướng dẫn sau đó sẽ hiển thị Đã tùy chỉnh với Đặt lại về cài đặt sẵn.
| Cài đặt sẵn | Mô tả trên màn hình | Quyền |
|---|---|---|
| Người viết | "Agent soạn thảo; một người xem xét và xuất bản." | content:read, articles:write, changelog:write, media:write |
| 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 quyền trang tài liệu ngoại trừ help:read và insights:read |
| 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." | help:read |
| Chỉ đọc | "Nghiên cứu, kiểm toán và kiểm tra bản dịch." | content:read |
| Nhà phân tích | "Đọc nội dung và tín hiệu người đọc để đề xuất sửa lỗi." | content:read, insights:read |
| Nhà sản xuất | "Soạn thảo nội dung và bắt đầu công việc trả phí trong giới hạn chi tiêu." | Người viết, cộng với site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| Agent không gian làm việc | "Mọi thứ một agent có thể làm trong không gian làm việc này, trong giới hạn chi tiêu." | Mọi quyền ngoại trừ help:read |
Nhà sản xuất và Agent không gian làm việc bao gồm credits:spend, vì vậy trình hướng dẫn sẽ yêu cầu giới hạn chi tiêu ở bước Giới hạn. Xem Kiểm soát chi tiêu và phê duyệt của agent.
Các cài đặt sẵn Người viết, Người xuất bản, Trợ lý hỗ trợ, Chỉ đọc và Nhà phân tích dành cho các trang tài liệu.
Quyền đối với video
| Quyền | Loại | Những gì quyền đó cho phép |
|---|---|---|
library:read |
Đọc | "Đọc các bản ghi, video, bài viết và bản ghi chép mà chủ sở hữu có thể thấy": liệt kê thư viện và các bản ghi, đọc một mục, bản ghi chép và bài viết của mục đó, và lấy mã nhúng. |
videos:create |
Chỉnh sửa | "Trích dẫn và yêu cầu video, bài viết từ các bản ghi và bản dịch": yêu cầu trích dẫn và yêu cầu video hướng dẫn, demo sản phẩm, dọn dẹp và video được tạo kiểu từ một bản ghi, các đoạn clip xã hội, bài viết từ một bản ghi và bản dịch video. Việc bắt đầu công việc trả phí cũng cần credits:spend. |
videos:export |
Chỉnh sửa | "Xuất video và lấy mã nhúng": xuất tệp MP4 ở độ phân giải 1080p (mặc định), 2K hoặc 4K, luôn ở tốc độ 60 khung hình/giây và lấy liên kết tải xuống. Việc xuất không tốn tín dụng. |
materials:write |
Chỉnh sửa | "Thêm hình ảnh, video và tệp PDF vào các tệp tải lên của không gian làm việc được sử dụng cho video mới". |
Quyền đối với không gian làm việc
| Quyền | Loại | Những gì quyền đó cho phép |
|---|---|---|
credits:spend |
Sử dụng tín dụng | "Sử dụng tín dụng cho công việc được trích dẫn, trong giới hạn của token". Đây là chìa khóa thứ hai mà mọi công việc trả phí cần, bên cạnh quyền cho công việc đó (ví dụ: videos:create). |
jobs:read |
Đọc | "Xem các công việc được bắt đầu bởi các token khác của chủ sở hữu". Một token luôn thấy các công việc của chính nó; quyền này thêm các công việc từ các token khác của chủ sở hữu. Cũng cho phép agent hủy một công việc và đọc số dư tín dụng của không gian làm việc. |
Quyền đối với tài liệu
Các quyền này áp dụng cho trang tài liệu. Trong phần Giới hạn → Trang tài liệu, một token bao gồm 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.
| Quyền | Loại | Những gì quyền đó cho phép |
|---|---|---|
content:read |
Đọc | "Đọc các trang web, trang, bài viết (cả bản nháp), các bản sửa đổi, nhật ký thay đổi và các trang web". Cũng bao gồm cài đặt trang web, giao diện, điều hướng và chuyển hướng. |
articles:write |
Chỉnh sửa | "Tạo bài viết nháp và chỉnh sửa các bài viết chưa xuất bản". Việc dịch một bài viết (trả phí) cũng cần credits:spend. |
structure:write |
Chỉnh sửa | "Tạo và chỉnh sửa các phần, di chuyển, ẩn và đổi tên các trang". |
site-pages:write |
Chỉnh sửa | "Chỉnh sửa các trang web như trang chủ, liên hệ và pháp lý". Việc tạo hoặc dịch một trang web bằng AI (trả phí) cũng cần credits:spend. |
changelog:write |
Chỉnh sửa | "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 |
Chỉnh sửa | "Tải lên hình ảnh". |
site:publish |
Xuất bản | "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 các trang đã sẵn sàng". Cũng bao gồm việc xuất bản và xóa các mục nhật ký thay đổi và khôi phục trang web. |
insights:read |
Đọc | "Đọc thông tin chi tiết về trang web: khoảng trống tìm kiếm, câu hỏi chưa được trả lời và phản hồi về trang". Với articles:write, nó cũng có thể đánh dấu một khoảng trống là đã được bao phủ. |
site:configure |
Quản lý | "Thay đổi cài đặt trang web, giao diện và điều hướng", và thêm các chuyển hướng. |
sites:create |
Quản lý | "Tạo các trang tài liệu mới". |
help:read |
Đọc | "Chỉ tìm kiếm các trang công khai, đã xuất bản (trợ lý hỗ trợ)". Một token chỉ có quyền này sẽ không thấy gì khác. |
Ai có thể cấp quyền gì
| Quyền | Chủ sở hữu | Quản trị viên | Biên tập viên | Người sáng tạo nội dung |
|---|---|---|---|---|
content:read, help:read, insights:read, jobs:read |
Có | Có | Có | Có |
library:read |
Có | Có | Có | Có |
articles:write, structure:write, site-pages:write, changelog:write, media:write |
Có | Có | Có | Có |
videos:export |
Có | Có | Có | Có |
videos:create, materials:write, credits:spend |
Có | Có | Không | Có |
site:publish, site:configure |
Có | Có | Có | Không |
sites:create |
Có | Có | Không | Không |
Một Người sáng tạo nội dung có thể cấp cho token quyền credits:spend, nhưng công việc trả phí cần phê duyệt sẽ luôn được phê duyệt bởi chủ sở hữu không gian làm việc hoặc quản trị viên, không bao giờ chỉ bởi chủ sở hữu của token. Xem Kiểm soát chi tiêu và phê duyệt của agent.
Chưa khả dụng cho các agent
Các agent chưa thể chạy nghiên cứu trang web hoặc các hướng dẫn được ghi lại, hoặc xuất bản video lên các nền tảng khác. Những quyền đó không thể được cấp.