概要
Team Workspaces
team workspace で API キー、List、usage、billing、credit を管理するときの基本運用です。
このページの内容5項目
Signal Foundry の通常利用単位は team workspace です。1 人で使う場合も、自分だけの team workspace を作り、その team で API キー、List、usage、billing、credit を管理します。
サインアップ直後はユーザー account が作られます。その後、最初の team workspace を作成すると、CLI / Skills / REST API で使う account scope が固定されます。
チームでできること
- 共有 API キーを発行する
- 用途別にキーを分ける
- rotate / revoke を行う
- 30 日間の usage summary を確認する
- team billing と credit grant を確認する
- saved List と list detail を team scope で読む
current shipped surface では、チーム運用の中心は API キー、usage summary、billing、saved List の read surface です。List の作成・enrichment・export の正本は CLI / API です。
作成の冪等性
team workspace の作成は、同じ owner に対して retry-safe です。通信再試行や二重 submit が起きても、既存の owner team があればそれを返します。1 人 1 team の通常運用を保ち、重複 team を増やさないための制約です。
権限
チームの API キー管理には settings.manage が必要です。
画面で見えるもの
- API キー一覧
- 発行日時
- 有効期限
- 最終利用時刻
- state (
active / revoked / rotated) - 30 日 usage summary
- endpoint breakdown
- API key breakdown
- billing status
- credit grant / usage context
- saved List / list detail / manage view
推奨運用
- agent ごとにキーを分ける
- 本番ジョブと検証ジョブでキーを分ける
- 個人 account のキーをチーム用途へ流用しない
- 利用量の多い endpoint を usage summary で確認する
- rotate 後の旧キーを使い続けない
- 契約と credit は team billing で確認する
チーム運用で重要なのは、誰が UI を触ったかより、どの team scope でどのキーがどの用途で使われ、どの List / run / credit に紐づいているかを見える化することです。