노드 추가

• 노드의 용도를 설명하는 노드 이름을 추가하십시오.

  지금은 이 노드가 어떤 작업을 수행하는지 알지만, 몇 달이 지나면 기억이 나지 않을 수도 있습니다. 노드 이름이 로그에 표시되고 이는 나중에 대화를 디버그할 때 도움이 될 수 있습니다.

• 태스크를 완료하는 데 필요한 정보를 수집하려면 여러 개의 개별 노드 대신 슬롯이 있는 노드를 사용하여 사용자로부터 정보를 요청하십시오. 슬롯을 사용하여 정보 수집을 참조하십시오.

• 복잡한 프로세스 플로우의 경우 사용자에게 프로세스 시작 시 제공해야 하는 정보에 대해 알려주십시오.

• 어시스턴트가 대화 트리를 통해 이동하는 방법 및 해당 폴더, 분기, 점프 및 다이그레션이 경로에 미치는 영향을 이해하십시오. 대화 플로우를 참조하십시오.

• 모든 곳에 점프를 추가하지는 마십시오. 그럴 경우, 대화 플로우의 복잡도가 증가하고 나중에 대화를 디버그하기 어렵습니다.

• 현재 노드와 동일한 분기에서 노드로 점프하려면 점프 대신 사용자 입력 건너뛰기를 사용하십시오.

  이 옵션을 선택하면 점프되는 하위 노드를 제거하거나 다시 정렬할 때 현재 노드의 설정을 편집할 필요가 없습니다. 다음에 수행할 작업 정의를 참조하십시오.

• 노드로부터의 다이그레션(digression)을 사용으로 설정하기 전에, 가장 일반적인 사용자 시나리오를 테스트하십시오. 다이그레션(digression) 대상 노드가 돌아가도록 구성되었는지 확인하십시오. 다이그레션(digression)을 참조하십시오.

응답 추가

• 답변은 짧고 유용하게 하십시오.

• 응답에 사용자 인텐트를 반영하십시오.

  이렇게 하면 봇이 자신을 이해했다고 사용자가 확신하게 되며, 그렇지 않은 경우에는 오해를 즉시 정정할 수 있는 기회를 사용자에게 제공합니다.

• 응답이 자주 변경되는 데이터에 따라 달라지는 경우 응답에 외부 사이트에 대한 링크를 포함하십시오.

• 지나치게 많은 버튼을 사용하지 마십시오. 사용자가 단추 세트에서 사전 정의된 옵션을 선택하도록 권장하는 것은 실제 대화와 같지 않으며 사용자가 실제로 수행할 작업을 배울 수 있는 능력을 감소시키는 것입니다. 사용자들이 자신들의 단어로 요청하도록 할 때 해당 입력을 사용하여 시스템을 훈련하고 더 나은 인텐트를 이끌어낼 수 있습니다.

• 하나의 노드가 충분한 경우에는 노드 모음을 사용하지 마십시오. 예를 들어, 다중 조건부 응답을 단일 노드에 추가하여 사용자가 제공한 세부사항에 따라 다른 응답을 리턴합니다. 조건부 응답을 참조하십시오.

• 당신의 반응을 조심스럽게 말로 표현하십시오. 응답을 표현하는 방법에 따라 시스템에 반응하는 방법을 변경할 수 있습니다. 한 행의 텍스트를 변경하여 복잡한 프로그램 솔루션을 구현하기 위해 다중 행의 코드를 작성하지 않아도 될 수 있습니다.

사용자 입력에서 정보를 캡처하기 위한 팁

사용자 입력에서 찾으려는 정보를 정확하게 캡처하기 위해 대화 노드에서 사용할 구문을 알기 어려울 수 있습니다. 다음은 공통 목표를 해결하는 데 사용할 수 있는 몇 가지 접근 방식입니다.

• 사용자 입력 리턴: 사용자가 입력한 정확한 텍스트를 캡처하여 응답으로 리턴할 수 있습니다. 응답에서 다음과 같은 SpEL 표현식을 사용하여 사용자가 응답에 다시 지정한 텍스트를 반복하십시오.

  You said: <? input.text ?>.

  자동 정정이 설정되어 있고 정정되기 전에 사용자의 원래 입력을 리턴하려는 경우 <? input.original_text ?> 사용이 가능합니다. 하지만 original_text 필드가 존재하는지를 확인하는 응답 조건을 먼저 사용해야 합니다.

• 사용자 입력의 단어 수 결정: input.text 오브젝트에 대해 지원되는 String 메소드를 수행할 수 있습니다. 예를 들어, 다음과 같은 SpEL 표현식을 사용하여 사용자 발화에 얼마나 많은 단어가 있는지 알 수 있습니다.

  input.text.split(' ').size()

