Tạo token API cho một AI agent
Tạo token API trong trình hướng dẫn bốn bước (Mục đích, Quyền, Giới hạn, Xem lại): các cài đặt sẵn, quyền, thời hạn, trang tài liệu, giới hạn chi tiêu và danh sách IP cho phép. Token chỉ được hiển thị một lần.
Token API cho phép Claude Code, Codex, Cursor hoặc tập lệnh của riêng bạn hoạt động trong không gian làm việc của bạn với tư cách là bạn, chỉ với quyền truy cập mà bạn chọn. Bạn tạo nó trong trình hướng dẫn bốn bước (Mục đích, Quyền, Giới hạn, Xem lại), và Clevera chỉ hiển thị token một lần.
Trước khi bạn bắt đầu
- AI agents & API có sẵn trên các gói Pro, Business và Custom. Trên các gói khác, New token sẽ hiển thị "API và quyền truy cập agent chỉ có trên gói Pro trở lên."
- Bất kỳ thành viên nào trong không gian làm việc đều có thể tự tạo token cho mình. Token chỉ có thể nhận các quyền mà vai trò của bạn cho phép. Xem Quyền của agent.
- Một không gian làm việc có thể có 50 token đang hoạt động. Khi đạt giới hạn, New token sẽ bị vô hiệu hóa: "Không gian làm việc của bạn đã đạt giới hạn 50 token đang hoạt động. Hãy thu hồi một token trước."
- Sử dụng một token cho mỗi agent hoặc tập lệnh để bạn có thể xem mỗi token đã thực hiện những gì và thu hồi một token mà không làm gián đoạn các token khác.
Tạo token
Mở tab Các token
Mở menu không gian làm việc và chọn AI agents & API. Trên tab Các token, nhấp vào New token.
Mục đích: đặt tên và chọn mục đích sử dụng
Đặt một Tên mà bạn có thể nhận ra trong danh sách token và nhật ký hoạt động, tối đa 100 ký tự, ví dụ: "Docs writer (Claude Code)". Trong phần Nó dùng để làm gì?, hãy chọn một cài đặt sẵn. Nó sẽ đánh dấu các quyền cho công việc đó; bạn có thể tinh chỉnh chúng ở bước tiếp theo.
Chọn cài đặt sẵn gần nhất với công việc của agent. Cài đặt sẵn Sử dụng cho Người viết "Agent soạn thảo; người dùng xem xét và xuất bản." Bản nháp trang tài liệu. 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." Các trang tài liệu, bao gồm cả việc xuất bản. 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 hỗ trợ. Chỉ đọc "Nghiên cứu, kiểm toán và kiểm tra bản dịch." Nhà phân tích "Đọc nội dung và tín hiệu người đọc để đề xuất sửa lỗi." 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." Yêu cầu video, clip và bài viết. Agent không gian làm việc "Mọi thứ mà 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ột cài đặt sẵn bị mờ đi nghĩa là nó chứa quyền mà vai trò của bạn không thể cấp: "Vai trò của bạn không thể cấp mọi khả năng trong cài đặt sẵn này."
Quyền: kiểm tra từng quyền
Bước này liệt kê mọi quyền, được nhóm theo Tài liệu, Video và Không gian làm việc, mỗi quyền đi kèm với chức năng và huy hiệu (Đọc, Chỉnh sửa, Xuất bản, Quản lý hoặc Sử dụng tín dụng). Đánh dấu hoặc bỏ đánh dấu bất kỳ quyền nào. Khi bạn thay đổi tập hợp của cài đặt sẵn, tiêu đề sẽ hiển thị Đã tùy chỉnh và Đặt lại về cài đặt sẵn sẽ hoàn tác các thay đổi của bạn.
Mỗi quyền cho biết loại hành động mà nó cho phép. Mỗi quyền cho phép những gì: Quyền của agent.
Giới hạn: đặt thời hạn, trang web, chi tiêu và địa chỉ
Chi tiêu chỉ xuất hiện khi token có thể sử dụng credit. Xem Tùy chọn giới hạn bên dưới.
Xem lại và tạo
Phần xem lại trình bày bằng ngôn ngữ đơn giản những gì token có thể làm (Có thể đọc, Có thể tạo và chỉnh sửa, Có thể xuất bản, Có thể quản lý trang, Có thể sử dụng credit) và các giới hạn của nó. "Nó hoạt động với tư cách là bạn, trong phạm vi vai trò của bạn cho phép." Nhấp vào Tạo token.
Kiểm tra tóm tắt, sau đó nhấp vào Tạo token. Sao chép token
Token đã được tạo hiển thị token, bắt đầu bằng
clv_agent_: "Sao chép ngay: bạn sẽ không thấy lại nó nữa." Sao chép nó vào kho lưu trữ bí mật hoặc biến môi trường. Kết nối tác nhân bên dưới có sẵn thiết lập cho Claude Code, Codex CLI,.mcp.json,curlvà Claude.ai, ChatGPT. Nhấp vào Tôi đã lưu nó khi bạn hoàn tất.
Token chỉ được hiển thị một lần.
Quay lại giữ lại mọi thứ bạn đã nhập. Việc đóng trình hướng dẫn sau khi thay đổi điều gì đó sẽ hỏi "Hủy token này?": "Thiết lập bạn đã bắt đầu sẽ bị mất. Không có token nào được tạo."
Tùy chọn giới hạn
| Tùy chọn | Chức năng | Mặc định |
|---|---|---|
| Hết hạn sau | 7 ngày, 30 ngày, 90 ngày hoặc 1 năm. Ngày hiển thị bên dưới ("Vào ngày"). Token luôn hết hạn. | 90 ngày |
| Trang tài liệu | Hiển thị khi token có quyền trang tài liệu. 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ả trang mới.") hoặc Các trang web đã chọn. | Các trang web đã chọn khi không gian làm việc có nhiều hơn một trang tài liệu, nếu không là Tất cả trang web |
| Chi tiêu → Mỗi công việc | Số tiền tối đa một lần bắt đầu có thể được báo giá, tính bằng credit. Trống: Không giới hạn. | Không giới hạn |
| Chi tiêu → Mỗi ngày / Mỗi tháng | Số tiền tối đa token có thể chi tiêu (và giữ cho các công việc đang chạy) trong một ngày hoặc tháng dương lịch. | Không giới hạn |
| Chi tiêu → Phê duyệt tự động bên dưới | Các lần bắt đầu được báo giá dưới số credit này sẽ chạy mà không cần con người. "0 nghĩa là con người phê duyệt mọi lần bắt đầu trả phí. Gói của bạn cho phép tối đa 500." (1.000 trên gói Custom.) | 0 |
| Nâng cao → Danh sách IP cho phép | "Tùy chọn. Một địa chỉ hoặc dải địa chỉ trên mỗi dòng; các cuộc gọi từ nơi khác sẽ bị từ chối." Tối đa 20 địa chỉ IPv4/IPv6 hoặc dải CIDR, như 203.0.113.7 hoặc 198.51.100.0/24. |
Trống: bất kỳ địa chỉ nào |
Chi tiêu chỉ xuất hiện khi token có credits:spend (các cài đặt sẵn Nhà sản xuất và Agent không gian làm việc). Cách các giới hạn và phê duyệt hoạt động cùng nhau: Kiểm soát chi tiêu và phê duyệt của agent.
Điều gì xảy ra tiếp theo
- Token hoạt động ngay lập tức qua MCP (
https://app.clevera.ai/mcp) và REST API. - Chủ sở hữu và quản trị viên không gian làm việc nhận được thông báo: "Một token API mới, tên, đã được tạo cho không gian làm việc", cùng với người thiết lập và quyền truy cập của nó.
- Token hiển thị trên tab Các token với bốn ký tự cuối, như
clv_agent_…k7Qe, và mỗi lần sử dụng sẽ cập nhật Sử dụng lần cuối. - Sau khi bạn tạo nó, các quyền và giới hạn của nó không thể thay đổi. Để thay đổi, hãy tạo token mới và thu hồi token cũ. Xem Quản lý token API.
Khắc phục sự cố
| Thông báo | Nguyên nhân | Khắc phục |
|---|---|---|
| "Đặt tên cho token." | Tên bị trống. | Nhập tên. |
| "Chọn ít nhất một khả năng." | Không có quyền nào được đánh dấu. | Đánh dấu ít nhất một quyền. |
| "Chọn ít nhất một trang web." | Các trang web đã chọn nhưng chưa chọn trang nào. | Chọn một trang, hoặc chọn Tất cả trang web. |
| "Nhập số nguyên credit." | Trường chi tiêu có số thập phân hoặc văn bản, hoặc 0 trong giới hạn. | Nhập số nguyên, hoặc để trống giới hạn. |
| "Gói của bạn phê duyệt công việc của agent tự động dưới 500 credit tối đa." | Phê duyệt tự động bên dưới vượt quá mức tối đa của gói. | Giảm xuống. |
| "giá trị không phải là địa chỉ IP hoặc dải địa chỉ." | Dòng danh sách IP cho phép không hợp lệ. | Sửa hoặc xóa dòng đó. |
| "Vai trò của bạn không thể cấp một số khả năng này." | Một quyền nằm ngoài vai trò của bạn. | Bỏ đánh dấu, hoặc yêu cầu chủ sở hữu/quản trị viên tạo token. |
| "Không gian làm việc của bạn đã đạt giới hạn 50 token đang hoạt động. Hãy thu hồi một token trước." | 50 token đang hoạt động. | Thu hồi token bạn không dùng. |
| "API và quyền truy cập agent không có trên gói của bạn." | Không gian làm việc không ở gói Pro, Business hoặc Custom. | Nâng cấp lên Pro. |
| "Không thể tạo token. Thử lại." | Đã xảy ra lỗi. | Thử lại; liên hệ hỗ trợ nếu lỗi tiếp diễn. |