Classification

Set Up via IBM Watson

1. Sign up for Watson services

• Register for an IBM Cloud account or sign into your existing one.
• Check for an email from IBM Cloud and click the Confirm Account link.
• Log into your account (accepting the privacy policy) and create a new Natural Language Understanding Resource if you do not already have one. It may take a minute for your account to fully populate with the default resource group to use.
• Click Manage in the left hand menu, then Show credentials on the Manage page to view the credentials for this resource.

2. Configure IBM Watson API Keys under Tools > ClassifAI > Language Processing > Classification > Settings

• Select IBM Watson NLU in the provider dropdown.

The credentials screen will show either an API key or a username/password combination.

If your credentials contain an API Key, then:

• In the API URL field enter the URL
• Enter your API Key in the API Key field.

If your credentials contain a username and password, then:

• In the API URL field enter the URL
• Enter the username value into the API Username.
• Enter the password into the API Key field.

⚠️ Note: Deprecated Endpoint URLs: watsonplatform.net

IBM Watson endpoint urls with watsonplatform.net were deprecated on 26 May 2021. The pattern for the new endpoint URLs is api.{location}.{offering}.watson.cloud.ibm.com. For example, Watson's NLU service offering endpoint will be like: api.{location}.natural-language-understanding.watson.cloud.ibm.com

For more information, see https://cloud.ibm.com/docs/watson?topic=watson-endpoint-change.

Taxonomy options

IBM Watson's Categories, Keywords, Concepts & Entities can each be stored in existing WordPress taxonomies or a custom Watson taxonomy.

3. Configure Post Types to classify and IBM Watson Features to enable under ClassifAI > Language Processing > Classification > Settings

• Choose which public post types to classify when saved.
• Choose whether to assign category, keyword, entity, and concept as well as the thresholds and taxonomies used for each.

4. Save a Post/Page/CPT or run WP CLI command to batch classify your content

Set Up via OpenAI Embeddings

1. Sign up for OpenAI

• Sign up for an OpenAI account or sign into your existing one.
• If creating a new account, complete the verification process (requires confirming your email and phone number).
• Log into your account and go to the API key page.
• Click Create new secret key and copy the key that is shown.

2. Configure OpenAI API Keys under Tools > ClassifAI > Language Processing > Classification > Settings

• Select OpenAI Embeddings in the provider dropdown.
• Enter your API Key copied from the above step into the API Key field.

3. Enable specific Language Processing features

• Choose to automatically classify content.
• Set the other options as needed.
• Save settings. An error will show if API authentication fails.

4. Edit a content item

• Create one or more terms within the taxonomy (or taxonomies) chosen in settings.
• Create a new piece of content that matches the post type and post status chosen in settings.
• Open the taxonomy panel in the sidebar and see terms that were auto-applied.