Persediaan organisasi
Konsol pentadbir mengumpulkan kelayakan, ahli, sejarah permintaan, dan kawalan kos mengikut organisasi. Pilih organisasi yang dimaksudkan sebelum mengubah tetapannya. Pengguna akar platform boleh mencipta organisasi; ahli organisasi bertindak dalam kebenaran peranan yang ditetapkan kepada mereka.
Permintaan pertama
Aliran alu-aluan menyemak tiga isyarat daripada API organisasi yang dipilih:
- Kelayakan penyedia wujud dalam Tetapan organisasi → Kunci penyedia.
- Kunci API gerbang yang aktif wujud dalam Kunci.
- Statistik permintaan merangkumi sekurang-kurangnya satu permintaan yang berjaya.
Isyarat kelayakan penyedia menyemak kewujudan, bukan kesihatan sambungan. Gunakan ujian sambungan BYOK dan permintaan inferens sebenar untuk mengesahkan persediaan. Salin kunci gerbang apabila ia dicipta; senarai kemudian menunjukkan metadatanya sahaja. Contoh konfigurasi klien tersedia untuk OpenCode, Claude Code, Codex, Continue, dan Cline.
Melangkau atau menyelesaikan aliran mengekalkan bendera seluruh organisasi, bukan
keutamaan bagi setiap pelayar. GET /api/me/onboarding?org_id=<id> membacanya;
POST ke URL yang sama menerima tepat satu bendera benar, completed atau
skipped. Endpoint ini memerlukan sesi pentadbir dan keahlian dalam
organisasi sasaran (pembaca atau ke atas; akar memintas pintu peranan).
Menjemput ahli
Buka halaman Ahli organisasi dan cipta jemputan dengan
e-mel penerima dan peranan. Peranan yang tersedia ialah org-admin, operator,
reader, security_auditor, dan partner. Mengurus jemputan memerlukan
members.manage.
Penciptaan memulangkan pautan jemputan sekali guna. Kongsikan pautan itu dengan penerima; API tidak menghantar e-mel jemputan. Ia tamat tempoh selepas 72 jam. Penghantaran semula memutar token dan memulakan tetingkap kesahan baharu, lalu membatalkan pautan sebelumnya. Penarikan balik mengalih keluar jemputan yang belum selesai.
Di /invite/<token>, penerima baharu mencipta kelayakan; pengguna sedia ada
mesti mengesahkan dengan kata laluan akaun yang dijemput. Pangkalan data menyimpan
hash SHA-256 token sahaja. Token yang tiada atau ditarik balik memulangkan 404; jemputan
yang tamat tempoh atau telah diterima memulangkan 410.
| Kaedah | Endpoint pentadbir |
|---|---|
| GET | /api/organizations/{id}/members/invites |
| POST | /api/organizations/{id}/members/invite |
| POST | /api/organizations/{id}/members/invites/{inviteID}/resend |
| POST | /api/organizations/{id}/members/invites/{inviteID}/revoke |
Peranan dan akses organisasi
Peranan organisasi menentukan tindakan yang boleh diambil oleh ahli dalam organisasi itu. Nama peranan di bawah ditetapkan bagi setiap organisasi. Kebenaran yang tidak disenaraikan untuk sesuatu peranan tidak diberikan.
| Kebenaran | org-admin | operator | security_auditor | reader | partner |
|---|---|---|---|---|---|
analytics.read | ya | ya | ya | ya | tidak |
requests.read | ya | ya | ya | ya | tidak |
requests.read_payloads | ya | tidak | ya | tidak | tidak |
lineage.read | ya | ya | ya | ya | tidak |
lineage.verify | ya | ya | ya | tidak | tidak |
audit.read | ya | tidak | ya | tidak | tidak |
keys.manage | ya | ya | tidak | tidak | tidak |
agent_keys.manage | ya | ya | tidak | tidak | tidak |
budgets.manage | ya | ya | tidak | tidak | tidak |
members.manage | ya | tidak | tidak | tidak | tidak |
routing.manage | ya | ya | tidak | tidak | tidak |
policies.manage | ya | tidak | tidak | tidak | tidak |
org.update | ya | tidak | tidak | tidak | tidak |
Jadual ini memerihalkan kebenaran berskop organisasi. org-admin mempunyai semua
kebenaran ini. operator boleh bekerja dengan kunci, bajet, dan penghalaan, tetapi
tidak boleh mengurus ahli, tetapan organisasi, atau dasar. security_auditor
boleh membaca muatan permintaan dan mempunyai kebenaran audit.read. reader mempunyai
akses baca kepada analitik, permintaan, dan provenans. partner tidak mempunyai
kebenaran berskop organisasi dalam matriks peranan semasa. Peranan
juruaudit keselamatan peringkat platform yang berasingan dan akses akar platform tidak diberikan
dengan memilih peranan organisasi.
Konsol menggunakan kebenaran anda untuk menyembunyikan atau menyahdayakan tindakan organisasi
yang dilindungi yang tidak dapat anda ambil. Itu kemudahan, bukan sempadan
keizinan: pelayan juga menyemak tindakan organisasi yang dilindungi. Contohnya,
ahli tanpa members.manage tidak boleh mencipta jemputan dengan memanggil
endpoint jemputan secara terus; permintaan ditolak dan tiada jemputan
dicipta. Sesetengah sumber organisasi asing dilaporkan sebagai tidak tersedia, jadi
respons mungkin tidak mendedahkan sama ada sumber dalam organisasi lain wujud.
Jika sesuatu tindakan tidak tersedia atau permintaan ditolak, semak dahulu bahawa
konsol ditetapkan kepada organisasi yang anda ingin urus. Jika anda memerlukan tindakan
yang tidak diberikan oleh peranan anda, minta org-admin organisasi itu mengemas kini
keahlian anda. Bagi sumber yang dimiliki organisasi lain, tukar
ke organisasi itu hanya jika anda ahli; jika tidak, hubungi
pentadbirnya. Jangan anggap butang tersembunyi atau ID sumber yang disalin sebagai cara
untuk memintas semakan peranan.
Kredit dan had organisasi
Halaman Kredit mendedahkan baki dan lejar organisasi yang dipilih.
Bacaan memerlukan budgets.manage; tambah nilai dan laporan baki rendah merentas organisasi
kekal untuk akar sahaja. Persediaan operator
memerihalkan endpoint ini dan aliran prabayar.
Penciptaan organisasi melalui API pentadbir dan laluan yabanin seed boleh
menggunakan pemberian permulaan beta sekali. BETA_STARTER_CREDITS_CENTS lalai kepada
5000 ($50); nilai sifar atau negatif menyahdayakannya. Penanda lejar
beta-starter-grant menghalang pemberian berulang. Ini ialah kredit pelaksanaan,
bukan janji penggunaan penyedia huluan secara percuma. Lekapan benih boleh membawa
kredit demo tambahan.
Halaman Bajet juga mengurus had RPM, TPM, dan bajet
bulanan seluruh organisasi melalui GET / PUT /api/orgs/{id}/caps. Akses baca dan tulis
memerlukan budgets.manage (atau akar). Jumlah bulanan ialah dalam sen. Lalai
ialah 60 RPM, 200,000 TPM, dan 5,000,000 sen ($50,000) sebulan dalam
pemalar DefaultOrgCapsMonthlyBudgetCents semasa. Sesetengah komen sumber
masih menyatakan $50; pemalar dan respons API menentukan tingkah laku. Had ini
berasingan daripada pemberian kredit permulaan $50 lalai. PUT memerlukan
reason mutasi; medan had yang null atau ditinggalkan menetapkan semula penggantian mereka kepada lalai.
Tetapkan YABANIN_ORG_CAPS=enforce untuk menguatkuasakan had, atau shadow untuk mengira
penolakan yang sepatutnya berlaku. Nilai yang tidak ditetapkan atau tidak dikenali menyahdayakan lapisan ini; 1
bukan nilai dayakan. Konfigurasikan Redis dan sumber had yang disokong pangkalan data:
permulaan tanpa Redis menyahdayakan had dengan amaran.
Setelah penguat kuasa disambungkan, kehabisan had kadar atau token memulangkan 429, kehabisan bajet bulanan memulangkan 402, dan kegagalan kebergantungan memulangkan 503 dalam mod enforce. Had disimpan dalam cache selama lima saat dan perbelanjaan terkumpul bulan selama tiga saat; ini bukan mekanisme tempahan tanpa lebihan. Had organisasi ialah kawalan tambahan di samping had kunci API, bajet pasukan, dan kredit.
Maklum balas dan operasi
Halaman Maklum Balas untuk akar sahaja menyenaraikan maklum balas pengelas yang diserahkan, menapis
mengikut organisasi dan penilaian, dan mengeksport data yang ditapis sebagai CSV. Penilaian
yang tersedia ialah thumbs_up, thumbs_down, dan regenerate. Lihat
Analitik untuk pelaporan permintaan dan kos serta
runbook pelaksanaan awam untuk amaran dan semakan status.