ワークスペースで Cloud Agents のリソースを分離し、サービスアカウントの紐付けを管理します。
ワークスペース（Workspace）は、エンタープライズスペース内のリソース分離単位です。各ワークスペースにはサービスアカウントが紐付けられ、そのサービスアカウントの API Key を使用した呼び出しは、紐付け先のワークスペース内のリソースにのみアクセスできます。エージェント、セッション、デプロイ、環境、ファイル、スキル、シークレット、メモリはそれぞれ 1 つのワークスペースにのみ属し、ワークスペースをまたいで参照することはできません。プロジェクト、エンドカスタマー、環境（prod / staging など）の分離に利用できます。
コンソール上部バーの右側にあるワークスペースセレクターに、現在のワークスペースが表示されます。セレクターを開くと、次の操作ができます。
管理ページには、組織内のすべてのワークスペースが表示されます。名前または ID で検索し、アーカイブ状態で絞り込めます。一覧にはワークスペースの ID、名前、紐付けられたサービスアカウント、状態が表示され、現在のワークスペースにはマークが付きます。サービスアカウントの作成と API Key の管理は、ページ右上のリンクから移動できる Qoder 管理コンソールで行います。
右上の新規ワークスペース作成ボタンをクリックし、名前と説明を入力します。その場でサービスアカウントを選択して紐付けることも、この手順をスキップして後から紐付けることもできます。同じエンタープライズスペース内で、ワークスペース名を重複させることはできません。
ワークスペースの名前と説明を変更します。表示名を変更しても、ワークスペース ID や内部のリソースには影響しません。
対象ワークスペースの行操作からサービスアカウントを変更する項目を選択し、組織内の既存のサービスアカウントを選び直します。変更後、このワークスペースの企業 API 呼び出しには、新しいサービスアカウントの API Key を使用します。他のワークスペースに紐付けられているサービスアカウントは選択できません。
対象ワークスペースの行操作から紐付け解除の項目を選択し、確認します。解除後、ワークスペースは読み取り専用になります。サービスアカウントを再び紐付けるまで、セッションを開始できません。
ワークスペースが 2 つ以上ある場合、不要になったワークスペースをアーカイブできます。アーカイブ後は、そのワークスペースへのアクセスや API 呼び出しができなくなり、内部のリソースも表示されなくなります。同時に、紐付けられたサービスアカウントが解放され、他のワークスペースに紐付けられるようになります。
基本ルール
- 1 つのワークスペースに紐付けられるサービスアカウントは 1 つです。サービスアカウントも、1 つのワークスペースにのみ紐付けられます。
- 各エンタープライズスペースにはデフォルトのワークスペースが用意されています。既存のリソースと API Key はデフォルトのワークスペースに属するため、移行は不要です。デフォルトのワークスペースの名前は変更できます。
- サービスアカウントが紐付けられていないワークスペースは読み取り専用です。セッションの開始や操作を行うには、サービスアカウントを紐付けてください。
- ワークスペースはエンタープライズスペースでのみ利用でき、個人スペースには適用されません。作成と管理には、組織管理者または構成管理者の権限が必要です。
- ワークスペースが 2 つ以上ある場合、不要になったワークスペースをアーカイブできます。
ワークスペースへのアクセス
コンソール上部バーの右側にあるワークスペースセレクターに、現在のワークスペースが表示されます。セレクターを開くと、次の操作ができます。
- ワークスペースの検索と切り替え。一覧には、各ワークスペースに紐付けられたサービスアカウントと、デフォルトのワークスペースが表示されます。
- ワークスペースの作成。
- ワークスペース管理ページへの移動。