vania-janet/multiturn-rag-retrieval-data huggingface dataset:
For the input 958-123-2345, this expression sets $array_of_matched_groups to ["958-123-2345","958","958",null,"123","2345"].

You can then count each value in the array starting with 0 to get the group number for it.



Array elements

 Array element value Array element number 

 958-123-2345 0 
 958 1 
 958 2 
 null 3 
 123 4 
 2345 5 



From the result, you can determine that, to capture the last four digits of the phone number, you need group #5, for example.

To return the JSONArray structure that is created to represent the grouped pattern entity, use the following syntax:



 Variable Value 

 json_matched_groups 



This expression sets $json_matched_groups to the following JSON array:

[
{"group": "group_0","location": 0, 12]},
{"group": "group_1","location": 0, 3]},
{"group": "group_2","location": 0, 3]},
{"group": "group_3"},
{"group": "group_4","location": 4, 7]},
{"group": "group_5","location": 8, 12]}
]

location is a property of an entity that uses a zero-based character offset to indicate where the detected entity value begins and ends in the input text.

If you expect two phone numbers to be supplied in the input, then you can check for two phone numbers. If present, use the following syntax to capture the area code of the second number, for example.



 Variable Value 

 second_areacode 



If the input is I want to change my phone number from 958-234-3456 to 555-456-5678, then $second_areacode equals 555.
Switch to the account that you want to target, and go to the [Account settings](https://cloud.ibm.com/account/settings) page in the console. In the Account section, find the account ID, such as a1b2c3d4e5f61234567890fedcba4321.
2. Go to the console page that you want to bookmark, and add ?bss_account=<account-id> to the URL, replacing <account-id> with the ID from your account. For example,:

/billing/usage?bss_account=a1b2c3d4e5f61234567890fedcba4321
3. Bookmark the URL in your browser.







 Can I make someone else the account owner? 

You can transfer ownership of your entire account, create a support case that requests to make another user in the account the new owner. For more information, see [Transferring ownership of your account](https://cloud.ibm.com/docs/account?topic=account-transfer).





 Can I change the name or IBMid in my profile? 

You can change your personal information, such as name, email, or phone number, by going to the Avatar icon ![Avatar icon](https://cloud.ibm.com/docs-content/v1/content/4d8c6eec891cff72b666dc24bd3211810c77fb42/icons/i-avatar-icon.svg) > Profile and settings in the console. You can't change your IBMid, but you can create a new one if appropriate. The [IBMid worldwide help desk](https://www.ibm.com/ibmid/myibm/help/us/helpdesk.html) is available to help with general ID questions that aren't specific to your IBM Cloud account.





 Can I change my account language? 

The language that is used is based on your web browser settings. To view content in your native language, update your browser's language settings.
<say-as interpret-as="vxml:date">????0720</say-as>
<say-as interpret-as="vxml:date">200507??</say-as>





 vxml:digits 

The vxml:digits value provides the same capabilities as the digits value.





 vxml:phone 

The vxml:phone value speaks a phone number with both digits and punctuation. It is equivalent to using the number value and specifying telephone for the format attribute and punctuation for the detail attribute.

<say-as interpret-as="vxml:phone">555-555-5555</say-as>









 The <speak> element 

The service supports SSML fragments, which are SSML elements that do not include the full XML header. The <speak> element is optional for SSML that you pass to the service.

The <speak> element is the root element for SSML documents. Valid attributes are



* version is a required attribute that specifies the SSML specification. The accepted value is 1.0.
* xml:lang is not required by the service. Omit the attribute when you use this element. Note that you cannot use this attribute to change the language for a speech synthesis request.
* xml:base has no effect.
* xmlns is not required by the service. Omit the attribute when you use this element.



<speak version="1.1">
The text to be spoken.
</speak>





 The <sub> element 

The <sub> element indicates that the text that is specified by the alias attribute is to replace the text that is enclosed within the element when speech is synthesized. The alias attribute is the only attribute of the element and is required.

<sub alias="International Business Machines">IBM</sub>





 The <voice> element 

This <voice> element requests a change in voice. It is not supported.
Select an authentication factor and enter a name. This name is used to identify the authentication factor.



1. For U2F, insert your U2F security stick, and click Register Key.
2. For TOTP, scan the QR code, and enter the code that is generated by your authenticator app.
3. For Email-based, enter the email address where you want to receive the OTPs.



1. Click Send OTP.
2. Enter the OTP that you receive.





4. Click Complete.







 Removing authentication factors 

Remove an authentication factor if you don't have access to it anymore to ensure the security of your account.



1. From the Verification methods and authentication factors page, click Show authentication factors
2. Select an authentication factor.
3. Click Remove.
4. Click Yes to confirm that you want to remove the authentication factors.



You can also enable and disable MFA for your own account on the Verification methods and authentication factors page. Changing the authentication settings for an account impacts all members of the account. By enabling MFA, you can require more secure logins for your account. For more information, see [Enabling MFA in your account](https://cloud.ibm.com/docs/account?topic=account-enablemfa).





 Resetting authentication factors 

You can update or reset your authentication methods if the email address or phone number that you use to authenticate to the IBM Cloud console changes or becomes inaccessible.



1. Go to the [Verification methods and authentication factors](https://iam.cloud.ibm.com/mysecurity) page.
2. Validate your identity with two different verification methods.
3. Click Show accounts.
4. Take note of the Authentication setting for each account.



1. If the account uses MFA for IBMid users, work with the [IBMid help desk](https://www.ibm.com/ibmid/myibm/help/us/helpdesk.html) to reset your authentication factors.
2.
* Two ScalarLists are union or minus compatible regardless of the underlying scalar type.









 Examples 

Example 1: Creating a view with a select or extract statement

In the example below, the view Phone uses an extract statement to prepare its tuples. The view PhoneNumber uses a select statement to pick specific fields from the view Phone.

create view Phone as extract
regexes /+?([1-9]d{2})d{3}-d{4}/
and /+?[Xx].?d{4,5}/
on D.text as num
from Document D;

create view PhoneNumber as
select P.num as num, LeftContextTok(P.num, 3) as lc
from Phone P;

Example 2: Creating a view with Union All statement

The view AllPhoneNums prepares a unionized set out of the tuples of Phone and Extension views. The two views that are being unionized have the same schema.

create view Phone as
extract
regex /+?([1-9]d{2})d{3}-d{4}/
on D.text as match
from Document D;

create view Extension as
extract
regex /+?[Xx].?d{4,5}/
on D.text as match
from Document D;

create view AllPhoneNums as
(select P.match from Phone P)
union all
(select E.match from Extension E);
Show more

Example 3: Creating a view with Minus statement

The following example shows how you can use minus to filter out unwanted tuples from a set of tuples.

create view Organization as
(select * from OrganizationCandidates)
minus
(select * from InvalidOrganizations);

Example 4: Schema compatibility for minus

It is important to note that spans over different target text are not of the same type. Consider the following AQL example that explains this difference by using a String literal.

create view OneString as
select 'a string' as match
from Document D;
* Watch the video about [controlling access by using tags in IBM Cloud](https://cloud.ibm.com/docs/account?topic=account-account_setuptwo-teams-projects) for an overview of how to use access management tags.







 Step 1: Create an access management tag 

Before you can add an access management tag to your Object Storage, you need to create it first.



1. Go to Manage > Account in the IBM Cloud console, and select Tags.
2. Click Access management tags.
3. Enter the name of your tag project:analysis, and click Create tags. See [Tagging rules](https://cloud.ibm.com/docs/account?topic=account-taglimits) for syntax and limitations.



Because tags are visible account-wide, avoid using personal information, such as your name, address, phone number, email address, or other identifying or proprietary information.





 Step 2: Attach your access management tag to a resource 

Now that you created your tag, you can add it to your resource.



1. Click the Navigation menu icon ![Navigation Menu icon](https://cloud.ibm.com/docs-content/v1/content/d4595e5202a9a27767cf034e81b038cdf772e0d5/secure-enterprise/includes/account/includes/icons/icon_hamburger.svg) > Resource List to access the list of resources in your account.
2. Find your IBM Cloud® Object Storage instance and click the Actions icon ![Actions icon](https://cloud.ibm.com/docs-content/v1/content/d4595e5202a9a27767cf034e81b038cdf772e0d5/secure-enterprise/includes/account/includes/icons/action-menu-icon.svg) > Add tags.
3. Type project:analysis and press Enter.







 Step 3: Create an access group 

You'll define the level of access that users have to your Object Storage based on the tags that you previously created.
* Watch the video about [controlling access by using tags in IBM Cloud](https://cloud.ibm.com/docs/account?topic=account-account_setuptwo-teams-projects) for an overview of how to use access management tags.







 Step 1: Create an access management tag 

Before you can add an access management tag to your Object Storage, you need to create it first.



1. Go to Manage > Account in the IBM Cloud console, and select Tags.
2. Click Access management tags.
3. Enter the name of your tag project:analysis, and click Create tags. See [Tagging rules](https://cloud.ibm.com/docs/account?topic=account-taglimits) for syntax and limitations.



Because tags are visible account-wide, avoid using personal information, such as your name, address, phone number, email address, or other identifying or proprietary information.





 Step 2: Attach your access management tag to a resource 

Now that you created your tag, you can add it to your resource.



1. Click the Navigation menu icon ![Navigation Menu icon](https://cloud.ibm.com/docs-content/v1/content/4d8c6eec891cff72b666dc24bd3211810c77fb42/icons/icon_hamburger.svg) > Resource List to access the list of resources in your account.
2. Find your IBM Cloud® Object Storage instance and click the Actions icon ![Actions icon](https://cloud.ibm.com/docs-content/v1/content/4d8c6eec891cff72b666dc24bd3211810c77fb42/icons/action-menu-icon.svg) > Add tags.
3. Type project:analysis and press Enter.







 Step 3: Create an access group 

You'll define the level of access that users have to your Object Storage based on the tags that you previously created. See the following examples for each access level:



* With reader role, users can list and download objects in buckets.
Updating company profile details 

Each IBM Cloud® account includes a company profile that contains company information and details about the primary account holder. You can use data from the company profile when you set up contacts and user profiles. You can have various account-specific contacts that are used in association with services available in the account. If you have administrative access or higher, you can update your company contact information.

This page is not available for some account types. Upgrade to complete your account and access the functions on the Company information page.



  Updating your company profile 

To request an update to the company profile details, go to Manage > Account in the IBM Cloud console, select Company information, and then select Company profile. After you request an update to the company profile, a classic infrastructure team member reviews the request. If any additional information is needed, our team asks for updates by updating the case. The following company profile fields must contain accurate information:



*  Company Name
*  Street Address 1
*  Country
*  State/Province (as needed)
*  City
*  Zip/Postal Code
*  First Name of the primary account holder
*  Last Name of the primary account holder
*  Email address
*  Phone



If your account is for personal use, you can use your first and last name as the Company Name.

IBM Cloud uses the information in the company profile to contact you. If your phone number or email changes, be sure to update them. The company profile information is entered when the account was created.





  Editing a company contact 

Company contacts are created when certain products or services are ordered. For example, when a Regional Internet Registry (RIR) report is requested or a domain is ordered, a company contact is created. To edit a company contact, go to Manage > Account in the console, select Company information, and then select Company contacts. Keep the information about the company contacts complete and up-to-date in case an inquiry is required.

Ensure that the company contacts are the appropriate people to be contacted for each type of request. You might have multiple contact entries for each account, but only one contact for each type of service. Company-specific contact information doesn't include the account profile, which is the primary contact information that is associated with an account.

Verify the information before you make the update. After you submit the new contact information, the company contacts are updated immediately.
curl -X PUT https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/config/cloud_directory/mfa --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Bearer <IAMToken>' -d '"isActive": true'
2. Enable your MFA channel by making a PUT request to the /mfa/channels/<channel> endpoint with your MFA configuration. When isActive is set to true, your MFA channel is enabled.

$ curl -X PUT https://<region>.appid.cloud.ibm.com/management/v4/<tenantID>/mfa/channels/email --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Bearer <IAMToken>' -d '"isActive": true'



If your App ID Cloud Directory instance is configured to work with a custom email sender, then MFA uses the same sender to deliver the one-time code. For more information, see the [Cloud Directory docs](https://cloud.ibm.com/docs/appid?topic=appid-cd-typescd-custom-email).







 Configuring an SMS channel 

You can send an SMS message to your users as a second form of verification. When you enable SMS, App ID automatically tries to register the first [valid](https://en.wikipedia.org/wiki/E.164) primary phone number that is found in a Cloud Directory user's profile. If the number is invalid or no phone number is found on the user's profile, then a registration widget is displayed for the user to add a number. Then, the number is part of the user's profile and after validation, becomes the default number that is used for MFA.

When MFA is initially enabled, it is set to use email by default. You can change the setting to use SMS, but you cannot configure both at the same time.



 Before you begin
[Genesys number plan](https://cloud.ibm.com/docs-content/v1/content/ca9232b3702768f24bb897f48f10778fcda28718/watson-assistant/images/phone-genesys-number-plan.png)
13. Click Outbound Routes. You can either edit the default outbound route or create a new one. Specify the following information:



* In the External Trunks field, click Select External Trunks. Select the trunk you created for Watson Assistant.
* In the Classifications field, add the applicable classifications. This should at least include National and the classification you created for Watson Assistant earlier. (The National route is used only to simulate the call in order to make sure the trunk is operational.)
* Toggle the State switch to Enabled.



![Genesys outbound route](https://cloud.ibm.com/docs-content/v1/content/ca9232b3702768f24bb897f48f10778fcda28718/watson-assistant/images/phone-genesys-outbound-route.png)
14. Click Save Outbound Routes.
15. Go to the Simulate Call tab and click the Simulate Call button. The trunk should be shown as operational. No actual call is made during simulation.

![Genesys simulate call](https://cloud.ibm.com/docs-content/v1/content/ca9232b3702768f24bb897f48f10778fcda28718/watson-assistant/images/phone-genesys-simulate-call.png)
16. Go to Phone Management and click Create new. Specify the following information:



* In the Phone Name field, specify a descriptive name.
* In the Base Settings field, select WebRTCPhone.
* In the Site field, select the site you want to use.
* In the Person field, select yourself.



17.
Connecting with a command-line client 

You can access your Redis database directly from a command-line client. A command-line client allows for direct interaction and monitoring of the data structures that are created within the database. It is also useful for administering and monitoring the keyspace and performance, installing and modifying scripts, and other management activities.

The redli client needs to be [updated for Redis 6](https://github.com/IBM-Cloud/redli/releases) which introduced user management features. If you try to connect to without updating the client, you will see an error like: (error) WRONGPASS invalid username-password pair.



 Connection Strings 

Connection strings are displayed in the Endpoints panel of your deployment's Overview, and can also be retrieved from the [cloud databases CLI plugin](https://cloud.ibm.com/docs/databases-cli-plugin?topic=databases-cli-plugin-cdb-referencedeployment-connections), and the [API](https://cloud.ibm.com/apidocs/cloud-databases-apidiscover-connection-information-for-a-deployment-f-e81026).

The information the clients need to make a connection to your deployment is in the "cli" section of your connection strings. The table contains a breakdown for reference.



 Field Name Index Description 

 Bin The recommended binary to create a connection; in this case it is redli. 
 Composed A formatted command to establish a connection to your deployment. The command combines the Bin executable, Environment variable settings and uses Arguments as command-line parameters. 
 Environment A list of key/values you set as environment variables. 
 Arguments 0... The information that is passed as arguments to the command shown in the Bin field. 
 Certificate Base64 A self-signed certificate that is used to confirm that an application is connecting to the appropriate server. It is base64 encoded. 
 Certificate Name The allocated name for the self-signed certificate. 
 Type The type of package that uses this connection information; in this case cli. 
 {: caption="Table 1.
Connecting with the mongo shell 

You can access your MongoDB database from a command-line client, which allows for direct interaction and monitoring of the data structures that are created within the database. You can use it to query and update data as well as performing administrative operations and monitoring performance.



 Installing 

The mongo shell is available as part of the MongoDB distribution, which can be downloaded from [the MongoDB Download Center](https://www.mongodb.com/download-center/community?jmp=docs).





 Connecting 

Connection strings are displayed in the Endpoints panel of your deployment's Overview, and can also be retrieved from the [cloud databases CLI plugin](https://cloud.ibm.com/docs/databases-cli-plugin?topic=databases-cli-plugin-cdb-referencedeployment-connections), and the [API](https://cloud.ibm.com/apidocs/cloud-databases-apidiscover-connection-information-for-a-deployment-f-e81026).

Zoom

![CLI Endpoints panel](https://cloud.ibm.com/docs-content/v1/content/ec83e0c9f915f4acf715222aaa5b8387c028200c/databases-for-mongodb/images/cli-endpoints-pane.png)

Figure 1. CLI Endpoints panel

The information the mongo shell needs to make a connection to your deployment is in the "cli" section the connection strings. The table contains a breakdown for reference.



Table 1. mongo/cli connection information

 Field Name Index Description 

 Bin The recommended binary to create a connection; in this case it is mongo. 
 Composed A formatted command to establish a connection to your deployment. The command combines the Bin executable, Environment variable settings, and uses 
 Environment A list of key/values you set as environment variables. 
 Arguments 0... The information that is passed as arguments to the command shown in the Bin field.
: You can now change the background of the Preview page to one of your organization's web pages so you can preview and test your assistant from a customer's perspective. For more information, see [Previewing and sharing your assistant](https://cloud.ibm.com/docs/watson-assistant?topic=watson-assistant-preview-share).

Add a type to session variables
: When you create a session variable, you can now assign a type to the variable. For more information, see [Creating a session variable](https://cloud.ibm.com/docs/watson-assistant?topic=watson-assistant-manage-infocreate-session-variable). After a type is assigned to a variable, you can set more explicit conditions on that variable. Previously, you were able to check only whether session variables were defined or not defined. With variable types, you can create conditions based on the type of the variable (for example, account balance < 100 or departure date is after today). For more information, see [Operators](https://cloud.ibm.com/docs/watson-assistant?topic=watson-assistant-step-conditionsoperators).

Create saved customer responses
: You can now create saved customer responses. There might be some questions that your assistant needs to ask in different steps and actions. For example, a banking assistant might have different actions that ask for a customer's account number. Instead of building the same response over and over, you can create a saved customer response and reuse it across steps in multiple actions. For more information, see [Saving and reusing customer responses](https://cloud.ibm.com/docs/watson-assistant?topic=watson-assistant-collect-infosaved-customer-responses).





 13 January 2022 

New setting for options customer response type
: In actions, a new List options setting allows you to enable or disable the options customer response from appearing in a list. This can be useful to prevent a phone integration from reading a long list of options to the customer. As part of this change, all customer response types now have a Settings icon. Allow skipping has moved from Edit Response and is now found in the new settings.