Skip to main content

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:

  1. Kelayakan penyedia wujud dalam Tetapan organisasi → Kunci penyedia.
  2. Kunci API gerbang yang aktif wujud dalam Kunci.
  3. 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.

KaedahEndpoint 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.

Kebenaranorg-adminoperatorsecurity_auditorreaderpartner
analytics.readyayayayatidak
requests.readyayayayatidak
requests.read_payloadsyatidakyatidaktidak
lineage.readyayayayatidak
lineage.verifyyayayatidaktidak
audit.readyatidakyatidaktidak
keys.manageyayatidaktidaktidak
agent_keys.manageyayatidaktidaktidak
budgets.manageyayatidaktidaktidak
members.manageyatidaktidaktidaktidak
routing.manageyayatidaktidaktidak
policies.manageyatidaktidaktidaktidak
org.updateyatidaktidaktidaktidak

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.