Ba loại key

Key nhân sự, service key và key MCP cho admin: dùng khi nào, ai phát, phát ở đâu, thu hồi ra sao.

Key là chuỗi bí mật mà trợ lý AI dùng để vào CoreSkill. Có ba hệ key tách biệt hoàn toàn: key của hệ này không bao giờ mở được endpoint của hệ kia, kể cả khi bạn dán nhầm.

Loại	Tiền tố	Dùng cho	Kết nối vào
Key nhân sự	`cek_`	Trợ lý AI của một nhân sự cụ thể	hub của Biz
Service key	`csk_`	Tích hợp máy-với-máy, không gắn với người	một server cụ thể
MCP cho admin	`cmk_`	Trợ lý AI của quản lý, để quản trị thay bạn	endpoint quản lý

Chọn loại nào?

Gần như luôn là key nhân sự. Mỗi người một key, thấy đúng skill theo phòng của họ, thu hồi là cắt đúng người đó. Chỉ dùng service key khi bên gọi là một hệ thống chứ không phải một con người.

Key nhân sự, loại bạn dùng hằng ngày

Vào Key nhân sự trong thanh bên. Có hai nút:

Phát key: Cho một người. Chọn Nhân sự, đặt Tên key (theo máy họ dùng: Laptop, Máy công ty), chọn Thời hạn.
Phát cho cả phòng: Cho mọi thành viên đang hoạt động trong phòng chưa có key, tối đa 50 người một lượt. Không tính phòng con, muốn phòng con thì làm riêng từng phòng. Ai đã có key sẽ được bỏ qua, nên bấm lại nhiều lần cũng an toàn.

Ô Thời hạn có các mốc: Không hết hạn (mặc định), 7 ngày, 30 ngày, 90 ngày, 180 ngày, 365 ngày. Key hết hạn tự ngừng hoạt động, rất tiện cho cộng tác viên và người dùng thử.

Key chỉ hiện đúng MỘT lần

Ngay sau khi phát, thẻ vàng Sao chép key ngay bây giờ hiện ra. Rời khỏi trang là không đọc lại được nữa, vì hệ thống chỉ lưu bản băm chứ không lưu key thật. Mất thì thu hồi và phát cái mới, không có cách nào khác.

Phát cả phòng thì có thêm nút Sao chép tất cả dạng CSV để dán vào bảng tính rồi gửi cho từng người.

Mỗi người giữ tối đa 5 key đang hoạt động. Vượt trần sẽ gặp câu Trần ở đây là 5 key. Hãy thu hồi hoặc xóa key cũ trước.

Đổi phòng thì không phải phát lại key

Key nhân sự ghim theo con người, không ghim theo server. Tập skill mà nó đọc được tính lại ở mỗi lượt gọi, theo phòng ban hiện tại của người đó. Chuyển một người từ Marketing sang Sales là AI của họ đổi bộ skill ngay, vẫn dùng đúng key cũ.

Nhân viên tự phát key cho mình

Vào Cài đặt Biz → bật công tắc Nhân viên được tự phát key cho mình. Khi bật, Nhân viên vào Quyền của tôi sẽ thấy nút Tự phát key cho tôi.

Tắt thì chỉ Chủ sở hữu, Quản trị và Trưởng phòng phát key nhân sự, và nhân viên thấy dòng Biz này không cho tự phát key, hãy nhờ trưởng phòng hoặc quản trị phát cho bạn.

Bật công tắc này giảm hẳn việc vặt cho quản lý: người mất máy tự thu hồi key cũ và tự phát key mới ngay, không phải chờ ai. Đổi lại bạn mất một chốt kiểm soát. Với team dưới vài chục người, bật thường là đáng.

Thu hồi và xóa

Mỗi dòng key có hai nút. Thu hồi giữ dòng key lại trong danh sách với huy hiệu Đã thu hồi, nhờ vậy bạn vẫn đối soát được nhật ký cũ. Xóa gỡ hẳn bản ghi.

Nên thu hồi, đừng xóa. Thu hồi cắt quyền ngay lập tức mà vẫn giữ được dấu vết; sau này có ai hỏi "key đó từng đọc gì" thì bạn còn câu trả lời. Chỉ xóa khi dọn dẹp danh sách quá dài.

Lượt gọi bằng key đã thu hồi hoặc hết hạn vẫn được ghi vào nhật ký với trạng thái Từ chối. Đây là cách bạn phát hiện một key bị lộ vẫn đang bị thử.

Service key cho tích hợp máy móc

Chỉ Chủ sở hữu và Quản trị phát được. Vào một server → tab Key → Phát key hoặc Phát hàng loạt (mỗi dòng một tên, tối đa 20 một lượt).

Key này ghim theo đúng một server: key của server A gọi server B sẽ bị từ chối.
Tối đa 200 key mỗi server.
Không gắn với người nào, nên nhật ký chỉ biết tên key chứ không biết ai đang dùng.
Trưởng phòng quản được server nhưng không phát được service key, họ dùng key nhân sự.

Đừng dùng service key thay cho key nhân sự. Một key dùng chung cho cả phòng thì thu hồi là cắt của tất cả mọi người, và nhật ký không cho bạn biết ai đã đọc gì.

Đặt key ở đâu trong cấu hình

Ưu tiên Gắn ở header Authorization (khuyên dùng). Mọi đoạn cấu hình trong Hướng dẫn kết nối đều theo cách này.

Chỉ dùng key trong URL khi bắt buộc

Một số client không đặt được header tùy chỉnh. Với chúng, CoreSkill có dạng địa chỉ nhét key vào cuối đường dẫn. Key sẽ nằm trong access log của proxy và của máy chủ, coi như nửa công khai. Chỉ dùng khi không còn cách nào, và ưu tiên đặt hạn dùng ngắn cho key đó.

Bảng tra nhanh

	Key nhân sự	Service key	MCP cho admin
Phát ở trang	Key nhân sự, Quyền của tôi	server → tab Key	MCP cho admin
Ai phát được	Chủ sở hữu, Quản trị, Trưởng phòng (nhánh mình), Nhân viên (nếu bật)	Chủ sở hữu, Quản trị	Chủ sở hữu, Quản trị
Trần	5 đang hoạt động / người	200 / server	10 / Biz
Phát hàng loạt	50 / lượt (cả phòng)	20 / lượt	không
Đặt hạn dùng	có	có	không
Ghi được dữ liệu?	không, chỉ đọc	không, chỉ đọc	có