watson_developer_cloud.conversation_v1 module

The Conversation v1 service (https://www.ibm.com/watson/developercloud/conversation.html)

class ConversationV1(version, url='https://gateway.watsonplatform.net/conversation/api', **kwargs)[source]

Bases: watson_developer_cloud.watson_developer_cloud_service.WatsonDeveloperCloudService

Client for the Conversation service

default_url = 'https://gateway.watsonplatform.net/conversation/api'
latest_version = '2016-09-20'
list_workspaces()[source]

List workspaces available. This includes pagination info.

get_workspace(workspace_id, export=False)[source]

Get a specific workspace :param: workspace_id the guid of the workspace :param: export (optional) return all workspace data

delete_workspace(workspace_id)[source]

Deletes a given workspace. :param: workspace_id the guid of the workspace_id

create_workspace(name, description, language, intents=None, entities=None, dialog_nodes=None, counterexamples=None, metadata=None)[source]

Create a new workspace :param name: Name of the workspace :param description: description of the worksspace :param language: language code :param entities: an array of entities (optional) :param dialog_nodes: an array of dialog notes (optional) :param counterexamples: an array of counterexamples (optional) :param metadata: metadata dictionary (optional)

update_workspace(workspace_id, name=None, description=None, language=None, intents=None, entities=None, dialog_nodes=None, counterexamples=None, metadata=None)[source]

Update an existing workspace :param workspace_id: the guid of the workspace to update :param name: Name of the workspace :param description: description of the worksspace :param language: language code :param entities: an array of entities (optional) :param dialog_nodes: an array of dialog notes (optional) :param counterexamples: an array of counterexamples (optional) :param metadata: metadata dictionary (optional)

message(workspace_id, message_input=None, context=None, entities=None, intents=None, output=None, alternate_intents=False)[source]

Retrieves information about a specific classifier. :param workspace_id: The workspace to use :param message_input: The input, usually containing a text field :param context: The optional context object :param entities: The optional entities :param intents: The optional intents :param alternate_intents: Whether to return more than one intent. :param output: The optional output object