付与されたアカウントでサインインし、ワークスペースとロールを確認してからデータを処理します。
アクセスとロール
抽出、検索、コネクタ設定の前に行います。ブラウザのサインインは bundata_session という不透明なセッション Cookie です。これは Bundata の API キーではなく、OpenAI、Anthropic、Google のキーでもありません。
サインイン
- 管理者から渡された Bundata アプリケーションの URL を開きます。
- そのアカウントの方法でサインインします。メールとパスワード、既存アカウントに結び付いた Google、またはその登録モードで有効な組織の SSO です。
- 登録が閉じている（
ENROLLMENT_CLOSED）と返った場合、公開の自己登録は使えません。クライアント管理者または Bundata に依頼します。別のアカウントを作って回避しないでください。 - パスワード画面が Google または SSO を使うアカウントだと示すときは、その方法を使います。
ワークスペースを選ぶ
一つのアカウントが複数のワークスペースに所属できます。アクティブなワークスペースはブラウザセッションに保存されます。
- ワークスペースの切り替えを開き、オンボーディングで指定されたワークスペースを選びます。
- 表示を確認します。保存型ワークスペースはドキュメント、スキーマ、実行、結果を保持します（ポリシー明示前に作成された古いワークスペースも保存型として扱われます）。非保持ワークスペースは別の経路で、顧客コンテンツを保持しないことが示されます。
- ワークスペースが見えない場合、メンバーではありません。owner または admin が所属を付与します。ワークスペースを切り替えても、データはコピーされません。
プラットフォーム通知と更新
プラットフォームのヘッダーには、ワークスペースの問題、アップロード状態、新しいアプリケーションビルド（version.json）を知らせる通知ベルとステータスバナーがあります。エラーや警告の通知は、閉じるかリンク先の画面を開くまで表示されたままになります。
ロール
階層は owner、admin、editor、viewer です。古い member ロールは editor として扱われます。
| ロール | 主な用途 | 設定の AI プロバイダーとモデル |
|---|---|---|
| Owner | 組織とワークスペースの管理、他の owner の割り当て、プライバシー保持設定（learning:manage、ask_history:manage、explore:manage） | 組織の AI プロバイダーキーの接続・削除、ワークスペースのモデル選択の変更が可能 |
| Admin | メンバーの招待と管理、エージェント認証情報の管理（agent_credential:manage）、グラフ品質レビュー（graph:review）、コンテキストエンジンの管理（context_engine:manage） | 組織の AI プロバイダーキーの接続・削除、ワークスペースのモデル選択の変更が可能 |
| Editor | アップロード、抽出、スキーマ、実行、およびコンテキストライブラリのドラフト・提案（library:edit） | 接続済みプロバイダーと AI モデルマップを読み取り専用で確認可能。ライブラリスチュワードに指名された editor は library:approve を持ちます |
| Viewer | 許可されたコレクション、回答、承認済みコンテキストライブラリ項目（library:read）の閲覧 | モデル設定は読み取り専用。キーやモデルは変更できません |
共有設定は、個人の秘密鍵ではなく、組織またはワークスペースに適用されます。組織のプロバイダーキーを差し替えたりワークスペースのモデルを変更したりすると、その後のモデル呼び出しに効きますが、既に保存されている埋め込みや抽出結果は書き換わりません。
途中で出会う権限
- ドキュメントとコレクション: アップロードとソース取り込みには
document:uploadが必要です。コレクションの閲覧にはcollection:read、文書内容にはdocument:readが必要です。チャンクサイズの変更やワークフローのナレッジレイヤー構築にはcollection:updateが必要です。 - 検索、回答、評価: セマンティック検索と根拠付きの回答には
agent:runが必要です。評価の開始にはeval:createが必要です。 - コンテキストスタジオとコンテキストエンジン: レイヤーの構築や回答スイッチの変更には
context_engine:manage（admin/owner）が必要です。ライブラリのドラフトやコンテキストセットの編集にはlibrary:edit、ライブラリの承認にはlibrary:approve（admin、owner、または指名されたスチュワード）が必要です。品質レビューコンソールでの判断にはgraph:reviewが必要です。Data タブでのデータベーススキーマ読み取りにはstructured:manageとconnection:useが必要です。 - プライバシーとメモリ: 質問からの学習の管理には
learning:manage（owner）、質問履歴とエージェントメモリの保持設定にはask_history:manage（owner）が必要です。
操作が無いときは API が 403 FORBIDDEN を返します。owner または admin にロール変更を依頼します。アクセスを借りるためにパスワードやセッション Cookie を共有しないでください。
ブラウザ以外のクライアント
ワークスペース管理者は 設定 → エージェントアクセス で /api/agent/v1/* とワークスペース MCP サーバー用のスコープ付き bdk_… トークンを発行できます（開発者 を参照）。/api/* に対する一般的な HTTP 自動化では、非ブラウザスクリプトは POST /auth/login の bearer トークンで認証します。サインインやジョブが失敗したときは、contact@bundata.com にメールしてください。