cc/td/doc/product/voice/assist/assist1
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Personal Assistant Administration Page Reference

Personal Assistant Administration Page Reference

These topics describe the fields on the pages of the Personal Assistant administrator's interface.

System Configuration

The Personal Assistant System Configuration page displays when you login to the Administration interface or when you select System> System Configuration.

Description

Use the System Configuration page to configure the general Personal Assistant server and speech-recognition server communication parameters.


Table A-1: System Configuration Page
Field Description Notes

Unique User Attribute Name

The field within the directory that is unique for each record. This helps Personal Assistant correctly locate numbers when your users attempt to dial a person by name.

If you are using the Cisco CallManager DC directory as your corporate directory, the unique user attribute name is cn. If you are using a different directory, ask the directory administrator for the unique name.

See the "Understanding How Personal Assistant Uses Directories" section for an explanation of how Personal Assistant uses directories.

Operator Extension

The phone extension of the telephone operator for your organization. Enter a valid extension for a number dialed within your phone network.

For example, if you can reach the operator within your phone network by dialing 5 digits, enter the 5-digit number (for example, 12345).

Personal Assistant might transfer a call to the operator for a variety of reasons, including when a call to Personal Assistant contains more speech-recognition errors than you allow for. You can configure settings that control when a call is transferred to the operator. See the "Dial By Name Configuration" section.

Peer Keep-Alive Interval

The interval, in milliseconds, for which each Personal Assistant server sends keep-alive messages to the other Personal Assistant servers within the cluster. If the other servers in the cluster do not receive a keep-alive message from a server within the expected interval, they assume the server is disabled and take over its calls.

The default is 30000, or 30 seconds. Only change this setting if you find it does not suit your network (for example, disabled servers are not being identified quickly enough, or the cluster is creating too much keep-alive traffic).

Peer TCP Port

The TCP port on which Personal Assistant servers listen for Personal Assistant inter-server communication.

The default is 2000. Only change this if another application on the server is already using this TCP port.

License Code1

The license key for the speech-recognition software. You must enter a valid key to enable speech recognition.

Cisco provides this based on how many speech-recognition license ports you purchased.

Changes to this setting take effect only after refresh.

License Capacity

Indicates maximum number of simultaneous speech ports.

If users complain that they are too frequently routed to touch-tone dialing rather than dial-by-name, consider adding additional speech ports.

Speech Recognition Server Hosts1

A list of the speech servers. This list creates the speech-recognition server cluster.

  • To add a speech-recognition server to the cluster, enter the server's DNS name or IP address in the left edit box and click Add.

  • To remove a speech-recognition server, select it in the right list box, and click Remove.

Use the Control Center to manage which speech servers are active. See the "Control Center" section.

Changes to this setting take effect only after refresh.

Speech Recognition License Manager Hosts1

A list of the speech-recognition license managers. This list identifies which Personal Assistant servers in the cluster will manage the licenses for the speech-recognition server cluster. The speech-recognition servers will not operate without a license manager that has a valid license.

  • To add a license manager to the cluster, enter the associated Personal Assistant server's DNS name or IP address in the left edit box, and click Add.

  • To remove a license manager, select it in the right list box, and click Remove.

Cisco recommends that you identify two license managers. This ensures that a backup is available if one manager is disabled.

Use the Control Center to manage which Personal Assistant servers have active license managers. See the "Control Center" section.

Changes to this setting take effect only after refresh.

Refresh User Information

The schedule for Personal Assistant to update user information from the corporate directory.

Designate the time you desire for Personal Assistant to update its user information. Pick a time when directory updates are complete for the day, and there is reduced user access to Personal Assistant and the directory.

Click Refresh to force Personal Assistant to update user information immediately. You might want to force a refresh if a large number of updates have been made to the directory and Personal Assistant is encountering a large number of speech-recognition errors.

Changes to the corporate directory require Personal Assistant to recompile its speech-recognition grammar and to update various information that is kept in cache, such as telephone numbers for call routing.

The default time is 2:00 a.m. If you do not select a time, Personal Assistant never updates user information unless you click Refresh.

Refresh can take several minutes.

Save button

Click Save to save and activate changes.

1Changes take effect only after a refresh to the server.

Related Topics

Dial By Name Configuration

The Dial By Name page is opened when you select System>Dial By Name.

Description

Use the Dial By Name page to configure the speech-recognition characteristics used when a user dials a number by speaking the name of the party to be called.