• 여러 인텐트 처리: 사용자가 두 개의 개별 태스크를 표현하는 입력을 입력합니다. I want to open a savings account and apply for a credit card. 어떻게 대화가 이 두 가지를 인식하고 처리합니까? 복합 질문 블로그 항목을 참조하십시오.

• 모호한 인텐트 처리: 사용자가 어시스턴트가 잠재적으로 이를 처리할 수 있는 인텐트가 있는 둘 이상의 노드를 찾을 수 있을 정도로 모호한 입력을 입력합니다. 대화가 수행할 대화 분기를 아는 방법은 무엇입니까? 모호성 제거를 사용하는 경우 옵션이 표시되어 사용자가 올바른 항목을 선택할 수 있습니다. 자세한 내용은 모호성 제거를 참조하십시오.

• 입력에서 다중 엔티티 핸들링: 엔티티 유형의 첫 번째로 발견된 인스턴스의 값만 평가하려는 경우, @entity == 'specific-value' 형식 대신 @entity:(specific-value) 구문을 사용할 수 있습니다.

  예를 들어, @appliance == 'air conditioner'를 사용하면 첫 번째 발견된 @appliance 엔티티의 값만 평가합니다. 하지만 @appliance:(air conditioner) 사용이 entity['appliance'].contains('air conditioner')로 확장되며, 이는 사용자 입력에 하나 이상의 @appliance 엔티티 값 'air conditioner'가 발견될 때마다 일치합니다.

• 로그에서 데이터 숨기기: 정보를 컨텍스트 변수에 저장하고 메시지 컨텍스트의 $private 섹션 내에 컨텍스트 변수를 중첩하여 정보가 로그에 저장되지 않도록 할 수 있습니다. 예: $private.my_info. 개인용 오브젝트에 데이터를 저장하면 로그에서만 데이터를 숨깁니다. 해당 정보는 여전히 기본 JSON 오브젝트에 저장됩니다. 이 정보가 클라이언트 애플리케이션에 표시되지 않도록 하십시오.

• 개인 정보 검사: 사용자가 개인 식별 정보(PII)를 이후 프로세스에 제출하지 못하도록 확인하고 방지하려는 경우 패턴 엔티티를 조건으로 하는 대화 노드를 추가할 수 있습니다. 대화 트리의 시작 부분에 노드를 배치하여 입력을 먼저 검사하는지 확인하십시오. 예를 들어, 엔티티는 미국 사회 보장 번호 패턴 또는 이메일 주소 패턴을 확인할 수 있습니다. 그런 다음 Please do not submit personally identifiable information. Can you reenter your request? 같이 응답할 수 있습니다. 선택적으로 컨텍스트를 재설정하여 PII와 함께 사용자가 제출한 정보가 유지되지 않도록 할 수 있습니다.

조건 사용 팁

