工作区

工作区是知识库的顶层容器。工作区提供了组织边界——您可以拥有个人工作区、团队工作区，以及为不同客户或项目设置单独的工作区。

概念

属性	描述
名称	人类可读的标签（例如："Personal"、"Engineering Team"）
类型	个人（单用户）或团队（多用户）
知识库	该工作区内的所有知识库
成员	具有访问权限的用户（仅限团队工作区）

tokst workspace create --name "Engineering Team"

注册时，TokST 会创建一个名为"Personal"（或您的账户名称）的默认工作区。这是您的当前工作区，直到您创建或切换到另一个工作区。

tokst workspace create --name "客户研究"

该命令默认创建个人工作区，数量上限遵循个人套餐。

团队工作区会与团队套餐一并开通。成员通过邀请加入，并共同使用该团队工作区的席位、调用、存储和知识库额度。工作区开通后类型固定。

tokst workspace list

显示您有权访问的所有工作区，并标记已保存的当前工作区。待处理的团队邀请也会在这里展示对应的接受和拒绝命令；tokst workspace inbox 可直接查看同一收件箱。

tokst workspace switch <workspace-id>

切换工作区会更改可用的知识库。选择会保存在本地，之后的 tokst atlas init 会在该工作区创建知识库。接受待处理邀请后，才能切换到其工作区。

从控制台侧栏打开智能体页面。页面始终跟随侧栏当前工作区，仅展示该工作区的可信智能体与持久交接。API Key 首次以可信智能体方式请求时会创建稳定的 agt_... 身份码。

页面支持复制身份码、查看密钥状态和最后活跃时间、向一个或多个智能体定向交接，以及向所有活跃智能体广播。收件箱通过实时更新展示消息，具有权限的工作区成员可以确认或关闭回执。

您可以通过 REST API 或远程 MCP 服务器删除工作区：

curl -X DELETE https://api.tokst.com/v1/workspaces/<workspace-id> \
  -H "Authorization: Bearer $TOKST_API_KEY"

远程 MCP 客户端也可以使用 workspaceId 调用 tokst_workspace_delete。删除前必须先移除工作区内的所有知识库；仍有知识库时，API 返回 409 Conflict。CLI 当前未提供工作区删除命令。

团队工作区使用基于角色的访问控制。邀请成员前，请阅读团队协作说明。