[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC)：2025-08-18。"],[[["\u003cp\u003eThis component is designed to collect alphanumeric sequences from users, allowing configuration of minimum and maximum lengths for both the entire sequence and individual chunks.\u003c/p\u003e\n"],["\u003cp\u003eUsers can input sequences in multiple turns, with the component concatenating the chunks until the user indicates completion, and it supports the use of phonetic alphabets like the NATO Phonetic Alphabet.\u003c/p\u003e\n"],["\u003cp\u003eThe component includes features like repeat, waiting room, and playback, enabling users to review and correct the captured sequence before finalizing.\u003c/p\u003e\n"],["\u003cp\u003eThe component handles various scenarios, including single or multiple chunk input, successful and unsuccessful retries, and managing sequences outside the defined length constraints.\u003c/p\u003e\n"],["\u003cp\u003eThe component can be configured via input parameters such as minimum and maximum lengths, and outputs the collected sequence as a string parameter.\u003c/p\u003e\n"]]],[],null,["# Alphanumeric collection prebuilt component\n\nThe alphanumeric collection\n[prebuilt component](/dialogflow/cx/docs/concept/prebuilt-component)\ncollects alphanumeric sequences from the end-user. The minimum and maximum\nlength accepted can be configured via input parameters.\n\nThe component captures chunks of characters from the user on each conversational\nturn and concatenates them to form the final sequence. The minimum and maximum\nlength accepted per chunk can be configured via input parameters.\n\nThe sequence capture will continue until the end-user\nindicates they are done with the sequence with input that matches the\n[prebuilt_components_confirmation_done intent](/dialogflow/cx/docs/concept/prebuilt-component#common-intents).\n\nPhonetic alphabet\n-----------------\n\nThis component supports the use of phonetic alphabets such as the [NATO Phonetic Alphabet](https://en.wikipedia.org/wiki/NATO_phonetic_alphabet).\n\nAdditional functionalities\n--------------------------\n\nThe following additional functionalities are provided by this prebuilt component:\n\n- [Repeat](/dialogflow/cx/docs/concept/prebuilt-component#repeat-functionality)\n- [Waiting room](/dialogflow/cx/docs/concept/prebuilt-component#waiting-room-functionality)\n- [Playback](/dialogflow/cx/docs/concept/prebuilt-component#playback-functionality)\n\nSample dialogs\n--------------\n\nThe following sample dialogs demonstrate common scenarios handled by this\nprebuilt component. The sample dialogs demonstrate behavior when the component is\ncalled via telephony, which triggers the Default Welcome Intent and the first\nagent response at the start of the conversation.\n\n### Single chunk\n\nEnd-user provides an alphanumeric sequence in one chunk and says 'I'm done';\nagent successfully accepts it.\n\n### Multiple chunks\n\nEnd-user provides alphanumeric sequence in 2 chunks; agent successfully accepts it.\n\n### Successful retry\n\nEnd-user provides alphanumeric sequence; agent re-prompts the end-user to\nconfirm it. End-user says 'No' to the confirmation and provides an alphanumeric\nsequence again; agent successfully accepts it.\n\n### Unsuccessful retries\n\nEnd-user is unable to provide an alphanumeric sequence of 1 to 8 characters\nwithin three attempts and the component exits the flow.\n\n### Phonetic alphabet\n\nEnd-user provides alphanumeric sequence; agent re-prompts the end-user to\nconfirm it. End-user says 'No' to the confirmation two consecutive times, the\nphonetic conversion is enabled and the end-user provides an alphanumeric\nsequence again; agent successfully accepts it.\n\n### Invalid sequence length\n\nEnd-user provides alphanumeric sequence with a length that is outside the\npredefined minimum and maximum length of the alphanumeric sequence. Agent\nprompts end-user to start over, the end-user declines, and the component exits\nthe flow.\n\nNaming conventions\n------------------\n\nThis prebuilt component uses the following naming conventions:\n\nInput parameters\n----------------\n\nInput parameters are parameters that are used to configure certain behaviors of\nthe component. The parameters will be used by one or more conditions within the\nflow to determine how the component should behave. Flow-scoped parameters must\nbe set on the start page of the component as described below. Session-scoped\nparameters may be set either by a calling flow, or on the start\npage of this component.\n\nYou can configure the minimum and maximum lengths accepted per capture and for\nthe final collected sequence by modifying\n[parameter presets](/dialogflow/cx/docs/concept/fulfillment#param-preset) in the\n[flow's start page](/dialogflow/cx/docs/concept/flow#data).\n\nThis prebuilt component accepts the following input parameters:\n\n#### To configure the input parameters for this component, expand for instructions.\n\n1. Open the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects).\n2. Choose your Google Cloud project.\n3. Select your agent.\n4. Select the **Build** tab.\n5. Click the imported component in the **Flows** section.\n6. Click the Start Page in the **Pages** section.\n7. Click the **true** Route in the Start Page.\n8. In the Route window, edit the **Parameter Presets** values as needed.\n9. Click **Save**.\n\nOutput parameters\n-----------------\n\nOutput parameters are session parameters that will remain active after exiting\nthe component. These parameters contain important information collected by the\ncomponent. This prebuilt component provides values for the following output\nparameters:\n\nBasic setup\n-----------\n\nTo set up this prebuilt component:\n\n1. [Import the prebuilt component](/dialogflow/cx/docs/concept/prebuilt-component#import).\n\n### Complete\n\nYour agent should now be set up and ready to test."]]
