The Blog


Watson™ Knowledge Studio easily scales from being a tool for one data scientist to one where many subject-matter experts can come together to work on a single project. One attractive feature of Watson Knowledge Studio is that it allows for easy collaboration among subject-matter experts who are involved in a large-scale enterprise project. Here, I will endeavor to demonstrate how to set up your Watson Knowledge Studio projects for use by multiple users.

Creating a machine learning annotator may require the expertise of individuals with different skillsets — from domain experts to those with project management skills to data scientists. Consider the following personas working on a Watson Knowledge Studio project:

  • An admin who essentially manages the Watson Knowledge Studio instance on IBM Cloud
  • An experienced subject-matter expert who is also a project manager overseeing a project to customize a machine learning model for a domain
  • Other subject-matter experts who are going to assist the project manager with creating the machine learning model by annotating documents to serve as ground truth for the machine learning model.

Also bear in mind that your team members may be scattered across geographies. The administrator of Watson Knowledge Studio on IBM Cloud can create a new instance of Watson Knowledge Studio. In order to collaborate with multiple users on a Watson Knowledge Studio project, you will have to purchase the standard or the premium plan on IBM Cloud (the lite plan is limited to one user). Visit Watson Knowledge Studio for details about the plans. You would also need to ensure that all the experts that are going to be using Watson Knowledge Studio also have an IBM Cloud account. It’s a three-step process to have multiple users collaborating on your Watson Knowledge Studio project. You can watch the videos attached to each step for a demonstration of how the task is performed.

  1. The first step is to invite users to your organization within IBM Cloud once you sign up for a standard or a premium plan. The users who are invited to your organization need to have a Cloud Foundry role of Developer.

  2. After you have created a Watson Knowledge Studio instance, invite users to your Watson Knowledge Studio instance using the Settings icons in the top-right corner. Users can be assigned three roles:

    • Admin: This allows the user to administer the instance by being able to add users and create workspaces. The first user who creates the instance is given the admin role by default. An admin can manage multiple workspaces, switch plans, and manage storage for the Watson Knowledge Studio instance.
    • Project manager: This allows you to manage and administer workspaces, and perform all functions on a project, such as defining type systems, uploading documents, annotating, adjudicating, and building machine learning models.
    • Human annotator: This function is to annotate documents toward creation of ground truth.
  3. Project managers can be assigned to the workspace during the creation of the workspace or later by editing the workspace. Human annotators are assigned to a project when documents are assigned to users to be annotated.

Common pitfalls

These roles cannot be downgraded once assigned. A user can have the role upgraded from human annotator to project manager or admin, but not the other way around. Hence, care should be exercised in properly assigning the roles.