• 특수 문자가 있는 값에 대해 검사: 엔티티 또는 컨텍스트 변수에 값이 들어 있는지 확인하고 값에 아포스트로피( ')와 같은 특수 문자가 포함되어 있는지 확인하려면 소괄호로 검사할 값을 묶어야 합니다. 예를 들어, 엔티티 또는 컨텍스트 변수에 O'Reilly라는 이름이 있는지 확인하려면, 이름을 소괄호로 묶어야 합니다.

  @person:(O'Reilly) 및 $person:(O'Reilly)

  어시스턴트는 이러한 단축 참조를 전체 SpEL 표현식으로 변환합니다.

  entities['person']?.contains('O''Reilly') 및 context['person'] == 'O''Reilly'

  SpEL은 두 번째 어포스트로피를 사용하여 이름의 단일 어포스트로피를 이스케이프합니다.

• 다중 값 검사: 둘 이상의 값을 검사하려는 경우, OR 연산자(||)를 사용하여 조건에서 여러 값을 나열하는 조건을 작성할 수 있습니다. 예를 들어, 컨텍스트 변수 $state가 메사추세츠, 메인 또는 뉴햄프셔에 대한 약어를 포함하는 경우 true인 조건을 정의하려면 다음 표현식을 사용할 수 있습니다:

  $state:MA || $state:ME || $state:NH

• 숫자 값 검사: 숫자를 비교할 때 먼저 검사 중인 엔티티 또는 변수에 값이 있는지 확인하십시오. 엔티티 또는 변수에 숫자 값이 없는 경우 숫자 비교에서 널값 (0) 을 갖는 것으로 처리됩니다.

  예를 들어, 사용자 입력에 포함된 달러 값이 100미만인지 확인하려고 합니다. @price < 100 조건을 사용하고 @price 엔티티가 널인 경우 가격이 설정되지 않았지만 0은 100 미만이므로 조건 평가는 true입니다. 이러한 유형의 부정확한 결과를 방지하려면 @price AND @price < 100 같은 조건을 사용하십시오. @price에 값이 없으면, 이 조건은 올바르게 false를 리턴합니다.

• 특정 인텐트 이름 패턴이 있는 인텐트 검사: 패턴과 일치하는 인텐트를 찾는 조건을 사용할 수 있습니다. 예를 들어, 'User_'로 시작하는 인텐트 이름으로 발견된 인텐트를 찾으려면 조건에 다음과 같은 구문을 사용할 수 있습니다.

  intents[0].intent.startsWith("User_")

  그러나, 그렇게 하면 발견된 모든 인텐트가 고려되며, 심지어 신뢰도가 0.2 미만인 경우에도 고려됩니다. 또한 신뢰도 점수를 기반으로 관련이 없는 것으로 간주되는 인텐트가 리턴되지 않는지 확인하십시오. 이를 수행하려면, 다음과 같이 조건을 변경하십시오.

  !irrelevant && intents[0].intent.startsWith("User_")

• 퍼지 일치가 엔티티 인식에 미치는 영향: 조건으로 엔티티를 사용하고 퍼지 일치를 사용하는 경우 @entity_name에서는 일치의 신뢰도가 30%를 초과하는 경우에만 true로 평가합니다. 즉, @entity_name.confidence > .3인 경우에만 해당됩니다.

입력 시 엔티티 패턴 그룹 저장 및 인식

패턴 엔티티의 값을 컨텍스트 변수에 저장하려면 엔티티 이름에 .literal 를 추가하십시오. 이 구문을 사용하면 지정된 패턴과 일치하는 사용자 입력의 정확한 범위의 텍스트가 변수에 저장됩니다.

그룹이 정의된 패턴 엔티티에 단일 그룹의 텍스트를 저장하려면 저장하려는 그룹의 배열 번호를 지정하십시오. 예를 들어, 엔티티 패턴은 @phone_number 엔티티에 대해 다음과 같이 정의되어 있다고 가정합니다. (소괄호는 패턴 그룹을 나타냅니다.)

\b((958)|(555))-(\d{3})-(\d{4})\b

사용자 입력에 지정된 전화 번호의 지역 번호만 저장하려면 다음 구문을 사용할 수 있습니다.

그룹은 그룹 패턴 정의에 사용되는 정규식으로 구분됩니다. 예를 들어, 엔티티 @phone_number 에 정의된 패턴과 일치하는 사용자 입력이 958-234-3456 인 경우 다음 그룹이 작성됩니다.

관심 있는 입력 섹션을 캡처하는데 사용할 그룹 번호를 해독하려면, 한 번에 모든 그룹에 대한 정보를 추출 할 수 있습니다. 그룹화된 모든 패턴 엔티티 일치 배열을 리턴하는 컨텍스트 변수를 작성하려면 다음 구문을 사용하십시오.

"시험 사용" 분할창을 사용하여 테스트 전화번호 값을 입력하십시오. 958-123-2345의 경우, 이 표현식은 $array_of_matched_groups를 ["958-123-2345","958","958",null,"123","2345"]로 설정합니다.

그런 다음 배열의 각 값을 0부터 시작하여 그룹 번호를 시작할 수 있습니다.

결과에서 전화번호의 마지막 4자리숫자를 캡처하기 위해 #5그룹이 필요한지 판별할 수 있습니다. 예를 들어, 다음과 같습니다.

그룹화된 패턴 엔티티를 표시하기 위해 작성된 JSONArray 구조를 리턴하려면 다음 구문을 사용하십시오.

이 표현식은 $json_matched_groups를 다음과 같은 JSON 배열로 설정합니다.

[
  {"group": "group_0","location": [0, 12]},
  {"group": "group_1","location": [0, 3]},
  {"group": "group_2","location": [0, 3]},
  {"group": "group_3"},
  {"group": "group_4","location": [4, 7]},
  {"group": "group_5","location": [8, 12]}
]

location은 0부터 시작하는 문자 오프셋을 사용하여 발견된 엔티티 값이 입력 텍스트에서 시작하고 끝나는 위치를 표시하는 엔티티의 속성입니다.

두 개의 전화번호가 입력에 제공될 것으로 예상되면 두 개의 전화번호를 확인할 수 있습니다. 예를 들어, 다음 구문을 사용하여 두 번째 번호의 지역 번호를 캡처합니다.

입력이 I want to change my phone number from 958-234-3456 to 555-456-5678이면, $second_areacode는 555입니다.