Personal Assistant comes preconfigured for dial by name, so you only need to change these settings if you find they do not work well for your organization. You might want to change these settings if there are a large number of similarly named people in your organization, or if accents in your group prevent the speech-recognition software from confidently interpreting their requests. Trial and error is the only effective way to determine whether you need to make changes to these settings to best suit your needs.

If the speech-recognition software has too many problems understanding a caller, the caller is sent to the operator. Select System>Personal Assistant System Configuration to enter the Personal Assistant operator extension.


Table A-2: Dial By Name Configuration Page
Field Description Notes

Max Disambiguate

The number of selections to present the user when more than one party matches the spoken name.

For example, if you enter 3, and the user tries to call John Smith, if there are two or three John Smiths in the directory, Personal Assistant plays the spoken name or extension, allowing the user to choose the correct one.

If more numbers match the spoken name than the Max Disambiguate value, Personal Assistant sends the user to the operator for assistance in reaching the person.

If only one number matches the spoken name, the number is dialed immediately.

The default is 3.

Allow Barge-In

Whether a user can interrupt Personal Assistant's prompts before they are finished. If you select true, a user can enter commands in the middle of a Personal Assistant prompt. If you select false, users must always wait until Personal Assistant finishes speaking.

The default setting is true.

Use caution in disabling this feature. Typically, you should not disable it unless there is excessive background noise at the users' locations.

Rejection Confidence Level

The percentage confidence level below which the user's request is rejected. Personal Assistant tells the user that the request could not be understood. The user can then repeat the request or try phrasing it differently.

The speech-recognition software assigns a percentage confidence level to every session. If the software is less than the Rejection Confidence Level, Personal Assistant tells the user that the request could not be understood. The user can then repeat the request or try phrasing it differently.

The default is 50. Do not include the percentage sign in the field.

Reconfirm Confidence Level

The percentage confidence level below which the user is asked to confirm the speech-recognition software's interpretation of the request.

If the software's confidence level is between the Rejection Confidence Level and the Reconfirm Confidence Level, Personal Assistant tells the speaker its interpretation of the request and asks the speaker to confirm the interpretation.

If the speech-recognition software's confidence level is higher than the Reconfirm Confidence Level, Personal Assistant completes the speaker's request without asking for confirmation. However, the speaker can tell Personal Assistant to cancel or stop the action.

If you set this level too high, users will have to reconfirm most commands. If you set it too low, Personal Assistant might perform too many unintended tasks.

The default is 60. Do not include the percentage sign in the field.

Max Error Count

The maximum number of speech-recognition errors allowed in a single dialog. One user session with Personal Assistant consists of several dialogs; for example, the attempt to dial a person would be a single dialog.

If the user exceeds this error count, Personal Assistant transfers the user to the operator.

Max Total Error Count

The maximum number of speech-recognition errors allowed in an entire Personal Assistant session (that is, the sum of errors in each dialog).

If the user exceeds this error count, Personal Assistant transfers the user to the operator.

The Max Total Error Count must be larger than Max Error Count.

Max Help Count

The maximum number of times the user can ask Personal Assistant for help within a single dialog.

If the user asks for help more times than this number, Personal Assistant transfers the user to the operator.

When a user asks for help, Personal Assistant tells the user the various actions the user can perform at that point in the dialog.

Max Total Help Count

The maximum number of times the user can ask Personal Assistant for help in an entire Personal Assistant session.

If the user asks for help more times than this number, Personal Assistant transfers the user to the operator.

The Max Total Help Count must be larger than Max Help Count.

Save button

Click Save to save and activate changes.

Related Topics

Voice Mail Configuration

The Voice Mail page is opened when you select System>Voice Mail.

Description

Use the Voice Mail page to configure Personal Assistant's connection to and use of the voice mail system.


Table A-3: Voice Mail Configuration Page
Field Description Notes

Rejection Confidence Level

The percentage confidence level below which the user's request is rejected.

The speech-recognition software assigns a percentage confidence level to every recognized utterance. If this is less than the Confidence Level, Personal Assistant tells the user that the request could not be understood. The user can then repeat the request or try phrasing it differently.

The default is 45.

Enter a number from 0 to 100; do not include a percentage sign.

Reconfirm Confidence Level

The percentage confidence level below which the user is asked to confirm the speech-recognition software's interpretation of the request.

If the software's confidence level is between the Confidence Level and the High Confidence Level percentage, Personal Assistant tells the speaker its interpretation of the request and asks the speaker to confirm the interpretation.

