Avaya SAB manuel d'utilisation

A v a y a S p e e c h A p p l i c a t i o n s B u i l d e r C o n f i g u r a t o r U s e r G u i d e M a y 1 5 , 2 0 0 4[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 2 of 116 © 2004 Avaya Inc. All Rights Reserved. Notice While reasonable efforts were made to ensure that the information in this document was complete and accurate at the time of printing, Avaya Inc. can assume no liability for any errors. Changes and corrections to the [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 3 of 116 Canadian Department of Communications (DOC) Interference Information For MCC1, SCC1, G600, and CMC1 Media Gateways: This Class A digital apparatus complies with Canadian ICES- 003. Cet appareil numérique de la classe A est conforme à la norme NMB-003 du Canada.[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 4 of 116 Trademarks Avaya is a trademark of Avaya Inc. Insert all other Avaya Trademarks here, then delete this paragraph. DO NOT include other company’s trademarks. All trademarks identified by the ® or ™ are registered trademarks or trademarks, respectively, of Ava[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 5 of 116 C o n t e n t s Con ten ts ............................................................................................................................................. 5 Abo ut thi s d ocu men t ...................................................................[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 6 of 116 Finding a stored dialog 73 Copying a dialog flow 74 Renaming a dialog flow 75 Migrating a dialog flow 76 Saving a dialog flow 77 Importing a dialog flow from file 79 The Pr omp ts tre e..............................................................................[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 7 of 116 A b o u t t h i s d o c u m e n t This manual describes the Avaya Speech Applications Builder (SAB) Configurator and provides detailed, step-by-step instructions for using its various features to design voice applications. It is divided into the following section[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 8 of 116 S y s t e m r e q u i r e m e n t s The minimum system requirements for running Speech Applications Builder are as follows: Hardware requirements Minimum speed required for platform 500MHz Minimum memory required for platform 512MB RAM Software requirements Speec[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 9 of 116 I n t r o d u c t i o n t o S p e e c h A p p l i c a t i o n s B u i l d e r Some terminology The Speech Applications Builder (SAB) Configurator is a tool for building, testing, deploying and updating voice-driven automated telephone services, such as Telephone [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 10 of 116 The structure of a dialog flow A dialog flow is built by selecting and configuring pre-defined components and connecting them together in a call flow. There are three main types of component: dialogs , processes and rules . An instance of a component is called a[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 11 of 116 Dialog steps Generally speaking, dialog steps handle interactions with the caller. Figure 2 shows a series of dialog steps that • receive the call, setting up variables to store the CLI, DDI, Port, call time and other information • play a welcome message (su[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 12 of 116 SAB rules are boolean. They include • less than, more than, equal to • text handling rules • list handling rules • looping More complex boolean rules can be built using multiple rule components. For example If id = 10 AND name = "Jones” can be bui[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 13 of 116 Triggers may be configured • as part of a flow, in the Trigger Modeler window (see page 62). These triggers are used by default when any triggering event occurs in that flow, if the step in which the event occurs does not specifically handle triggers. • as p[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 14 of 116 Note that some languages have multiple variants or 'locales' (for example, US English, UK English) which are pronounced differently. When you specify a language with multiple locales, ensure that you use the complete language ID, including the correct [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 15 of 116 • SAB is both a development environment and a runtime environment, and provides a formal mechanism for migrating a dialog from the development phase (the tool environment ) to the deployment phase (the production environment ) and then to the decommissioned ph[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 16 of 116 S t a r t i n g S A B The Installation procedure is described in the Speech Applications Builder Installation Guide . To launch SAB: 1. Either double-click on the SAB icon, or select Start > Programs > Avaya Speech Applications Builder Logging in If this i[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 17 of 116 Entering the License Key If this is the first time you have opened the Configurator, SAB asks you to enter a License Key. To enter the License Key: 1 Enter or copy it into the dialog box. Figure 6. License Key dialog box 2 Click OK . Changing your password To ch[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 18 of 116 Exiting SAB To exit SAB, select File > Exit . If you have made unsaved changes to a dialog flow, SAB will ask you if you want to save the dialog flow. Figure 8. Save warning message[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 19 of 116 T h e S A B G U I This chapter provides a brief description of the SAB Graphical User Interface (GUI). The features discussed here are described in more detail at the appropriate places in the remainder of the manual. The SAB GUI consists of • a Menu bar and T[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 20 of 116 The Menu bar The Menu bar provides the following generic functions: Dialog modeler Used to configure the Dialog Modeler display. User preferences Used to change password.. Edit System Preferences See page 105. General preferences Used to configure general featur[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 21 of 116 Add Prompt Used to create a new recorded prompt. See page 82. Import Wave Zip Used to import a zip archive containing recorded prompts. See page 89. Prompt > Create Wave Extract Used to create a zip file that contains prompts. See page 89. The Tool bar The To[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 22 of 116 Dialogs buttons The following buttons are provided when the Dialogs tree is in use. The selection of buttons displayed is relevant to the task being performed. Add a Dialog Model Opens a new dialog flow window complete with Begin Dialog and End Dialog steps. Imp[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 23 of 116 Prompt buttons The following buttons are provided when the Prompts resource is in use. The selection of buttons displayed is relevant to the task being performed. Add (create) a prompt Import a zipped prompt directory. See page 89. Export a zipped prompt directo[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 24 of 116 The Browser The Browser is a tool used to display , search for and manage dialog flows and prompts, import components, and perform system administration. The Browser provides access to four sets of resources, called Dialogs , Prompts , Component Workbench and Ad[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 25 of 116 By default, the dialog flows are displayed in alphabetical order, but you can group and nest them as required by specifying a Classification (see page 34) when you create the dialog flow file. Figure 12. The Dialogs directory structure, showing a dialog flow “[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 26 of 116 Figure 14. The Prompts directory structure, expanded Expanding the Component Workbench opens the Repository Maintenance window, which can be used to import new components. Expanding Administration displays the Configuration, Organization and Permissions options.[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 27 of 116 Thumbnail and zoom facilities When a dialog flow is open in the Dialog Modeler window, the Browser also provides • a thumbnail view of the entire dialog flow, outlining the area that is also displayed in the Dialog Modeler window with a red border Figure 15. T[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 28 of 116 • a “zoomed” view of the dialog flow, which can be scrolled by moving the cursor around the Dialog Modeler window. Figure 16. The Browser “zoomed” view[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 29 of 116 The Dialog Modeler window The Dialog Modeler window (on the right of the Configurator) is a workspace where you can build new dialogs and view or amend existing dialogs. It allows you to build, test, analyze and deploy dialog flows. Figure 17. The Dialog Modeler[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 30 of 116 Worksheet Function Output Data Used to set up the variables and arrays used to pass data out of this sub-dialog flow. See page 68. Global Settings Used to configure certain global recognition parameters, including • barge-in (see Glossary , page 114) • defau[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 31 of 116 When the dialog has been checked out Arrange steps and connections Check repository for updated components If any newer versions are available, SAB gives you the opportunity to update the dialog. Add component Opens the Select Component dialog box, which allows [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 32 of 116 Multiple dialog flow windows Multiple dialog flow windows may be opened in the Dialog Modeler and can be selected • from the list displayed under the Windows option in the Menu bar • from the drop-down list accessed from the blue title bar at the top of the [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 33 of 116 T h e D i a l o g s t r e e Interactions between an automated system and a caller are called dialogs. The software that performs a dialog is called a dialog flow (or a dialog model or, sometimes, a process ). A dialog flow may contain one or more sub-dialog flow[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 34 of 116 Classification The Classification feature is used to build the file directory structure by grouping and nesting dialog flows; for example, the Figure below shows a dialog flow “Main Dialog” that has been classified under “Direct Debit”, which has itself [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 35 of 116 SAB displays the first Add New Dialog dialog box. Figure 22. Add New Dialog 1 2. (Optionally) enter a Classification Path name (see page 34 for an explanation of Classification). You can enter this using one of the following methods: • one level at a time; for[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 36 of 116 It lists the Dialog Model name in the Dialogs tree, and opens a read only version of the new dialog flow, complete with Begin Dialog and End Dialog steps, in the Dialog Modeler window. Figure 23. The Dialog Modeler window (at right hand side)[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 37 of 116 Checking in and out SAB is a multi-user development environment. To prevent more than one developer simultaneously editing a dialog flow, SAB does not allow you to edit a dialog flow until you have checked it out. Figure 24. The read-only warning message While a[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 38 of 116 Checking in To check in a dialog flow: 1. Click on the Check in button on the Tool bar. SAB asks if you want to save the dialog flow before you check it in. Figure 26. Save confirmation message 2. Click Yes to save or No to check in without saving. Note that you[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 39 of 116 Visibility of variables As you build a dialog flow, SAB automatically makes available to the current component all the variables defined in all the previous components in the path. For this reason, the most efficient way to draw a dialog is to add a component, c[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 40 of 116 To direct the search, you can also • compile a list of exclusion criteria by clicking on Add . Figure 29. The Select Component dialog box, showing the Add button (center) SAB displays the Select Categories dialog box. Figure 30. The Select Categories dialog bo[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 41 of 116 Select the categories to be excluded from the search. Multiple categories may be selected by holding down the CTRL key. Click OK . A category can be removed from the Exclude List by selecting it then clicking the Remove button. Avoid unchecking Names, Descriptio[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 42 of 116 3. Click on the second step. In the case of a dialog step, click on the title box. SAB draws the connection, complete with a decision point (the grey diamond shown in the Figure below) that can be used to add a rule to allow branching (see page 64). Figure 32. A[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 43 of 116 Each dialog step must be configured to perform the specific task required by the dialog flow. The majority of dialog steps handle an interaction with the caller and typically perform the following tasks: • Play out an initial prompt; for example, Please select[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 44 of 116 Name and description To begin configuring a component step: 1. Enter a specific name in the Name field (that describes the purpose of the step). 2. Enter a brief description in the Description field. Figure 34. The Edit Step dialog box Prompt To define the main [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 45 of 116 A prompt can be built up from several of these elements; for example: Figure 35. Defining a prompt Dynamic information is formatted (for example, as a date or an amount of money) using variable handlers . Figure 36. A variable token[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 46 of 116 To enable a variable handler: a. Right-click on the variable token (for example, ~Confirmation Value , in the Figure above). The SAB displays a Context menu: click on Edit . The SAB displays the Variable Properties dialogue box Figure 37. The Variable Properties[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 47 of 116 Select the appropriate variable handler. The options include: none - Base64binary Use when playing out a prompt file recorded using a RecordDialogStep . Messages recorded by RecordDialogStep (WAV files) are encoded in base 64 so that they can be stored as XML. T[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 48 of 116 SAB allows you to configure the following recognition parameters: Parameter Description Timeout The Timeout parameter sets the length of silence that must elapse before the recognizer returns a value of No Input . Barge-in The Barge-in parameter specifies the ba[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 49 of 116 Parameter Description Confidence Level Confidence is a floating point value that indicates the perceived accuracy of the recognition result. The Confidence Level parameter sets the accuracy threshold: a recognition result with a confidence value above the thresh[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 50 of 116 Parameter Description Fetch Audio The Fetch Audio parameter specifies the location of the audio clip to be played to cover the delay while waiting for a document to be fetched. The fetching of the audio clip is governed by the values of Audio Fetch Hint and Fetc[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 51 of 116 Confirmation If the caller’s answer requires confirmation select the Confirmation tab and do the following: • define the confirmation prompt as described in the previous step. A confirmation prompt typically has the following format: Typed Variable dragged a[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 52 of 116 • if you want the step to confirm the data it has captured only if the recognition result has a confidence value below a certain threshold, leave the Explicit confirmation box unchecked and set the slider controls to the thresholds you require Figure 41. Setti[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 53 of 116 To set either of these functions, click the appropriate Show Details button. Figure 42. Setting up confirmation handling 3 SAB opens a dialog box; for example, the Confirmation No Match dialog box is shown in the Figure below. • Define the prompt wording. • [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 54 of 116 Note that confirmation is not usually required when the main prompt is a yes-no question, but is often necessary if the caller has provided accurate data, such as a postcode or an amount of money. Speech recognition Components that are designed to recognize a st[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 55 of 116 Other components are designed to capture information specified by the developer. Choices For example, for the Question Dialog Step you must define a set of valid caller responses, with synonyms (alternative words) if appropriate, and SAB uses these to generate a[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 56 of 116 4. To (optionally) enter a synonym, click the Alternatives : Add button. SAB displays the first page of the Attach Values wizard. Figure 47. Attach Values 1 5. Click Next . SAB displays the second page. Figure 48. Attach Values 2 6. Enter the synonym in the Subs[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 57 of 116 7. Repeat from Step 4 to define further synonyms. Once the word or phrase, its DTMF equivalent, and its synonyms are defined, click OK . Figure 49. The Add Value dialog box, showing a valid response SAB displays the option in the Valid Answers field of the Edit [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 58 of 116 To specify the grammar: 1. Open the Edit Step dialog box and select the Grammar Mapping page. Figure 51. The Grammar Mapping page 2. Enter the grammar rule name in the Mapping Grammar Rulename field. 3. Enter the grammar filename in the Mapping Grammar FileName [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 59 of 116 No Input If the caller remains silent, the dialog step plays the prompt that has been defined on the No Input page. For an explanation of prompt levels, see page 53. Figure 53. The No Input page, showing a typical No Input prompt. No Match If the caller says som[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 60 of 116 Misrecognition If the caller disconfirms the recognition result, the dialog step plays the prompt that has been defined on the Misrecognition page. For an explanation of prompt levels, see page 53. Figure 55. The Misrecognition page, showing a typical Misrecogni[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 61 of 116 Setting up or editing a process component Process steps handle data. SAB processes include: • addition, subtraction, multiplication, division, total, exponentiation • check lookup table • capitalize, change case • set variable, copy variable, insert new [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 62 of 116 Setting up a trigger Certain types of event - including loggable events and Java exceptions - can be handled using triggers . These are (typically short) alternative dialog flows that are run when the triggering event occurs. There are five types of trigger: •[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 63 of 116 Step trigger To set up a step trigger: 1. Open the Edit Step dialog box. 2. Select the Edit Step trigger page. 3. Create the trigger as described above. ExceptionFlowControlStep An exception trigger dialog flow must always contain at least one ExceptionFlowContr[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 64 of 116 Adding a rule To define a rule: 1. The order in which you draw the connections between the source step and the steps to be executed is used by SAB to determine how to interpret the rule. First , add a connection between the source step and the step that must be [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 65 of 116 5. Select the component you require, using the search facility (see page 39). Figure 59. The Select Component dialog box 6. Click Use . SAB displays the undefined rule in the Rule Editor dialog box. Figure 60. The undefined rule[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 66 of 116 7. Double click on the rule icon (“less than or equals to” in the Figure above). SAB displays the Edit Rule dialog box. Figure 61. The Edit Rule dialog box 8. The data you will need to enter is rule-specific. As you build a dialog flow, SAB automatically mak[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 67 of 116 4. Click OK . The Interrupt trigger is displayed in the Interrupt Trigger Conditions field. To define another trigger, repeat the process. 5. Click OK . Validating a step The Validate Step tool checks the selected step has been correctly configured. To validate [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 68 of 116 Sub-dialogs A dialog flow can be inserted into another dialog flow as a sub-dialog. Any data to be passed into the sub-dialog from the calling dialog flow must be specified in the Required Data window, and then assigned in the Sub Dialog step; any data to be pas[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 69 of 116 The variable is listed in the Output Data window. Adding a sub-dialog to a dialog flow To add a sub-dialog to a dialog flow: 1. Click on the Add Component button. SAB displays the Select Component dialog box. 2. Select the Dialog Models tab. Figure 65. The Selec[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 70 of 116 To assign the input variables: 1. Double click the Sub-Dialog step. SAB displays the Step Editor, which lists, in the Sub-Process input column of the Input tab, the input variables that you have already specified in the Required Data window. Figure 67. The Sub D[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 71 of 116 6. Click Add Assignment . SAB lists the output variables you have already defined in the Output Data window. Figure 68. The Output Data window 7. Select the variable you require and click Next . 8. Select Add value to folder (add variable) or Replace value in fo[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 72 of 116 9. Do one of the following: • if you have opted to add a variable, enter a variable name • if you have opted to overwrite a variable, select the variable you want to overwrite. 10. Click Finish . Deleting a dialog flow To delete a dialog flow: • Do one of [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 73 of 116 Deleting rules If you use the method described in the previous section to delete a rule, SAB will also delete the connection it lies on. To delete a rule: 1. Double click on the rule. Voice Runner opens the Rule Editor dialog box. 2. Right click on the rule icon[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 74 of 116 6. Click on the version number to open a read-only copy of the dialog flow. Before you can edit a dialog flow, you must check it out, see page 37. Copying a dialog flow Copy with the same version number To copy a dialog flow with the same version number: 1. Righ[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 75 of 116 2. SAB displays a list of dialog flows. Figure 71. The Increments the version of the selected dialog version button dialog box 3. Select the dialog flow you want to copy. Click Next . 4. Select the version number you want to copy. Click Next . 5. Click Finish . [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 76 of 116 Migrating a dialog flow To migrate a dialog flow from the Tool environment to the Production environment: 1. Open the dialog flow. 2. Check the dialog flow out (see page 37). 3. Click on the Migrate button. SAB will ask you to confirm that you want to migrate th[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 77 of 116 Saving a dialog flow By default, dialog flows are saved in the SAB database. However, they can also be exported to an external file (see page 77). Saving a dialog flow to the SAB database To save an open dialog flow: • Do one of the following: o Select Dialog [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 78 of 116 SAB displays the Export Dialog Model dialog box, which lists all the dialogs available. Figure 73. Export Dialog Model dialog box 1 3. Check the Dialog flows you want to export. 4. Click Next . SAB lists the available models of the dialog flows you have selected[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 79 of 116 Single dialog flow To export a single dialog flow: 1. Expand the Dialogs tree. 2. Do one of the following: • Click on the dialog flow, then select Dialog Model > Export the Dialog Model to a File from the Menu bar • Click on the dialog flow, then click th[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 80 of 116 3. (Optionally) enter an new dialog flow name. Figure 76. Change name of imported dialog flow 4. Click Finish . Problems with importing If the .vra file contains out of date components, SAB displays the following warning. Figure 77. Out of date components warnin[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 81 of 116 5. Click Next . SAB displays a table of missing component versions and their possible replacements. Figure 78. Component replacements 6. Click Finish . Step conflict If a component cannot automatically be upgraded to a new equivalent, SAB displays Step Conflict [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 82 of 116 T h e P r o m p t s t r e e Prompts are questions or messages that are played out to the caller as part of an interaction (dialog). Prompts may be created as audio (.wav ) files or as text, which is converted to electronic speech using a Text-To-Speech (TTS) Syn[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 83 of 116 2. (Optionally) enter a classification path name (see page 34 for an explanation of classification). 3. Enter a prompt name. 4. Click Next . Figure 81. Add New Prompt 2 5. Specify the source of the new prompt - an existing file or a new recording. 6. Click Next [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 84 of 116 Specifying an existing file If you have opted to use an existing file, SAB opens a file selection window. Figure 82. Add New Prompt file selector 1. Select the .wav file required. 2. Click Next . Save the prompt (see page 86). Recording a new prompt If you have [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 85 of 116 The following options are provided by the Prompt editor. Load Prompt from File Record Prompt Play Prompt Pause Prompt Stop Prompt Save Prompt to File Remove selected audio Remove all but selected audio Clear To record a prompt: 1. Connect a headset and microphon[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 86 of 116 Saving the prompt To save the prompt, when you have either selected the correct .wav file or are satisfied with the recording: 1. Click Next . SAB displays the final dialog box: Figure 84. Add New Prompt 4 2. Enter the exact text of the prompt you have recorded [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 87 of 116 Searching for a prompt SAB provides a search engine that can be used to search for the prompt you require. To search: 1. Click on the Prompts tree. Voice Runner displays its Prompt Search engine in the Dialog Modeler window. 2. Type the name, or partial name, of[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 88 of 116 Editing a prompt A recorded prompt can be edited; for example a long silence at the start of the prompt can be removed. To edit a prompt: 1. Using the mouse, highlight the section of the prompt to be removed. (Place the cursor at the start of the section, press [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 89 of 116 Exporting and importing prompt files All SAB prompts are stored by default in the SAB database. Saving a prompt to file To save a prompt to file: 1. Open the prompt .wav file 2. Click on the Disk icon. SAB displays a Save dialog box. 3. Browse to the file locati[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 90 of 116 Persona What is persona? A persona is the “personality” one person assigns to another person (real or virtual) based on how he or she looks or sounds, or seems to behave. In the case of an automated telephone service, persona is created by details such as ?[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 91 of 116 Using persona with SAB To implement a persona: 1. Record the prompts using the appropriate voice artist and prompt wording. 2. Create the prompts by specifying an existing file (see page 84). 3. Assign the appropriate persona type (see page 86). SAB then stores [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 92 of 116 T h e C o m p o n e n t W o r k b e n c h The Component Workbench is used to import new SAB components. The components are supplied as a .jar file. Importing components To import new components: 1. Expand the Component Workbench (by clicking on the + sign) in th[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 93 of 116 T h e A d m i n i s t r a t i o n r e s o u r c e The Administration resource is used to manage: • Dialog Configuration, including language and persona • Multiple users • Permissions. Dialog Configuration Generating a .war file For more information about w[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 94 of 116 Figure 91. Dialog deployment war wizard 2 6. Either check the version number you want to deploy or check AutoUpdate. 7. Click Next . Figure 92. Dialog deployment war wizard 3 8. Check the environment you want the war file to run in: • Tool - under construction[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 95 of 116 Figure 93. Dialog deployment war wizard 4 9. Configure the Servlet for the system on which the .war file is to be deployed, as follows: Parameter Description Adaptor style Select the type of voice platform the application will be running on. Audio channel Select[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 96 of 116 Parameter Description Application Server Select correct application server for the voice platform you are using 10. Click Next . Figure 94. Dialog deployment war wizard 5 11. Configure the servlet to use the SAB database. These parameters are initialized to what[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 97 of 116 Parameter Description User This is the SQL username used to authenticate the connection to the repository database. The required value is entirely dependent on how the database itself is configured. The user is set by default to sysdba . Password This is the SQL[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 98 of 116 The new language is listed in the Language tool and will appear as an option in the appropriate Prompt creation dialog box. To remove a language: 1. Open the Language tool (see above). 2. Select the language name. 3. Click on the Remove button. The language is d[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 99 of 116 4. Enter the persona name. 5. Click OK . The new persona is listed in the Persona tool and will appear as an option in the appropriate Prompt creation dialog box. To remove a persona: 1. Open the Persona tool (see above). 2. Select the persona name. 3. Click on [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 100 of 116 D e b u g g i n g a d i a l o g The Speech Applications Builder provides facilities for analyzing and debugging a dialog flow. Dialog Analysis The Dialog Analysis facility lists and describes every path through the selected dialog flow. The data it provides can[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 101 of 116 4. The path descriptions provide the following details: • the Path number • the Step count • the Decision count • Whether the path is potentially recursive • A textual Short Description of the path. 5. To trace a particular path on the process diagram[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 102 of 116 Run/Debug The Run/Debug facility allows you to “run” a dialog, telephone it, and watch the call flow as it happens. You can open an individual dialog step and check its configuration as you hear it being executed. To use the Run/Debug facility: 1. Open the [...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 103 of 116 4. Set up the debugging environment by doing one of the following: • entering the data required (see table below). You can save these settings for future use by clicking on Save Folder Data • reverting to the default settings, by clicking Reset to Default ?[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 104 of 116 Testing To test the dialog: 1. Click Start . 2. SAB prompts you to dial the telephone number allocated to the test. Click OK . 3. Use your telephone to dial the number. 4. Interact with the dialog flow. 5. Click on the Dialog Debugging tab to view the call flow[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 105 of 116 S y s t e m P r e f e r e n c e s Certain features of SAB can be configured by selecting File > System Preferences to display the Edit System Preferences dialog box, which contains three pages: • Dialog Modeler - which is used to configure visual aspects o[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 106 of 116 Show Step Names Enables/disables display of step names Show Decision Labels Enables/disables the display of rule names Modify Long Step Names If step names are being displayed, offers a choice of the following methods of displaying long names: • Display whole[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 107 of 116 General Preferences The General Preferences page presents the following options for configuring the following general aspects of the SAB Configurator: Figure 103. General preferences Confirm Delete Enables/disables request for confirmation before an a dialog mo[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 108 of 116 A p p e n d i x A : C o m p o n e n t L i s t The following components are supplied with the SAB Configurator. For more information about a specific component, see the SAB Components Guide . Component type Name BlockingSayDialogStep CallReceiveDialogStep CallRe[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 109 of 116 Component type Name FixedFormatEmailStep JDBCLookupStep LookupTableProcessStep ModifyMenuChoicesStep Basic PropertiesFileNumericLookupTableStep EndProcess ExceptionFlowControlStep InsertNewVariables InterruptStep PromptLanguage PromptPersona ReRunLastDialogStep[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 110 of 116 Component type Name ReportCallActtivityStep ReportCallEndStep Reporting ReportCallInformationStep CapitalizeAllWords Process (continued) String MakeVariableUppercase BooleanRule DiffGreaterThanVariableRule EqualsVariableRule GreaterThanRule LessThanRule LoopRul[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 111 of 116 Component type Name ICMSendRouteRequestMessageStep SendDeliveredEvent SendEventReport SendNewCall SendRegisterVariables SendRequestInstruction SendRouteEndEvent SendRouteRequestEvent Message (continued) SendRunScriptResult GenerateECCVariableProcessStep GetSing[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 112 of 116 Component type Name WeekDayDialogStep Dialog (continued) Date (continued) YearDialogStep Money MoneyHandler Handler Date DateHandler List Merge/ReplaceStep DumpFolderToLog SessionBeanClient Technical WriteToFileStep GetSystemTimeMillisProcessStep Process Time S[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 113 of 116 A p p e n d i x B : D a t a t y p e s XSD Type Description xsd:boolean Represents boolean values (true or false). xsd:decimal A generic number data type with variable-precision, 64-bit, floating-point number. xsd:double A variable-precision, 64-bit, floating-po[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 114 of 116 G l o s s a r y Barge-in Barge-in allows the caller to interrupt (talk over) a prompt. The system starts listening when the prompt starts playing. When it detects incoming sound it stops the prompt and processes the speech. Barge-in provides a natural-feeling d[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 115 of 116 Environment The “state” of the application. SAB is both a development environment and a runtime environment, and provides a formal mechanism for migrating a dialog from the development phase (the tool environment) to the deployment phase (the production env[...]

Speech Applications Builder Configurator User Guide • May 15, 2004 • page 116 of 116 TTS Text-To-Speech synthesizer. Synthesizes a speech equivalent of text and returns it to SAB to be played out to the caller. Synthesized speech is particularly useful during the development of an application, but for a deployed system many service providers pr[...]