組織のセットアップ
管理コンソールは、資格情報、メンバー、リクエスト履歴、コストの制御を組織ごとにまとめます。設定を変える前に、対象とする組織を選んでください。プラットフォームの root ユーザーは組織を作成できます。組織のメンバーは、割り当てられたロールの権限の範囲で行動します。
最初のリクエスト
ウェルカムフローは、選択した組織の API から 3 つのシグナルを確認します。
- 組織の設定 → プロバイダキー に、プロバイダの資格情報がある。
- キー に、有効なゲートウェイ API キーがある。
- リクエスト統計に、成功したリクエストが少なくとも 1 件含まれる。
プロバイダ資格情報のシグナルが確認するのは存在であり、接続の健全性ではありません。セットアップを確かめるには、BYOK 接続テスト と、実際の推論リクエストを使ってください。ゲートウェイキーは、作成されたと きにコピーしてください。その後の一覧が表示するのはメタデータだけです。クライアント設定の例は、OpenCode、Claude Code、Codex、Continue、Cline にあります。
フローをスキップしても完了しても残るのは、ブラウザごとの設定ではなく、組織全体のフラグです。GET /api/me/onboarding?org_id=<id> がそれを読み取ります。同じ URL への POST は、真になるフラグをちょうど 1 つ、completed または skipped として受け付けます。これらのエンドポイントには、管理セッションと、対象組織への所属が必要です(reader 以上。root はロールゲートをバイパスします)。
メンバーの招待
組織の メンバー ページを開き、受信者のメールアドレスとロールを指定して招待を作成します。使えるロールは org-admin、operator、reader、security_auditor、partner です。招待の管理には members.manage が必要です。
作成すると、一度きりの招待リンクが返ります。そのリンクを受信者と共有してください。API は招待メールを送信しません。有効期限は 72 時間です。再送するとトークンがローテーションされ、新しい有効期間が始まり、以前のリンクは無効になります。取り消すと、保留中の招待は削除されます。
/invite/<token> では、新しい受信者が資格情報を作成します。既存のユーザーは、招待されたアカウントのパスワードで認証する必要があります。データベースが保存するのは、トークンの SHA-256 ハッシュだけです。存在しない、または取り消されたトークンは 404 を返します。期限切れ、またはすでに承諾された招待は 410 を返します。
| メソッド | 管理エンドポイント |
|---|---|
| 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 |
組織のロールとアクセス
組織のロールは、その組織でメンバーがどの操作を実行できるかを決めます。下のロール名は組織ごとに割り当てられます。あるロールに載っていない権限は付与されません。
| 権限 | org-admin | operator | security_auditor | reader | partner |
|---|---|---|---|---|---|
analytics.read | はい | はい | はい | はい | いいえ |
requests.read | はい | はい | はい | はい | いいえ |
requests.read_payloads | はい | いいえ | はい | いいえ | いいえ |
lineage.read | はい | はい | はい | はい | いいえ |
lineage.verify | はい | はい | はい | いいえ | いいえ |
audit.read | はい | いいえ | はい | いいえ | いいえ |
keys.manage | はい | はい | いいえ | いいえ | いいえ |
agent_keys.manage | はい | はい | いいえ | いいえ | いいえ |
budgets.manage | はい | はい | いいえ | いいえ | いいえ |
members.manage | はい | いいえ | いいえ | いいえ | いいえ |
routing.manage | はい | はい | いいえ | いいえ | いいえ |
policies.manage | はい | いいえ | いいえ | いいえ | いいえ |
org.update | はい | いいえ | いいえ | いいえ | いいえ |
表が説明しているのは、組織スコープの権限です。org-admin はこれらの権限をすべて持ちます。operator はキー、予算、経路を扱えますが、メンバー、組織の設定、方針は管理できません。security_auditor はリクエストのペイロードを読むことができ、audit.read 権限を持ちます。reader は利用分析、リクエスト、リーネージへの読み取りアクセ スを持ちます。partner は、現行のロール行列において組織スコープの権限を持ちません。組織ロールを選んでも、別のプラットフォームレベルの security-auditor ロールや、プラットフォームの root アクセスは付与されません。
コンソールは権限を使い、実行できない保護された組織の操作を隠すか無効にします。これは便宜であり、認可の境界ではありません。サーバも、保護された組織の操作を確認します。たとえば、members.manage を持たないメンバーは、招待エンドポイントを直接呼んでも招待を作成できません。リクエストは拒否され、招待は作成されません。他の組織の一部のリソースは利用不可として報告されるため、レスポンスは、別の組織にそのリソースがあるかどうかを明かさないことがあります。
操作が利用できない、またはリクエストが拒否された場合は、まずコンソールが、管理したい組織に設定されているかを確認してください。ロールが付与しない操作が必要な場合は、その組織の org-admin にメンバーシップの更新を依頼してください。別の組織に属するリソースについては、自分がメンバーである場合にだけ、その組織へ切り替えてください。そうでなければ、その管理者に連絡してください。隠されたボタンや、コピーしたリソース ID を、ロール確認を迂回する手段とみなさないでください。
クレジットと組織の上限
クレジット ページは、選択した組織の残高と台帳を表示します。読み取りには budgets.manage が必要です。チャージと、組織をまたぐ低残高レポートは、root のみのままです。オペレータのセットアップ が、これらのエンドポイントと前払いの流れを説明しています。
管理 API と yabanin seed の経路による組織作成では、一度きりのベータ初期付与を適用できます。BETA_STARTER_CREDITS_CENTS の既定は 5000($50)です。ゼロまたは負の値は、これを無効にします。台帳マーカー beta-starter-grant が、繰り返しの付与を防ぎます。これは導入用のクレジットであり、上流プロバイダを無料で使えるという約束ではありません。シードのフィクスチャには、追加のデモクレジットが付くことがあります。
予算 ページは、GET / PUT /api/orgs/{id}/caps を通じて、組織全体の RPM、TPM、月次予算の上限も管理します。読み書きには budgets.manage(または root)が必要です。月次の金額はセント単位です。既定は 60 RPM、200,000 TPM、および現行の DefaultOrgCapsMonthlyBudgetCents 定数における**月あたり 5,000,000 セント($50,000)**です。ソースコメントの一部は、まだ $50 と書いています。振る舞いを決めるのは、定数と API レスポンスです。この上限は、既定の $50 初期クレジット付与とは別です。PUT には変更の reason が必要です。null、または省略された上限フィールドは、上書きを既定値に戻します。
上限を強制するには YABANIN_ORG_CAPS=enforce を設定します。拒否になったであろう件数を 数えるには shadow を設定します。未設定、または認識できない値は、このレイヤを無効にします。1 は有効化の値ではありません。Redis と、データベースを根拠とする上限ソースを設定してください。Redis なしで起動すると、警告を出して上限を無効にします。
エンフォーサが接続されると、enforce モードでは、レート上限またはトークン上限の枯渇は 429 を返し、月次予算の枯渇は 402 を返し、依存の失敗は 503 を返します。上限は 5 秒間、月初来の支出は 3 秒間キャッシュされます。これは、超過をゼロにする予約の仕組みではありません。組織の上限は、API キーの制限、チームの予算、クレジットと並ぶ、追加の制御です。
フィードバックと運用
root のみの フィードバック ページは、送信された分類器のフィードバックを一覧し、組織と評価で絞り込み、絞り込んだデータを CSV としてエクスポートします。使える評価は thumbs_up、thumbs_down、regenerate です。リクエストとコストのレポートは 利用分析 を、アラートとステータスの確認は 公開導入ランブック を参照してください。