The default is 70.

Enter a number from 0 to 100; do not include a percentage sign.

If the speech-recognition software's confidence level is higher than the level you specify, Personal Assistant initiates the speaker's request without asking for confirmation.

Max Error Count

The maximum number of speech-recognition errors allowed in a single dialog while accessing voice mail. One user session with voice mail consists of several dialogs; for example, the attempt to listen to a particular voice mail counts as one dialog.

If the user exceeds this error count, Personal Assistant transfers the user to the operator.

The default setting is 4.

The error count and help count settings on this page only apply to the dialogs between the user and the voice mail system. They are not included in the error and help counts used for the rest of the Personal Assistant conversation; see the "Dial By Name Configuration" section.

Max Total Error Count

The maximum number of speech-recognition errors allowed in an entire voice mail session (that is, the sum of errors in each dialog).

If the user exceeds this error count, Personal Assistant transfers the user to the operator.

The default setting is 40.

The Voice Mail Max Total Error Count must be larger than the Voice Mail Max Error Count.

Max Help Count

The maximum number of times the user can ask the voice mail system for help within a single dialog.

If the user asks for help more times than this number, Personal Assistant transfers the user to the operator.

The default setting is 5.

When a user asks for help, voice mail tells the user the various actions the user can perform at that point in the dialog.

Max Total Help Count

The maximum number of times the user can ask voice mail for help in an entire voice mail session.

If the user asks for help more times than this number, Personal Assistant transfers the user to the operator.

The default setting is 20.

The Voice Mail Max Total Help Count must be larger than Voice Mail Max Help Count.

Voicemail Server

The DNS name or IP address of the voice mail server.

Voicemail Number

The telephone extension used to access the voice mail system.

Voicemail Server LDAP Port

The LDAP port that the voice mail system uses. This field is configured to use the default LDAP port for the voice mail system. You only need to update the field if you are using a different port than the default (which is 2015).

Personal Assistant needs to know this port so that it can access user information on the Exchange server of the voice mail system.

Voicemail Ports

The number of licensed voicemail ports on the Cisco Unity server, which indicates the maximum number of simultaneous voice mail sessions in Personal Assistant.

You must determine the number of ports on the Cisco Unity system and enter this value for Personal Assistant.

The default setting is 2.

Save button

Click Save to save and activate your changes.

Related Topics

JTAPI Configuration

The Telephony page is opened when you select System>Telephony.

Description

Use the Telephony page to configure the connection between Personal Assistant and Cisco CallManager.


Table A-4: JTAPI Configuration Page
Field Description Notes

JTAPI Provider Name

The DNS name or IP address of the Cisco CallManager server.

JTAPI User Name

A CTI user name, as defined in Cisco CallManager, that Personal Assistant will use to access the Cisco CallManager system.

In Cisco CallManager, you must associate the Personal Assistant devices and ports with this user name, so that Personal Assistant can control the CTI route points.

JTAPI Password

The password for the Personal Assistant JTAPI user name.

The password appears as asterisks (**) to ensure security.

Call Pickup Timeout

The time, in milliseconds, that the receiver of a call is allotted to answer a call when Personal Assistant is processing a rule that requires Personal Assistant to ring a series of phone numbers.

If the call is not answered within the timeout window, Personal Assistant rings the next phone number as defined in the rule.

Save button

Click Save to save and activate your changes.

Related Topics

Messaging Configuration

The Messaging page is opened when you select System>Messaging.

Description

Use the Messaging page to enable paging and calendar-based dial rule processing.


Table A-5: Messaging Configuration Page
Field Description Notes

Calendar Server Name

DNS or IP address of the Microsoft Exchange Server.

Calendar Mailbox Name

First name and last name of the administrator account on the Microsoft Exchange server.

Paging SMTP Server Name

The DNS name or IP address of the e-mail paging server. Personal Assistant uses this server to send e-mail pages to users who configure an e-mail paging address and define rules that use the address.

Paging SMTP Server Port

The SMTP port used to send messages to the SMTP server.

The default setting is 25.

Paging SMTP Domain Name

The domain to which the paging SMTP server belongs.

Save button

Click Save to save and activate your changes.

Related Topics

Dial Rules Configuration

The Dial Rules page is opened when you select System>Dial Rules.

Description

Use the Dial Rules page to create global dialing rules. These rules can help you automatically strip numbers from or add numbers to telephone numbers that your users dial. For example, you could automatically add 9 in front of seven-digit numbers to permit users to access an outside line. These rules are applied when a user is dialing a number through Personal Assistant, or to incoming calls.


