프로젝트가 VPC 서비스 제어(VPC-SC) 경계 내에 있는 경우 Google에서 호스팅하는 구성요소가 저장된 외부 Google Cloud Storage 버킷에서 사전 빌드된 최신 버전 구성요소를 가져오도록 이그레스 규칙을 추가해야 할 수 있습니다. VPC-SC 규칙이 Google에서 호스팅하는 버킷으로의 이그레스를 차단하는 경우 가져올 때 "Google Cloud Storage URI 'gs://gassets-api-ai/prebuilt_components/cx-standard-prebuilt-components/resource-name'에 액세스하는 동안 권한이 거부됨"이라는 오류 메시지가 표시될 수 있습니다.
가져오기를 사용 설정하려면 Google Cloud Storage 버킷 gs://gassets-api-ai가 포함된 외부 Google Cloud 프로젝트에 액세스할 수 있는 이그레스 규칙을 만들어야 합니다. 다음 속성은 Google 소유 리소스에서 가져오기를 사용 설정하는 데 필요한 리소스와 작업을 설명합니다.
일부 사전 빌드된 구성요소에는 추가 기능이 있습니다.
어떤 기능이 특정 구성요소에 구현되었는지 확인하려면 구성요소별 문서를 참조하세요.
반복 기능
최종 사용자가 가상 에이전트를 해석하기 어렵거나 에이전트의 응답을 놓친 경우 마지막 프롬프트를 반복해 달라고 요청할 수 있습니다.
샘플 발화
뭐라고 하셨어요?
다시 말씀해 주세요.
다시 말씀해 주시겠어요?
죄송합니다.
대기실 기능
최종 사용자가 에이전트에게 돌아가기 전에 시간이 잠깐 필요하여 프롬프트에 즉시 응답하지 않을 경우 가상 에이전트에게 보류를 요청할 수 있습니다.
최종 사용자가 대화를 계속 진행할 준비가 되면 에이전트에 '준비 완료'라고 얘기한 후 대화를 재개할 수 있습니다. 대기실 기능은 대기실 사전 빌드 구성요소를 호출하여 사전 빌드된 일부 구성요소에서 사용 설정됩니다. 사전 빌드된 대기실 구성요소 개요에 설명된 대로 에이전트의 모든 위치에서 대기실 기능을 사용 설정할 수도 있습니다.
샘플 발화
잠시만 기다려 주세요.
조금만 기다려 주세요.
확인해 보겠습니다.
확인 중입니다. 잠시만 기다려 주세요.
이제 준비되었습니다.
재생 기능
최종 사용자가 지금까지 에이전트에서 수집한 내용을 확인하려면 에이전트에게 재생을 요청하면 됩니다. 그러면 에이전트가 현재 캡처된 매개변수를 재생합니다.
샘플 발화
재생
재생하기
재생해 주세요.
다시 읽어 주세요.
공통 인텐트
공통 인텐트는 여러 구성요소에서 일반적인 동작에 사용되는 인텐트입니다.
공통 인텐트
설명
prebuilt_components_confirmation_yes
확인, 동의를 표현하거나 질문이나 요청에 대한 응답으로 진술을 강조하고 증폭시키는 것을 표시하는 데 사용되는 긍정적인 문구
prebuilt_components_confirmation_no
질문이나 요청에 대한 응답으로 반대, 부정 또는 거부를 표현하는 데 사용되는 부정적인 문구
prebuilt_components_confirmation_done
최종 사용자가 태스크나 요청을 완료했음을 표현하는 데 사용되는 문구
prebuilt_components_escalate_human_agent
가상 에이전트가 최종 사용자를 인간 상담사에게 연결하도록 요청하는 데 사용되는 문구
prebuilt_components_start_over
전체 환경을 처음부터 다시 시작하도록 요청하는 데 사용되는 문구
prebuilt_components_playback
최종 사용자가 확인할 수 있도록 현재 수집된 입력을 최종 사용자에게 재생하도록 요청하는 특정 문구
prebuilt_components_replay
이전 프롬프트를 다시 말하도록 요청하는 데 사용되는 문구
prebuilt_components_waiting_room
질문이나 요청에 대한 응답으로 정보를 검토하거나 찾거나 제공하는 데 시간이 필요하다는 점을 표현하는 데 사용되는 문구
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003ePrebuilt components in Conversational Agents (Dialogflow CX) are ready-to-use flows designed for common tasks and scenarios, accelerating agent development.\u003c/p\u003e\n"],["\u003cp\u003eThese components are categorized into "building blocks" for specific parameter collection and "use cases" for larger user journeys, each utilizing intents and entities.\u003c/p\u003e\n"],["\u003cp\u003ePrebuilt component usage may require configuring flexible webhooks for external service integration.\u003c/p\u003e\n"],["\u003cp\u003eImporting prebuilt components involves navigating the Dialogflow CX console and may require adjusting VPC Service Controls egress rules for projects within a perimeter.\u003c/p\u003e\n"],["\u003cp\u003eThere are prebuilt components for numerous functions, such as the collection of data, like names and addresses, and for carrying out tasks like making payments and checking balances.\u003c/p\u003e\n"]]],[],null,["# Prebuilt components overview\n\nPrebuilt components are a collection of prebuilt flows provided by Conversational Agents (Dialogflow CX)\nfor common tasks and scenarios.\nThey can be used to accelerate development for both new and existing agents.\n\nThere are two types of prebuilt components:\n\n- **Building blocks:** components that collect specific parameters, such as name and address\n- **Use cases:** components that represent larger user journeys, like making a payment, which may make use of one or more building blocks\n\nPrebuilt component flows include\n[intents](/dialogflow/cx/docs/concept/intent)\nand\n[entities](/dialogflow/cx/docs/concept/entity)\nthat are ready to use.\nFor components that require integrations with external services,\nyou need to modify the configuration of the\n[flexible webhooks](/dialogflow/cx/docs/concept/webhook#flexible)\nto integrate with the proper endpoints.\n\nThe following building block components are available:\n\n- [Address collection](/dialogflow/cx/docs/concept/prebuilt-component/address-collection)\n- [Alphanumeric collection](/dialogflow/cx/docs/concept/prebuilt-component/alphanumeric-collection)\n- [Credit card CVV collection](/dialogflow/cx/docs/concept/prebuilt-component/credit-card-cvv-collection)\n- [Credit card expiration date collection](/dialogflow/cx/docs/concept/prebuilt-component/credit-card-expiration-date-collection)\n- [Credit card number collection](/dialogflow/cx/docs/concept/prebuilt-component/credit-card-number-collection)\n- [Date of birth collection](/dialogflow/cx/docs/concept/prebuilt-component/date-of-birth-collection)\n- [Feedback](/dialogflow/cx/docs/concept/prebuilt-component/feedback)\n- [Greeting](/dialogflow/cx/docs/concept/prebuilt-component/greeting)\n- [Name collection](/dialogflow/cx/docs/concept/prebuilt-component/name-collection)\n- [Numeric collection](/dialogflow/cx/docs/concept/prebuilt-component/numeric-collection)\n- [Telephone number collection](/dialogflow/cx/docs/concept/prebuilt-component/telephone-number-collection)\n- [Waiting room](/dialogflow/cx/docs/concept/prebuilt-component/waiting-room)\n- [Zip code collection](/dialogflow/cx/docs/concept/prebuilt-component/zip-code-collection)\n\nThe following use case components are available:\n\n- [Account balance](/dialogflow/cx/docs/concept/prebuilt-component/account-balance)\n- [Account statement](/dialogflow/cx/docs/concept/prebuilt-component/account-statement)\n- [Arrange appointment](/dialogflow/cx/docs/concept/prebuilt-component/arrange-appointment)\n- [Authentication](/dialogflow/cx/docs/concept/prebuilt-component/authentication)\n- [Cancel order](/dialogflow/cx/docs/concept/prebuilt-component/cancel-order)\n- [Credit card enrollment](/dialogflow/cx/docs/concept/prebuilt-component/credit-card-enrollment)\n- [Credit card statement](/dialogflow/cx/docs/concept/prebuilt-component/credit-card-statement)\n- [Disputes](/dialogflow/cx/docs/concept/prebuilt-component/disputes)\n- [Exchange order](/dialogflow/cx/docs/concept/prebuilt-component/exchange-order)\n- [Financial services steering](/dialogflow/cx/docs/concept/prebuilt-component/financial-services-steering)\n- [Lock card](/dialogflow/cx/docs/concept/prebuilt-component/lock-card)\n- [Lost and stolen card](/dialogflow/cx/docs/concept/prebuilt-component/lost-stolen-card)\n- [Make a payment](/dialogflow/cx/docs/concept/prebuilt-component/make-a-payment)\n- [Offers and deals](/dialogflow/cx/docs/concept/prebuilt-component/offers-and-deals)\n- [Open account](/dialogflow/cx/docs/concept/prebuilt-component/open-account)\n- [Order status](/dialogflow/cx/docs/concept/prebuilt-component/order-status)\n- [Retail authentication](/dialogflow/cx/docs/concept/prebuilt-component/authentication-retail)\n- [Retail fraud and dispute](/dialogflow/cx/docs/concept/prebuilt-component/fraud-and-dispute-retail)\n- [Return and refund](/dialogflow/cx/docs/concept/prebuilt-component/return-and-refund)\n- [Telecommunications steering](/dialogflow/cx/docs/concept/prebuilt-component/telecommunications-steering)\n- [Transaction history](/dialogflow/cx/docs/concept/prebuilt-component/transaction-history)\n\nLimitations\n-----------\n\nThe following limitations apply:\n\n- Prebuilt components currently only support English (en).\n\nImport a prebuilt component\n---------------------------\n\n| **Note:** If your project is within a [VPC Service Controls (VPC-SC)](/vpc-service-controls/docs/overview) perimeter, you may need to add an egress rule that authorizes traffic out from the VPC-SC perimeter to the Google-owned Google Cloud Storage bucket where the latest versions of prebuilt components are stored. See VPC Service Controls below for instructions.\n\nTo import a prebuilt component to your project:\n\n1. Go to the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects).\n2. Choose your Google Cloud project.\n3. Select your agent or [create a new agent](/dialogflow/cx/docs/concept/agent#create).\n4. Select the **Manage** tab.\n5. Click **Prebuilt** in the **Manage** panel.\n6. Click the component of interest and click **Import as flow**.\n7. Refer to each component-specific documentation to determine whether additional setup for webhook is needed.\n8. Start testing and customizing.\n\n### VPC Service Controls\n\nIf your project is within a VPC Service Controls (VPC-SC)\n[perimeter](/vpc-service-controls/docs/service-perimeters), you\nmay need to add an egress rule to enable import of the latest versions of\nprebuilt components from the external Google-hosted Google Cloud Storage bucket\nwhere they are stored. If your VPC-SC rules prevent egress to the Google-hosted\nbucket, you may see an error message on import that contains \"Permission denied\nwhile accessing Google Cloud Storage URI 'gs://gassets-api-ai/prebuilt_components/cx-standard-prebuilt-components/\u003cvar translate=\"no\"\u003eresource-name\u003c/var\u003e'\".\n\nTo enable import, you will need to [create an egress rule](/vpc-service-controls/docs/configuring-ingress-egress-policies#updating)\nthat allows access to the external Google Cloud project containing the Google\nCloud Storage bucket `gs://gassets-api-ai`. The following attributes describe the\nresource and operations required to enable import from the Google-owned resource:\n\n- **Resource:** `projects/921279757870`\n- **Service Name:** `storage.googleapis.com`\n- **Method:** `google.storage.objects.get`\n\nCustomizations and settings\n---------------------------\n\nTo customize the component and improve settings:\n\n1. Edit agent responses and [custom entities](/dialogflow/cx/docs/concept/entity-custom) to meet your business needs.\n2. For voice agents, the following speech settings are recommended:\n - [Change STT model](/dialogflow/docs/support/troubleshooting#stt-empty-transcripts) to `latest_short`. To see which features are supported by this model for a particular language, check [Speech-to-Text supported languages](/speech-to-text/docs/speech-to-text-supported-languages).\n - Enable [auto speech adaptation](/dialogflow/cx/docs/concept/speech-adaptation).\n3. If you use a telephony integration that allows parameter values extracted from telephone keypad presses, enable [DTMF for telephony integrations](/dialogflow/cx/docs/concept/parameter#dtmf).\n4. [Test the agent](/dialogflow/cx/docs/concept/console#simulator) using the simulator.\n5. To test your component over voice, it is recommended to use [Dialogflow CX Phone Gateway](/dialogflow/cx/docs/concept/integration/phone-gateway).\n\nHandle exit events\n------------------\n\nUpon successful completion of the task, a prebuilt component will exit with the\nEND_FLOW [symbolic transition target](/dialogflow/cx/docs/concept/handler#symbolic).\n\nWhen a prebuilt component isn't able to complete the task,\nthe following events will be emitted for the calling page\nthat caused the transition to the prebuilt component flow.\nIt is a best practice to handle these events in your agent by creating the\ncorresponding [event handlers](/dialogflow/cx/docs/concept/handler#event) in the calling page.\n\nSee [built-in events](/dialogflow/cx/docs/concept/handler#event-built-in):\n\n- flow-cancelled\n- flow-failed\n- flow-failed-human-escalation\n\nAdditional functionalities\n--------------------------\n\nSome prebuilt components have additional functionality.\nSee the component-specific documentation to check which features\nare implemented for a particular component.\n\n### Repeat functionality\n\nIf the end-user has difficulty interpreting the virtual agent\nor missed hearing an agent response,\nthey can ask for the last prompt to be repeated.\n\nSample utterances:\n\n- *What did you just say?*\n- *Say it again.*\n- *Can you please repeat?*\n- *Pardon.*\n\n### Waiting room functionality\n\nIf the end-user wants to take a minute to get back to the agent\nand does not have an immediate answer to a prompt,\nthey can ask the virtual agent to hold.\nWhen the end-user is ready to continue the conversation,\nthey can tell the agent \"I'm ready\" to resume the conversation. The waiting room\nfeature is enabled in some prebuilt components by calling the\nwaiting room prebuilt component. The waiting room feature can also be\nenabled anywhere in the agent by following the setup instructions as\ndescribed in the\n[waiting room prebuilt component overview](/dialogflow/cx/docs/concept/prebuilt-component/waiting-room).\n\nSample utterances:\n\n- *Please wait.*\n- *Wait a second.*\n- *Please hold, let me check.*\n- *I'm checking, wait.*\n- *I'm ready now.*\n\n### Playback functionality\n\nIf the end user wants to know what the agent has collected so far, they can ask\nthe agent to playback. The agent will then play back the currently captured parameter(s).\n\nSample utterances:\n\n- *Playback.*\n- *Play it back.*\n- *Play that back please?*\n- *Read that back to me.*\n\nCommon intents\n--------------\n\nCommon intents are intents that are used for common behaviors\nin multiple components."]]