com.ibm.watson.assistant.v2

Class Assistant

java.lang.Object

com.ibm.cloud.sdk.core.service.BaseService

com.ibm.watson.assistant.v2.Assistant

public class Assistant
extends com.ibm.cloud.sdk.core.service.BaseService

The IBM Watson™ Assistant service combines machine learning, natural language understanding, and an integrated dialog editor to create conversation flows between your apps and your users.

The Assistant v2 API provides runtime methods your client application can use to send user input to an assistant and receive a response.

API Version: 2.0 See: https://cloud.ibm.com/docs/assistant

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_SERVICE_NAME
static String	DEFAULT_SERVICE_URL

Fields inherited from class com.ibm.cloud.sdk.core.service.BaseService

PROPNAME_DISABLE_SSL, PROPNAME_ENABLE_GZIP, PROPNAME_ENABLE_RETRIES, PROPNAME_MAX_RETRIES, PROPNAME_RETRY_INTERVAL, PROPNAME_URL

Constructor Summary

Constructors

Constructor and Description
Assistant(String version) Constructs an instance of the `Assistant` client.
Assistant(String version, com.ibm.cloud.sdk.core.security.Authenticator authenticator) Constructs an instance of the `Assistant` client.
Assistant(String version, String serviceName) Constructs an instance of the `Assistant` client.
Assistant(String version, String serviceName, com.ibm.cloud.sdk.core.security.Authenticator authenticator) Constructs an instance of the `Assistant` client.

Method Summary

Modifier and Type	Method and Description
com.ibm.cloud.sdk.core.http.ServiceCall<BulkClassifyResponse>	bulkClassify(BulkClassifyOptions bulkClassifyOptions) Identify intents and entities in multiple user utterances.
com.ibm.cloud.sdk.core.http.ServiceCall<SessionResponse>	createSession(CreateSessionOptions createSessionOptions) Create a session.
com.ibm.cloud.sdk.core.http.ServiceCall<Void>	deleteSession(DeleteSessionOptions deleteSessionOptions) Delete session.
com.ibm.cloud.sdk.core.http.ServiceCall<Void>	deleteUserData(DeleteUserDataOptions deleteUserDataOptions) Delete labeled data.
com.ibm.cloud.sdk.core.http.ServiceCall<Environment>	deployRelease(DeployReleaseOptions deployReleaseOptions) Deploy release.
com.ibm.cloud.sdk.core.http.ServiceCall<Environment>	getEnvironment(GetEnvironmentOptions getEnvironmentOptions) Get environment.
com.ibm.cloud.sdk.core.http.ServiceCall<Release>	getRelease(GetReleaseOptions getReleaseOptions) Get release.
String	getVersion() Gets the version.
com.ibm.cloud.sdk.core.http.ServiceCall<EnvironmentCollection>	listEnvironments(ListEnvironmentsOptions listEnvironmentsOptions) List environments.
com.ibm.cloud.sdk.core.http.ServiceCall<LogCollection>	listLogs(ListLogsOptions listLogsOptions) List log events for an assistant.
com.ibm.cloud.sdk.core.http.ServiceCall<ReleaseCollection>	listReleases(ListReleasesOptions listReleasesOptions) List releases.
com.ibm.cloud.sdk.core.http.ServiceCall<MessageResponse>	message(MessageOptions messageOptions) Send user input to assistant (stateful).
com.ibm.cloud.sdk.core.http.ServiceCall<MessageResponseStateless>	messageStateless(MessageStatelessOptions messageStatelessOptions) Send user input to assistant (stateless).
void	setVersion(String version) Sets the version.

Methods inherited from class com.ibm.cloud.sdk.core.service.BaseService

configureClient, configureService, constructServiceUrl, constructServiceURL, disableRetries, enableGzipCompression, enableRetries, getAuthenticator, getClient, getDefaultHeaders, getEndPoint, getName, getServiceUrl, isJsonMimeType, isJsonPatchMimeType, setClient, setDefaultHeaders, setEndPoint, setServiceUrl, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

DEFAULT_SERVICE_NAME