Table A-6: Dial Rules Configuration Page
Field Description

Add Rule

The section at the top of the page, which contains a fill-in-the-blanks sentence, where you can create a new dialing rule. Fill in the necessary blanks (you do not have to fill in every blank) and click Add Rule.

A rule is only applied to a dialed number if all the conditions are met.

The available conditions are:

  • If the phone number begins with blank—This is one or more digits at the beginning of the number the user dialed. For example, if you enter 1, 1500, or 1500555, each would match the dialed number 1-500-555-6262.

  • and the number of digits is blank—The total number of digits in the telephone number your user dialed. For example, if the user dials 9-1-500-555-6262, the number of digits is 12.

The available actions are:

  • then remove blank digits from the beginning—Personal Assistant should delete this number of digits from the front of the dialed number. For example, if you specify 4, and the dialed number is 1-500-555-6262, 1500 is removed, leaving 555-6262.

  • and prefix it with blank—After removing the specified number of digits, this string of numbers is added to the front of the dialed number. For example, adding a 9 to dial an external number.

List of Rules section

An ordered list of the rules you have created. The rules are applied top to bottom, and the first rule that matches the dialed number is applied. Once a rule is applied, no subsequent rules are processed. You can modify, rearrange their priority, or delete rules:

  • To modify a rule, change the rule and click Update.

  • Click the up or down arrows to move the rule within the list, changing its priority.

  • Click the trash icon to remove a rule.

Related Topics

Server Configuration

The Server Configuration page is opened when you select Server.

Description

Use the Server Settings page to add Personal Assistant servers to the Personal Assistant server cluster and configure them. These settings determine which user telephone extensions are assigned to each server, as well as how the server manages its resources.


Table A-7: Server Configuration Page
Field Description Notes

Server List

A list of the Personal Assistant servers that you have inserted into the Personal Assistant server cluster (shown in the left column).

Click a server to view or change its configuration.

Insert button

Click Insert, after filling in the fields, to add the Personal Assistant server to the server cluster.

The Insert button only appears when you first enter the Server page, or when you click the New button.

New button

Click New to add a new Personal Assistant server to the cluster. If the New button is not displayed on the page (and the Insert button is displayed), then you can add a server without first clicking New.

The New button only appears if you click on a server in the Personal Assistant server list (left column).

Save button

Click Save to save and activate your changes.

The Save button only appears if you click on a server in the Personal Assistant server list (left column).

Delete button

Click Delete when viewing the configuration of a Personal Assistant server that you want to remove from the server cluster. You must click on the server you want to delete, in the server list, before you can delete it.

The Delete button only appears if you click on a server in the Personal Assistant server list (left column).

Server Name

A unique name for the Personal Assistant server. This is not the same as the server's DNS name or IP address. It is a name that Personal Assistant uses internally for identifying the server.

The name must be unique within the Personal Assistant cluster. Choose a naming convention that is meaningful to you.

Hostname or IP Address

The DNS name or IP address of the Personal Assistant server.

Media Term UDP Port Begin

The start of the range of UDP ports that the Personal Assistant server will use for telephone calls. The number should be even: Personal Assistant will only use even port numbers. For example, if you use 32000 as the starting port, Personal Assistant will use ports 32000, 32002, 32004, and so forth.

The number of UDP ports used is based on the Personal Assistant Number of Telephony Ports setting.

Route Address

The telephone extension for the Personal Assistant server, which you must defined as a CTI route point in Cisco CallManager.

Users call this number to reach Personal Assistant.

If you are using more than one Personal Assistant server, you should consider configuring the "call forward busy" and "call forward" no answer extensions for the CTI route point to use the number of another Personal Assistant server. This ensures that a user can reach Personal Assistant even if the server the user calls is busy. See the "Setting Up Personal Assistant Server Load Balancing" section.

Telephony Port Begin Address

The start of the range of ports that will be used to terminate calls to Personal Assistant. When Personal Assistant answers a call, it is assigned to an available port in this range.

The number of telephony ports used is based on the Personal Assistant Number of Telephony Ports setting.

Number of Media Ports

The number of ports available for user calls. The number you select must be based on how you have installed Personal Assistant, the hardware platform you are using, and whether you are configuring failover for the server (see the "Fail-over Server Names" section setting).

See the "Creating Server Clusters" section for information about the maximum available ports for the various hardware platforms and installation configurations.

