environment: một nhãn tự do ngắn bạn
đóng dấu lên mỗi key để console, đội ngũ của bạn, và tab Usage Tracking có
thể nhóm các key theo nơi chúng chạy.
Đây là trường tổ chức nhỏ, không phải một trường thực thi — nó không thay
đổi những gì một key có thể làm. Để biết các giới hạn ràng buộc một key (mô
hình, IP, chi tiêu, hết hạn, chính sách) hãy bắt đầu ở
tổng quan key có phạm vi.
1. Tại sao có tag api key environments
Khi mọi key trông nhưsk-orca-•••• trong danh sách, bạn không thể phân
biệt key production với một key dev dùng một lần — và đó chính xác là key
bạn không muốn xoay vòng, thu hồi, hay nâng mức trần chi tiêu nhầm. Tag
environment biến một credential vô danh thành một cái có nhãn:
- Trong nháy mắt — danh sách key cho thấy key nào là
prod,staging, haydev, nên bạn hành động lên đúng cái. - Theo chi tiêu — tab Usage Tracking có thể gộp chi tiêu theo môi trường, nên “staging tốn của chúng ta bao nhiêu tuần này” là một bộ lọc, không phải một spreadsheet.
- Theo quy ước — một từ vựng dùng chung (
prod/staging/dev) trên toàn workspace, để một đồng đội đọc danh sách hiểu bố cục của bạn mà không cần hỏi.
Tag là tự do và chỉ mang tính mô tả. Nó không kiểm soát mô hình, IP,
chi tiêu, hay chính sách — đó là các
trường key khác. Hai key được gắn tag
prod không nhận được đối xử đặc biệt nào ngoài việc chia sẻ một nhãn.2. Trường này chấp nhận gì
environment là một nhãn văn bản ngắn, tùy chọn trên đối tượng key:
| Thuộc tính | Hành vi |
|---|---|
| Kiểu | Chuỗi tự do — không có enum cố định. prod, staging, dev là quy ước, không phải giá trị built-in. |
| Độ dài | Được cắt khoảng trắng xung quanh và giới hạn ở 32 ký tự; bất cứ gì dài hơn bị cắt bớt. |
| Rỗng / không đặt | Một key không có tag đọc về như trạng thái không nhãn và gộp vào một phân đoạn unlabeled trong Usage Tracking. |
| Tác động lên traffic | Không có — thuần túy tổ chức. |
3. Đặt tag trên một key
Đặtenvironment trong trình chỉnh sửa key ở console (/console/token) —
cùng nơi bạn đặt giới hạn mô hình và phần đính kèm chính sách. Tạo hoặc
chỉnh sửa key yêu cầu vai trò Developer trở lên.
Mở key
Trong console đi tới Keys (
/console/token) và tạo một key mới hoặc
chỉnh sửa một cái hiện có.4. Phân đoạn chi tiêu theo môi trường
Một khi các key của bạn được gắn tag, tab Usage Tracking (console → Overview) có thể nhóm chi tiêu, request, và token theo chiều environment. Nó gộp việc sử dụng của mỗi key dưới nhãn môi trường của nó, với các key không gắn tag được thu thập dướiunlabeled. Điều đó trả lời các câu hỏi mà
chế độ xem theo từng key không thể, ở mức bạn thực sự lập ngân sách:
stagingđang tiêu bao nhiêu so vớiprodtuần này?- Key
devmới có vượt quá những gì chúng ta mong đợi không? - Môi trường nào đã thúc đẩy spike vào thứ Ba?
Chiều môi trường đọc nhãn hiện tại trên mỗi key khi bạn tải báo cáo. Gắn
lại tag một key thay đổi cách chi tiêu lịch sử của nó được gộp ở lần tiếp
theo bạn mở chế độ xem — tag là một thuộc tính sống của key, không phải một
con dấu đóng băng lên các request trong quá khứ.
5. Một ví dụ chi tiết: ba key, một workspace
Một đội nhỏ chạy một sản phẩm trên ba môi trường:| Key | environment | Phạm vi khác (phần thực sự thực thi) |
|---|---|---|
| Production agent | prod | firewall_policy_id chặt, credit_limit_usd hằng tuần, allow_ips đã ghim |
| Staging agent | staging | một chính sách firewall permissive ở shadow mode, một mức trần thấp hơn |
| Local dev | dev | model_limits vào một mô hình rẻ, expired_time ngắn hạn |
prod bạn chắc
chắn đã túm đúng cái.
6. Tag vs. thực thi — đừng nhầm hai cái
Tag môi trường là trường nhẹ nhất trên một key. Dễ với tới nó như một điều khiển bảo mật; nó không phải vậy. Nếu bạn muốn một keydev không thể
chạm tới các mô hình production hay tiêu tiền thật, nhãn sẽ không làm điều
đó — các trường thực thi mới làm:
Giới hạn mô hình
model_limits là cái thực sự chặn một key dev khỏi gọi một mô hình
frontier — không phải tag dev.Quota, mức trần & hết hạn
credit_limit_usd và expired_time ràng buộc chi tiêu và vòng đời.
Tag tổ chức; những cái này ràng buộc.Gắn chính sách
guardrail_id và firewall_policy_id gắn các chính sách nội dung và
cuộc gọi tool chi phối traffic của key.Đối tượng token
Tham chiếu đầy đủ từng trường cho một key, bao gồm cả tag môi trường.
7. Vị trí của nó
Tag môi trường là một lát của mô hình key rộng hơn — các danh tính hẹp, có nhãn cho mọi agent và mọi nơi nó chạy.Tổng quan key có phạm vi
Trung tâm cho mọi trường mà một key mang theo.
Phạm vi & key
Cách workspace, chính sách, và key lồng vào nhau.
Quản lý key
Tạo, chỉnh sửa, và thu hồi key trong console.