vania-janet/multiturn-rag-retrieval-data huggingface dataset:
: As stated in the [March deprecation notice](https://cloud.ibm.com/docs/assistant?topic=assistant-release-notesMarch2020-deprecation), the @sys-location and @sys-person system entities that were available as a beta feature are deprecated. If you are using one of these system entities in your dialog, a toggle is displayed for the entity on the System entities page. You can [search your dialog](https://cloud.ibm.com/docs/assistant?topic=assistant-dialog-tasksdialog-tasks-search) to find out where you are currently using the entity, and remove it. Consider using a contextual entity to identify references to locations and people instead. After removing the entity from your dialog, disable the entity from the System entities page.





 13 May 2020 

Stateless v2 message API
: The v2 runtime API now supports a new stateless message method. If you have a client application that manages its own state, you can use this new method to take advantage of [many of the benefits](https://medium.com/ibm-watson/the-new-watson-assistant-v2-stateless-api-unlock-enterprise-features-today-2c02a4bbdef5) of the v2 API without the overhead of creating sessions. For more information, see the [API Reference](https://cloud.ibm.com/apidocs/assistant/assistant-v2message-stateless).





 30 April 2020 

Web chat is generally available!
: Add your assistant to your company website as a web chat widget that can help your customers with common questions and tasks. Service desk transfer support continues to be a beta feature. For more information, see [Integrating with your own website](https://cloud.ibm.com/docs/assistant?topic=assistant-deploy-web-chat).

Secure your web chat
: Enable the beta security feature of web chat so that you can verify that messages sent to your assistant come from only your customers and can pass sensitive information to your assistant.





 27 April 2020 

Add personality to your assistant in web chat
[Cognitive News Search App](https://developer.ibm.com/patterns/create-a-cognitive-news-search-app/?cm_sp=Developer-_-code-_-trending_news) Build your own news mining web application using JavaScript, Node.js, and the Watson Discovery service. Use the Watson Node.js SDK to build your news app to search the latest news, find trends, and even integrate it with other applications, such as Slack.



* [Get the Code](https://github.com/IBM/watson-discovery-news/?cm_sp=IBMCode-_-create-a-cognitive-news-search-app-_-Get-the-Code)
* [View the Demo](https://www.youtube.com/watch?v=EZGgvci9nC0&cm_sp=IBMCode-_-create-a-cognitive-news-search-app-_-View-the-Demo)



[Stock Advisor App](https://developer.ibm.com/patterns/create-a-web-app-to-get-stock-information-prices-and-sentiment/?cm_sp=Developer-_-code-_-stock_information) Create an app that uses Watson Discovery, Node.js, and Cloudant NoSQL DB to help you make informed investment decisions. You can then use it as a guide to jump-start your own coding projects.



* [Get the Code](https://github.com/IBM/watson-stock-advisor)
* [View the Demo](https://www.youtube.com/watch?v=uigisF50F8s&feature=youtu.be)



[Cognitive Banking Chatbot](https://developer.ibm.com/patterns/create-cognitive-banking-chatbot/?cm_sp=Developer-_-code-_-banking_chatbot) Create a web UI chatbot using the IBM Watson Node.js SDK to include conversation interaction, anger detection, natural language understanding, and answer discovery. Answers are discovered from a collection of FAQ documents.
If you include multiple response types in a single response, position the option response type last. Otherwise, the output might contain a mix of responses and user inputs that can confuse the user.
* If the options are displayed in a drop-down list, then each option value must be 75 characters or fewer in length. When a list includes 5 or more options, it is displayed in a drop-down list automatically.









 Chatting with the assistant 

To start a chat with the assistant, complete the following steps:



1. Open Slack, and go to the workspace associated with your app.
2. Click the application that you created from the Apps section.
3. Chat with the assistant.



The welcome action is not processed by the Slack integration. The welcome message is not displayed in the Slack channel like it is in the assistant preview. It is not triggered from here because nodes with the welcome special condition are skipped in action flows that are started by users. Slack waits for the user to initiate the conversation.

The action flow for the current session is restarted after 60 minutes of inactivity (5 minutes for Lite and Standard plans). This means that if a user stops interacting with the assistant, after 60 (or 5) minutes, any context variable values that were set during the previous conversation are set to null or back to their default values.
5. Click the Scope tab to select from the available resources in the account that you have access to. The scope determines the data that populates for the selected resources. You can filter the resource by group, tag, and location. Cora wants to select only resources that are related to AI and machine learning, so she filters by the resource group that exists for her team's chatbot project. Not all widgets can be scoped. If a widget can't be scoped, the data for all resources is displayed.
6. Reorganize the layout to fit your needs. Cora moves Notes to the first row, next to Resource summary. In the next row, she includes the Usage, User access, and IBM Cloud status widgets.
7. Click Save dashboard.





 Watch and learn 

The following video provides a demo of the process detailed in the previous step: Your browser does not support the video tag.







 Step 2: Share a dashboard with teammates 

You can share dashboards with users in your account to give them access to view the dashboard. Cora wants to share her custom Management dashboard with her program director so they can talk about resource allocation and the budget for the next year.

To share a dashboard, click the Actions icon ![Action icon](https://cloud.ibm.com/docs-content/v1/content/4d8c6eec891cff72b666dc24bd3211810c77fb42/icons/action-menu-icon.svg), and select Share. After you share it with a user and they click the link, the dashboard is added to their account.

All users with the dashboard link can share the dashboard, which means other users can see the populated data that they have permission to view. If they don’t have the same permissions as the owner, for example, if they don’t have access to Cora’s chatbot resource group, they cannot view that data. Users without permissions to the scoped resources are able to view the dashboard layout, but not the populated data.
With the V2 API and an Enterprise plan, you can use the Segment extension to see what browser was used to send the message. For more information, see [Sending events to Segment](https://cloud.ibm.com/docs/watson-assistant?topic=watson-assistant-segment-add).
* Is it possible to increase the number of intents per skill

No, it is not possible to increase the number of intents per skill.



Watson Assistant for IBM Cloud Pak for Data (Installed)



* What's a...



 Term Definition 

 Assistant Container for your skills. You add skills to an assistant, and then deploy the assistant when you are ready to start helping your customers. [Learn more](https://cloud.ibm.com/docs/assistant-data?topic=assistant-data-assistants). 
 Condition Logic that is defined in the If assistant recognizes section of a dialog node that determines whether the node is processed. The dialog node conditions is equivalent to an If statement in If-Then-Else programming logic. 
 Content catalog A set of prebuilt intents that are categorized by subject, such as customer care. You can add these intents to your skill and start using them immediately. Or you can edit them to complement other intents that you create. [Learn more](https://cloud.ibm.com/docs/assistant-data?topic=assistant-data-catalog). 
 Context variable A variable that you can use to collect information during a conversation, and reference it later in the same conversation. For example, you might want to ask for the customer's name and then address the person by name later on. A context variable is used by the dialog skill. [Learn more](https://cloud.ibm.com/docs/assistant-data?topic=assistant-data-dialog-runtime-contextdialog-runtime-context-variables). 
 Dialog The component where you build the conversation that your assistant has with your customers. For each defined intent, you can author the response your assistant should return.
For more information, see [Creating a search skill](https://cloud.ibm.com/docs/assistant?topic=assistant-skill-search-add).

Integration changes
: The following changes were made to the integrations:



* The name of Preview link integration changed to Preview.
* The Web chat and Preview integrations are no longer added automatically to every new assistant.

The integrations continue to be added to the My first assistant that is generated for you automatically when you first create a new service instance.



Message and log webhooks are generally available
: The premessage, postmessage, and log webhooks are now generally available. For more information about them, see [Webhook overview](https://cloud.ibm.com/docs/assistant?topic=assistant-webhook-overview).





 11 February 2021 

The user_id value is easier to access
: The user_id property is used for billing purposes. Previously, it was available from the context object as follows:



* v2: context.global.system.user_id
* v1: context.metadata.user_id



The property is now specified at the root of the /message request in addition to the context object. The built-in integrations typically set this property for you. If you're using a custom application and don't specify a user_id, the user_id is set to the session_id (v2) or conversation_id(v1) value.

Digression bug fix
: Fixed a bug where digression setting changes that were made to a node with slots were not being saved.





 5 February 2021 

Documentation update
: The phone and SMS with Twilio deployment documentation was updated to include instructions for migrating from Voice Agent with Watson. For more information, see [Integrating with phone](https://cloud.ibm.com/docs/assistant?topic=assistant-deploy-phonedeploy-phone-migrate-from-va) and [Integrating with SMS with Twilio](https://cloud.ibm.com/docs/assistant?topic=assistant-deploy-smsdeploy-sms-migrate-from-va).
: Want a quick way to see how your dialog is doing at responding to customer queries? Enable the new coverage metric to find out. The coverage metric measures the rate at which your dialog is confident that it can address a customer's request per message. For conversations that are not covered, you can review the logs to learn more about what the customer wanted. For the metric to work, you must design your dialog to include an Anything else node that is processed when no other dialog node intents are matched. For more information, see [Graphs and statistics](https://cloud.ibm.com/docs/assistant?topic=assistant-logs-overviewlogs-overview-graphs).

Try out the enhanced intent detection model
: The new model, which is being offered as a beta feature in English-language dialog and actions skills, is faster and more accurate. It combines traditional machine learning, transfer learning, and deep learning techniques in a cohesive model that is highly responsive at run time.





 3 November 2020 

Suggestions are now generally available
: The Suggestions feature that is available for the web chat integration is generally available and is enabled by default when you create a new web chat integration. For more information, see [Showing more suggestions](https://cloud.ibm.com/docs/assistant?topic=assistant-deploy-web-chatdeploy-web-chat-alternate).

New languages supported by the dialog analysis notebook
: The Dialog skill analysis notebook was updated with language support for French, German, Spanish, Czech, Italian, and Portuguese. For more information, see [Analysis notebooks](https://cloud.ibm.com/docs/assistant?topic=assistant-logs-resourceslogs-resources-jupyter-logs).

Visit the learning center!
: Click the Learning center link that is displayed in the header of the skill pages to find helpful product tours. The tours guide you through the steps to follow to complete a range of tasks, from adding your first intent to a dialog skill to enhancing the conversation in an actions skill. The Additional resources page has links to relevant documentation topics and how-to videos. You can search the resource link titles to find what you're looking for quickly.
You do not need to build a custom front-end application and manage the conversation state from one call to the next. However, you can still do so if you want to. See [Adding integrations](https://cloud.ibm.com/docs/assistant?topic=assistant-deploy-integration-add) for more information.
* New major API version: A V2 version of the API is available. This version provides access to methods you can use to interact with an assistant at run time. No more passing context with each API call; the session state is managed for you as part of the assistant layer.



What is presented in the tooling as a dialog skill is effectively a wrapper for a V1 workspace. There are currently no API methods for authoring skills and assistants with the V2 API. However, you can continue to use the V1 API for authoring workspaces. See [API Overview](https://cloud.ibm.com/docs/assistant?topic=assistant-api-overview) for more details.



* Switching data sources: It is now easier to improve the model in one skill with user conversation logs from a different skill. You do not need to rely on deployment IDs, but can simply pick the name of the assistant to which a skill was added and deployed to use its data. See [Improving across assistants](https://cloud.ibm.com/docs/assistant?topic=assistant-logslogs-deploy-id).
* Preview links from London instances: If your service instance is hosted in London, then you must edit the preview link URL. The URL includes a region code for the region where the instance is hosted. Because instances in London are syndicated to Dallas, you must replace the eu-gb reference in the URL with us-south for the preview web page to render properly.







 8 November 2018 

Japanese data center
: You can now create Watson Assistant service instances that are hosted in the Tokyo data center. See [Data centers](https://cloud.ibm.com/docs/assistant?topic=assistant-services-informationservices-information-regions) for more details.





 30 October 2018 

New API authentication process
[Shows the Watson Assistant welcome page](https://cloud.ibm.com/docs-content/v1/content/f16b1f78a92498247223b337bd9303c2758b9ba8/discovery-data/images/tut-convo-assis-intro-2.png)

Figure 1. Watson Assistant welcome page
4. Fill out the fields to share information about you and your assistant, and then click Next.

In the Which statement describes your needs best field, choose I'm using Watson Assistant to complete a course or certification..

Zoom

![Shows the Tell us where your assistant will live page](https://cloud.ibm.com/docs-content/v1/content/f16b1f78a92498247223b337bd9303c2758b9ba8/discovery-data/images/tut-convo-assis-intro-3.png)

Figure 2. Assistant details page
5. When you create an assistant, a web chat application is created for you automatically.

Zoom

![Shows the chat bot style settings](https://cloud.ibm.com/docs-content/v1/content/f16b1f78a92498247223b337bd9303c2758b9ba8/discovery-data/images/tut-convo-assis-intro-4.png)

Figure 3. Web chat settings
6. Click Next to accept the default style for the web chat.

Zoom

![Shows the chat bot preview in a fake web page](https://cloud.ibm.com/docs-content/v1/content/f16b1f78a92498247223b337bd9303c2758b9ba8/discovery-data/images/tut-convo-assis-intro-5.png)

Figure 4. Web chat preview
This documentation is for the classic Watson Assistant experience. To see the documentation for the new Watson Assistant, please go [here](https://cloud.ibm.com/docs/watson-assistant).



 Adding integrations 

To deploy your skill, add it to an assistant, and then add integrations to the assistant that publish your bot to the channels where your customers go for help.



 Add an integration 

Follow these steps to add integrations to your assistant:



1. Click the Assistants icon ![Assistants menu icon](https://cloud.ibm.com/docs-content/v1/content/417db917d18067d9dcc4cf2612564a9a87c3ddc8/assistant/images/nav-ass-icon.png).
2. Click to open the tile for the assistant that you want to deploy.
3. Go to the Integrations section.

Why do I have the Web chat integration? This integration is provisioned and added automatically to your first assistant only.

The web chat is a chat window that you can embed in one or more pages on your website to share your assistant with your customers.
4. Click Add integration.
5. Click the tile for the channel with which you want to integrate the assistant. The options include:



* [Web chat](https://cloud.ibm.com/docs/assistant?topic=assistant-deploy-web-chat)
* [Facebook Messenger](https://cloud.ibm.com/docs/assistant?topic=assistant-deploy-facebook)
* [Slack](https://cloud.ibm.com/docs/assistant?topic=assistant-deploy-slack)
* [Phone](https://cloud.ibm.com/docs/assistant?topic=assistant-deploy-phone)
* [SMS with Twilio](https://cloud.ibm.com/docs/assistant?topic=assistant-deploy-sms)
To set the Carbon theme, use the [carbonTheme](https://web-chat.global.assistant.watson.cloud.ibm.com/docs.html?to=api-configurationoptionscarbonTheme) configuration option.

You can also set individual variables within the theme to customize specific UI elements. For example, the text that is displayed in the chat window uses the fonts IBMPlexSans, Arial, Helvetica, sans-serif. If you want to use a different font, you can specify it by using the [updateCSSVariables()](https://web-chat.global.assistant.watson.cloud.ibm.com/docs.html?to=api-instance-methodsupdatecssvariables) instance method.

Customizing the home screen
: The home screen greets the customer and optionally shows a list of suggested conversation starters. You can customize the style and content of the home screen:



* To add elements to the home screen, you can define custom HTML using the [writeableElements.homeScreenAfterStartersElement](https://web-chat.global.assistant.watson.cloud.ibm.com/docs.html?to=api-instance-methodswriteableelements) theming variable:

instance.writeableElements.homeScreenAfterStartersElement.innerHTML =
'<div class="MyCustomClass">This is my custom element</div>';

![development icon](https://cloud.ibm.com/docs-content/v1/content/ca9232b3702768f24bb897f48f10778fcda28718/watson-assistant/images/development-icon.png)Example: For a working example that shows how to add custom elements to the home screen, see [Home screen custom elements for Watson Assistant web chat](https://github.com/watson-developer-cloud/assistant-toolkit/tree/master/integrations/webchat/examples/home-screen-custom-element).
To create a sandbox, go to the [Twilio Try WhatsApp](https://www.twilio.com/console/sms/whatsapp/learn) web page. An Activate your sandbox prompt is displayed. Agree to have a sandbox created, and confirm your choice.
2. Follow the instructions to create the sandbox.
3. Connect to the sandbox by sending a WhatsApp message from your device to the sandbox phone number.
4. From the Develop tab, click Messaging > Settings > WhatsApp sandbox settings.
5. In the Sandbox Configuration section, paste the webhook URI that you copied earlier into the When a message comes in field. Click Save.
6. You can test the integration by sending a message from WhatsApp to the shared phone number that is assigned to your Twilio sandbox.







 Finish the product integration 

After WhatsApp grants permission for your Twilio phone number or number to access the WhatsApp network, update the integration to use your dedicated Twilio phone number instead of the sandbox number.



1. From the WhatsApp with Twilio integration setup page, scroll to the Webhook section of the Basic setup tab. Copy the value from the WhatsApp webhook field.
2. Go to your Twilio account web page and add the webhook that you copied to the Twilio configuration to complete the connection to the WhatsApp integration in Twilio.







 Give customers fast access to your assistant 

You can add an icon to your web page that customers can click to start a conversation over WhatsApp with your assistant.

To add an icon to your web page, complete the following steps:



1. From the WhatsApp with Twilio integration setup page, click the Click to chat tab.
2. In the Pre-filled message field, add text that you want WhatsApp to send to your assistant on the customer's behalf to get the conversation started.

Specify a message that you know your assistant can answer in a useful way.
3. Copy the Embed link and add it to your web page.
The widget should look similar to the following one:

Zoom

![New widget](https://cloud.ibm.com/docs-content/v1/content/f84e2238288b7f0355715a4c355609ce7ac48fb0/solution-tutorials/images/solution55-openshift-microservices/screen-img-7.png)

New widget
4. Add a gauge that records the debug lines for the patient-health-frontend for the last day.



* Click Add Widget at the top and select Gauge
* Click the newly created widget to reveal the configuration fields for the widget on the right
* In the Data section



* Select the field app, and set the value to patient-health-frontend
* Click Advanced Filtering and in the text box type level:debug
* Keep the Duration set to the default Last 1 day



* In the Appearance section



* In the Label text box type patient-health-frontend





5. Add a table of logs by namespace.



* Click Add Widget at the top and select Table
* Click the newly created widget to reveal the configuration fields for the widget on the right
* In the Data section



* Select the field Group By and choose namespace from the drop down



* In the Data Format section



* Select the field Number of Rows and choose 10 from the drop down





6. Drag the table to improve the presentation. Verify the screen resembles the following:

Zoom

![Another widget](https://cloud.ibm.com/docs-content/v1/content/f84e2238288b7f0355715a4c355609ce7ac48fb0/solution-tutorials/images/solution55-openshift-microservices/screen-img-15.png)

Another widget
7. Save the screen. Select Save Screen.

If you do not save the screen, you lose all your widgets.