For example, if you enter 12, Personal Assistant can handle 12 simultaneous calls with users. If the server fails, and you have configured a failover server, the failover server must be able to take on 12 additional ports.

Interceptor Port Range

The telephone extensions of the users that are using Personal Assistant. You can specify individual extensions or a range of extensions. For example, 55500-55599 will transfer calls that come in to extensions 55500, 55501, 55502, and so forth to 55599, to Personal Assistant instead of to the regular telephone assigned the extension. Calls are directed to Personal Assistant so that the users' call-routing rules can be evaluated for incoming calls.

If you are using more than one Personal Assistant server, you should divide the supported extensions among the Personal Assistant servers.

  • To add an extension or range of extensions, enter it or them in the edit box and click Add.

  • To remove an extension or range, select it in the list box and click Remove.

Configuring an extension for Personal Assistant Interceptor Route Range is not enough to get a user's calls transferred to Personal Assistant. In Cisco CallManager, you must also update the partitions and calling search spaces. See the "Defining Partitions and Call Search Spaces for Personal Assistant" section and the "Setting Up Personal Assistant to Intercept Calls" section for more details.

Fail-over Server Names

A list of Personal Assistant servers that can take over for a server if it fails.

  • To add a failover server, enter the server's Personal Assistant name in the edit box and click Add. You must use the Personal Assistant's name for the server (the name that appears in the left column); do not use the server's DNS name or IP address.

  • To remove a server, select it in the list box, and click Remove.

Establishing failover servers requires careful planning. If you specify failover servers, your Personal Assistant servers must have enough available ports to take over for a failed server. See the "Creating Server Clusters" section and the "Creating Server Clusters" section.

Debug Package List

A selection of subsystems for which you need to collect detailed debug information. Debug information includes trace messages as well as more detailed messages. Only select subsystems at the request of Cisco Technical Support; the debug information is for Cisco's use to help resolve problems that you cannot solve yourself.

See the "Collecting Trace and Debug Information" section for an explanation of each field.

Trace Package List

A selection of subsystems for which you need to collect brief trace information. Only select subsystems at the request of Cisco Technical Support; the trace information is for Cisco's use to help resolve problems that you cannot solve yourself.

If you select a subsystem for debug, you do not have to select it for trace.

See the "Collecting Trace and Debug Information" section for an explanation of each field.

Related Topics

Control Center

The Control Center page is opened when you select System>Control Center.

Description

Use the Control Center page to start and stop the major services on the servers within the Personal Assistant and speech-recognition server clusters.


Table A-8: Control Center Page
Field Description Notes

Server Control

Controls the status of the Personal Assistant server service on the listed system. A server is started if there is an arrow icon beside it; it is stopped if there is a square icon beside it.

  • To start the servers on all listed systems, click the Start All button for the server group.

  • To stop the Personal Assistant servers on all listed systems, click the Stop All button for the Personal Assistant server group.

  • To start an individual Personal Assistant server, click the Start button on the same line as the server name.

  • To stop an individual Personal Assistant server, click the Stop button on the same line as the server name.

A change to the status of the Personal Assistant server does not change the status of a license manager or resource manager on the same system.

When you stop a server, the other servers in the cluster automatically take over the responsibilities of the stopped server.

Speech Server Control

Controls the status of the speech server service on the listed system. A server is started if there is an arrow icon beside it; it is stopped if there is a square icon beside it.

  • To start the speech servers on all listed systems, click the Start All button for the speech server group.

  • To stop the speech servers on all listed systems, click the Stop All button for the speech server group.

  • To start an individual speech server, click the Start button on the same line as the server name.

  • To stop an individual speech server, click the Stop button on the same line as the server name.

When you stop a server, the other servers in the cluster automatically take over the responsibilities of the stopped server.

License Manager Control

Controls the status of the license manager service on the listed system. A license manager is started if there is an arrow icon beside it; it is stopped if there is a square icon beside it.

  • To start the license managers on all listed systems, click the Start All button for the license manager group.

  • To stop the license managers on all listed systems, click the Stop All button for the license manager group.

  • To start an individual license manager, click the Start button on the same line as the server name.

  • To stop an individual license manager, click the Stop button on the same line as the server name.

The license manager controls how many simultaneous speech requests can be handled.

Related Topics


hometocprevnextglossaryfeedbacksearchhelp
Posted: Thu May 3 12:03:48 PDT 2001
All contents are Copyright © 1992--2001 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.