工作区与成员

工作区是 Product SDK 中产品资源的作用域。先绑定工作区，再操作目录、任务、智能体或其他工作区资源；不要在未确认工作区的情况下复用资源 ID。

选择工作区

已知工作区 ID 时，直接获取工作区对象。只有确实允许在工作区不存在时创建时，才按名称确保工作区存在；该操作会先查找完全匹配的可见工作区，并可能创建新的工作区。

工作区名称不能替代 ID。批处理和自动化任务应保存创建、查询或操作者选择所返回的工作区 ID，并在每次写入前确认目标。

SDK 调用

以下示例使用按名称确保工作区存在的方式。返回的 workspace 是后续资源操作的起点：

workspace, err := client.EnsureWorkspace(ctx, workspaceName)
if err != nil {
	return err
}

workspace = client.ensure_workspace(workspace_name)

管理工作区成员

工作区成员是用户账号在当前工作区内的成员身份。邀请成员、更新成员状态、设置角色或移除成员都会改变访问范围，调用前应确认成员标识、角色集合和默认角色。

邀请结果不等于用户账号已经可以访问工作区。需要等被邀请者接受邀请后，再使用返回的成员标识获取成员对象并继续设置角色。不要将旧的角色、授权或权限检查接口当作 Product SDK 的成员管理入口。

Go 使用 workspace.InviteMember 和 workspace.Member；Python 使用 workspace.invite_member 和 workspace.member。邀请所需的成员信息、角色集合和默认角色必须由调用方明确提供。

下一步

最后更新于