대화형 에이전트 (Dialogflow CX)는 에이전트 디자이너가 고품질 에이전트를 만들 수 있도록 유효성 검사 기능을 제공합니다.
에이전트 유효성 검사는 주문형으로 수행됩니다.
에이전트 수정을 완료하고 NLU 모델을 재학습할 때 Dialogflow 콘솔이나 API에서 에이전트 유효성 검사를 요청할 수 있습니다.
또한 새로운 유효성 검사를 수행하지 않고도 최신 유효성 검사 결과를 쿼리할 수 있습니다.
유효성 검사 결과는 참고용이며,
에이전트의 품질과 성능이 향상되도록 수정할 수 있는 분류된 유효성 검사 메시지 목록을 제공합니다.
에이전트 유효성 검사는 에이전트의 동작에 어떠한 영향도 주지 않습니다.
유효성 검사 메시지를 무시하고 에이전트를 계속 실행할 수 있습니다.
유효성 검사 메시지는 인텐트와 항목 유형을 포함한 NLU 모델 학습 데이터의 품질과 전환 규칙과 같은 페이지 기반 흐름 구조의 품질을 다룹니다.
다음은 유효성 검사 메시지의 예시입니다.
인텐트마다 너무 비슷한 학습 문구가 있습니다.
기본 제외 인텐트의 제외 예시가 없습니다.
이 텍스트가 일부 학습 문구에만 주석 처리되고 다른 학습 문구에는 주석 처리되지 않았습니다.
유효성 검사 메시지를 필터링하려면 유효성 검사 메시지 검색 체크박스에 키워드를 입력합니다. 키워드 앞에 '-' 연산자를 사용하여 유효성 검사 메시지를 필터링합니다. 예를 들면 다음과 같습니다.
'bill'이 포함된 유효성 검사 메시지를 검색하려면 'bill'을 입력합니다.
'bill'이 포함되지 않은 확인 메일을 검색하려면 '-bill'을 입력합니다.
인텐트, 항목, 페이지의 인라인 결과
유효성 검사 메시지는 인텐트 목록, 항목 목록, 페이지 목록에도 표시됩니다.
예를 들어 페이지 목록에 해당 페이지의 유효성 검사 메시지가 있으면 페이지 행에 심각도 수준을 나타내는 아이콘이 표시됩니다.
아이콘 위로 마우스를 가져가면 자세한 유효성 검사 메시지를 보여주는 도움말이 나타납니다.
심각도 수준
유효성 검사는 다음과 같은 심각도 수준을 표시할 수 있습니다.
심각도
설명
INFO
에이전트가 권장사항을 따르지 않습니다.
WARNING
에이전트가 예상대로 작동하지 않을 수 있습니다.
ERROR
에이전트가 실패할 수 있습니다.
제어
유효성 검사 패널에서 심각도 수준이나 유효성 검사 메시지 텍스트를 기준으로 유효성 검사 결과를 필터링할 수 있습니다.
심각도 수준 체크박스를 사용합니다.
검색search 창에 텍스트를 입력합니다.
유효성 검사 패널의 시각적 빌더에 유효성 검사 표시 토글은 유효성 검사 결과가 인텐트, 항목, 페이지의 인라인에 표시되는지 여부를 제어합니다.
[[["이해하기 쉬움","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\u003eAgent validation, available in Conversational Agents (Dialogflow CX), is an on-demand feature that analyzes agent quality and performance, providing a list of classified validation messages for improvement.\u003c/p\u003e\n"],["\u003cp\u003eValidation results are purely informational and do not impact the agent's behavior, allowing developers to ignore messages while still launching the agent.\u003c/p\u003e\n"],["\u003cp\u003eThe validation process examines the quality of NLU model training data (intents and entity types) and the structure of page-based flows, identifying issues like similar training phrases or missing negative examples.\u003c/p\u003e\n"],["\u003cp\u003eValidation results can be accessed via the Dialogflow CX console by navigating to the "Validation" panel under the "Manage" tab, where you can trigger new results and filter messages.\u003c/p\u003e\n"],["\u003cp\u003eValidation messages are shown within the intents, entities, and pages lists with severity level icons (INFO, WARNING, ERROR) and can be filtered by severity or search terms, and inline display can be toggled in the validation panel.\u003c/p\u003e\n"]]],[],null,["# Validation\n\nTo help agent designers create high-quality agents,\nConversational Agents (Dialogflow CX) provides a validation feature.\nAgent validation is performed on-demand.\nYou can request agent validation from either the Dialogflow Console\nor the API when you complete editing your agent\nand retraining the NLU models.\nYou can also query the latest validation results\nwithout performing new validation.\n\nThe validation results are informational only.\nThey provide a list of classified validation messages\nthat you can correct to improve the quality and performance\nof your agent.\nAgent validation does not affect the behavior of an agent in any way.\nYou can ignore the validation messages and still launch your agent.\nThe validation messages cover the quality of the NLU model training data\nincluding the intents and entity types,\nand the quality of the page-based flow structure such as transition rules.\nHere are some example validation messages that you might find:\n\n- Different intents have training phrases which are too similar.\n- There are no negative examples for the default negative intent.\n- This text is annotated in some training phrases but not others.\n- The same synonym is used for different values in an entity type.\n- This intent route condition parameter is not defined.\n- This form parameter is defined with 'sys.any' type.\n\nAccess results\n--------------\n\nTo access the validation results for your agent:\n\n1. Open the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects).\n2. Choose your project.\n3. Select your agent.\n4. Select the **Manage** tab.\n5. Click **Validation** in the **Manage** panel.\n6. Select a flow.\n7. The latest validation results are shown, which may be outdated.\n8. To trigger new results, click the **refresh Refresh** button at the top of the panel.\n9. To trigger new results for one flow only, click **Refresh** in the flow-specific results row.\n10. To filter validation messages, enter a keyword in the **Search validation\n messages** box. Use the \"-\" operator in front of the keyword to filter out the validation messages. Examples:\n - Enter \"bill\" to search validation messages containing \"bill\".\n - Enter \"-bill\" to search validation messages NOT containing \"bill\".\n\n| **Note:** Intent and entity issues will only be updated after NLU training is done.\n\nInline results for intents, entities, and pages\n-----------------------------------------------\n\nValidation messages are also shown in the intents list,\nthe entities list and the pages list.\nFor example, in the pages list, an icon indicating the severity level\nis shown in the page row when there are validation messages for that page.\nA tooltip showing the detailed validation messages appears\nwhen hovering over the icon.\n\nSeverity levels\n---------------\n\nValidation can show the following severity levels:\n\nControls\n--------\n\nFrom the validation panel,\nyou can filter validation results by severity level\nor by searching for validation message text:\n\n- Use the severity level checkboxes.\n- Enter text in the search search box.\n\nThe **Show validation in visual builder** toggle on the validation panel\ncontrols whether validation results are displayed inline\nfor intents, entities, and pages."]]
