ワークスペース

ワークスペースは、共有する Epismo データの組織の境界です。ワークスペースが選択されていない場合、データは個人スペースに保存されます。

ワークスペースの名前はワークスペースのサブドメインと同じ制約です。3〜30文字、英小文字 a-z、数字 0-9、ハイフンのみを使えます。予約語は拒否されます。

データが個人ではなく組織に属する場合はワークスペースを使います。チームのプロジェクト、共有パック、ワークフロー実行、メンバー管理、請求などです。チームに共有する必要が出るまでは、個人的な実験は個人スペースに置いてください。

個人スペース

個人スペースは現在のユーザーに属します。個人的な実験、下書き、チームに共有しない自分用の作業に使います。

個人スペースにはプロジェクトがありません。非公開データをグループで共有したい場合は、ワークスペースに切り替えて project scope を使います。

ワークスペースのコンテキスト

CLI は次の順序でワークスペースのコンテキストを解決します。

1. EPISMO_TOKEN に埋め込まれたワークスペース。
2. epismo workspace use $WORKSPACE_ID で保存したデフォルトのワークスペース。
3. 個人スペースへのフォールバック。

API は対応するエンドポイントで workspaceId を受け取れます。MCP は Bearer トークンからワークスペースのコンテキストを決めます。

自動化では、ワークスペースコンテキストを明示するのがおすすめです。API では workspaceId を渡し、CLI スクリプトでは事前に epismo workspace use を実行し、または epismo token create --workspace-id でワークスペースに紐づくトークンを発行します。これによりクレジット使用と非公開データへのアクセスが予測しやすくなります。

ワークスペース内のプロジェクト

ワークスペースのメンバーであることは、そのワークスペース内のすべての非公開パックやトラックが見えることを意味しません。プロジェクトはワークスペース内の非公開共有コンテナです。特定のグループで共同作業するパックやトラックは scope: { "type": "projects", "ids": [...] } に置きます。プロジェクト と スコープ を参照してください。

メンバー

ワークスペースのメンバーのロールは次の通りです。

ワークスペースのメンバーシップは、ワークスペースのプロジェクトに参加できるユーザーと、ワークスペースのユーザーリソースに表示されるユーザーを決めます。

ワークスペースのプランの値は basic と pro です。ワークスペースのチェックアウトは、支払いを完了または再試行するための支払い URL を返します。

使いどころ

• 個人的な下書きや自分用ワークフローには個人スペースを使います。
• データ、請求、メンバー管理が組織に属する場合はワークスペースを使います。
• ワークスペース内のどのメンバーが特定の非公開パックやトラックを見られるかは、プロジェクトで決めます。