public static final String DEFAULT_SERVICE_NAME

See Also:

Constant Field Values

DEFAULT_SERVICE_URL

public static final String DEFAULT_SERVICE_URL

See Also:

Constant Field Values

Constructor Detail

Assistant

public Assistant(String version)

Constructs an instance of the `Assistant` client. The default service name is used to configure the client instance.

Parameters:

version - Release date of the API version you want to use. Specify dates in YYYY-MM-DD format. The current version is `2021-11-27`.

Assistant

public Assistant(String version,
                 com.ibm.cloud.sdk.core.security.Authenticator authenticator)

Constructs an instance of the `Assistant` client. The default service name and specified authenticator are used to configure the client instance.

Parameters:

version - Release date of the API version you want to use. Specify dates in YYYY-MM-DD format. The current version is `2021-11-27`.

authenticator - the Authenticator instance to be configured for this client

Assistant

public Assistant(String version,
                 String serviceName)

Constructs an instance of the `Assistant` client. The specified service name is used to configure the client instance.

Parameters:

version - Release date of the API version you want to use. Specify dates in YYYY-MM-DD format. The current version is `2021-11-27`.

serviceName - the service name to be used when configuring the client instance

Assistant

public Assistant(String version,
                 String serviceName,
                 com.ibm.cloud.sdk.core.security.Authenticator authenticator)

Constructs an instance of the `Assistant` client. The specified service name and authenticator are used to configure the client instance.

Parameters:

version - Release date of the API version you want to use. Specify dates in YYYY-MM-DD format. The current version is `2021-11-27`.

serviceName - the service name to be used when configuring the client instance

authenticator - the Authenticator instance to be configured for this client

Method Detail

getVersion

public String getVersion()

Gets the version.

Release date of the API version you want to use. Specify dates in YYYY-MM-DD format. The current version is `2021-11-27`.

Returns:

the version

setVersion

public void setVersion(String version)

Sets the version.

Parameters:

version - the new version

createSession

public com.ibm.cloud.sdk.core.http.ServiceCall<SessionResponse> createSession(CreateSessionOptions createSessionOptions)

Create a session.

Create a new session. A session is used to send user input to a skill and receive responses. It also maintains the state of the conversation. A session persists until it is deleted, or until it times out because of inactivity. (For more information, see the [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-assistant-settings).

Parameters:

createSessionOptions - the CreateSessionOptions containing the options for the call

Returns:

a ServiceCall with a result of type SessionResponse

deleteSession

public com.ibm.cloud.sdk.core.http.ServiceCall<Void> deleteSession(DeleteSessionOptions deleteSessionOptions)

Delete session.

Deletes a session explicitly before it times out. (For more information about the session inactivity timeout, see the [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-assistant-settings)).

Parameters:

deleteSessionOptions - the DeleteSessionOptions containing the options for the call

Returns:

a ServiceCall with a void result

message

public com.ibm.cloud.sdk.core.http.ServiceCall<MessageResponse> message(MessageOptions messageOptions)

Send user input to assistant (stateful).

Send user input to an assistant and receive a response, with conversation state (including context data) stored by Watson Assistant for the duration of the session.

Parameters:

messageOptions - the MessageOptions containing the options for the call

Returns:

a ServiceCall with a result of type MessageResponse

messageStateless

public com.ibm.cloud.sdk.core.http.ServiceCall<MessageResponseStateless> messageStateless(MessageStatelessOptions messageStatelessOptions)

Send user input to assistant (stateless).

Send user input to an assistant and receive a response, with conversation state (including context data) managed by your application.

Parameters:

messageStatelessOptions - the MessageStatelessOptions containing the options for the call

Returns:

a ServiceCall with a result of type MessageResponseStateless

bulkClassify

public com.ibm.cloud.sdk.core.http.ServiceCall<BulkClassifyResponse> bulkClassify(BulkClassifyOptions bulkClassifyOptions)

Identify intents and entities in multiple user utterances.

Send multiple user inputs to a dialog skill in a single request and receive information about the intents and entities recognized in each input. This method is useful for testing and comparing the performance of different skills or skill versions.

This method is available only with Enterprise with Data Isolation plans.

Parameters:

bulkClassifyOptions - the BulkClassifyOptions containing the options for the call

Returns:

a ServiceCall with a result of type BulkClassifyResponse

listLogs

public com.ibm.cloud.sdk.core.http.ServiceCall<LogCollection> listLogs(ListLogsOptions listLogsOptions)

List log events for an assistant.

List the events from the log of an assistant.

This method requires Manager access, and is available only with Enterprise plans.

**Note:** If you use the **cursor** parameter to retrieve results one page at a time, subsequent requests must be no more than 5 minutes apart. Any returned value for the **cursor** parameter becomes invalid after 5 minutes. For more information about using pagination, see [Pagination](#pagination).

Parameters:

listLogsOptions - the ListLogsOptions containing the options for the call

Returns:

a ServiceCall with a result of type LogCollection

deleteUserData

public com.ibm.cloud.sdk.core.http.ServiceCall<Void> deleteUserData(DeleteUserDataOptions deleteUserDataOptions)

Delete labeled data.

Deletes all data associated with a specified customer ID. The method has no effect if no data is associated with the customer ID.

You associate a customer ID with data by passing the `X-Watson-Metadata` header with a request that passes data. For more information about personal data and customer IDs, see [Information security](https://cloud.ibm.com/docs/assistant?topic=assistant-information-security#information-security).

**Note:** This operation is intended only for deleting data associated with a single specific customer, not for deleting data associated with multiple customers or for any other purpose. For more information, see [Labeling and deleting data in Watson Assistant](https://cloud.ibm.com/docs/assistant?topic=assistant-information-security#information-security-gdpr-wa).

Parameters:

deleteUserDataOptions - the DeleteUserDataOptions containing the options for the call

Returns:

a ServiceCall with a void result

listEnvironments

public com.ibm.cloud.sdk.core.http.ServiceCall<EnvironmentCollection> listEnvironments(ListEnvironmentsOptions listEnvironmentsOptions)

List environments.

List the environments associated with an assistant.

Parameters:

listEnvironmentsOptions - the ListEnvironmentsOptions containing the options for the call

Returns:

a ServiceCall with a result of type EnvironmentCollection

getEnvironment

public com.ibm.cloud.sdk.core.http.ServiceCall<Environment> getEnvironment(GetEnvironmentOptions getEnvironmentOptions)

Get environment.

Get information about an environment. For more information about environments, see [Environments](https://cloud.ibm.com/docs/watson-assistant?topic=watson-assistant-publish-overview#environments).

Parameters:

getEnvironmentOptions - the GetEnvironmentOptions containing the options for the call

Returns:

a ServiceCall with a result of type Environment

listReleases

public com.ibm.cloud.sdk.core.http.ServiceCall<ReleaseCollection> listReleases(ListReleasesOptions listReleasesOptions)

List releases.

List the releases associated with an assistant. (In the Watson Assistant user interface, a release is called a *version*.).

Parameters:

listReleasesOptions - the ListReleasesOptions containing the options for the call

Returns:

a ServiceCall with a result of type ReleaseCollection

getRelease

public com.ibm.cloud.sdk.core.http.ServiceCall<Release> getRelease(GetReleaseOptions getReleaseOptions)

Get release.

Get information about a release.

Release data is not available until publishing of the release completes. If publishing is still in progress, you can continue to poll by calling the same request again and checking the value of the **status** property. When processing has completed, the request returns the release data.

Parameters:

getReleaseOptions - the GetReleaseOptions containing the options for the call

Returns:

a ServiceCall with a result of type Release

deployRelease

public com.ibm.cloud.sdk.core.http.ServiceCall<Environment> deployRelease(DeployReleaseOptions deployReleaseOptions)

Deploy release.

Update the environment with the content of the release. All snapshots saved as part of the release become active in the environment.

Parameters:

deployReleaseOptions - the DeployReleaseOptions containing the options for the call

Returns:

a ServiceCall with a result of type Environment