질의 보내기

ThingWorx Flow > 기본 제공 서비스, 유틸리티 및 장치 > 서비스 > Dialogflow > 질의 보내기

질의 보내기

질의 보내기 작업을 사용하여 자연어 질의를 처리하고 구조화된 실행 가능 데이터를 결과로 읽어들입니다.

사전 요구 사항

워크플로에서 질의 보내기 작업을 사용하기 전에 Dialogflow 계정을 만들었는지 확인합니다.

워크플로에서 질의 보내기 작업을 사용하려면 다음 단계를 완료합니다.

1. Dialogflow에 있는 질의 보내기 작업을 캔버스에 끌어 놓고 마우스 포인터로 작업을 가리킨 다음

을 클릭하거나 작업을 두 번 클릭합니다. 질의 보내기 창이 열립니다.

2. 필요한 경우 레이블을 편집합니다. 기본적으로 레이블 이름은 작업 이름과 동일합니다.

3. Dialogflow 커넥터 유형을 추가하려면 지원되는 Dialogflow 커넥터 유형을 참조하십시오.

이전에 커넥터 유형을 추가한 경우 적절한 커넥터 유형을 선택하고 커넥터 이름 아래에서 커넥터를 선택합니다.

4. 테스트를 클릭하여 커넥터의 유효성을 검사합니다.

5. 맵 커넥터를 클릭하여 입력 필드를 채우는 데 사용한 커넥터와 다른 커넥터를 사용하여 작업을 실행합니다. 런타임 커넥터 필드에 유효한 Dialogflow 커넥터 이름을 제공합니다. 맵 커넥터에 대한 자세한 내용은 맵 커넥터 사용을 참조하십시오.

6. 에이전트 목록에서 Dialogflow 계정의 에이전트를 선택합니다.

7. 세션 ID 필드에 이 질의가 전송될 세션의 ID를 제공합니다. 이는 클라이언트를 식별하고 클라이언트별 컨텍스트를 포함하여 세션 매개 변수를 관리하는 문자열 토큰(최대 36개 기호)입니다.

8. 질의 입력 목록에서 올바른 옵션을 선택하고 해당 작업을 수행합니다.

질의 입력	작업
텍스트	a. 텍스트 필드에 처리될 자연 언어 텍스트를 UTF-8 형식으로 제공합니다. b. 언어 코드 목록에서 올바른 언어를 선택합니다.
오디오	a. 입력 오디오 필드에서 이전 작업의 출력을 매핑하여 처리할 자연 언어 음성 오디오를 base64 형식으로 제공합니다. 단일 요청에는 최대 1분의 음성 오디오 데이터가 포함될 수 있습니다. b. 오디오 인코딩 유형을 선택합니다. c. 샘플 속도 필드에 오디오의 샘플 속도(Hz)를 제공합니다. d. 언어 코드 목록에서 올바른 언어를 선택합니다. e. 인식된 음성 단어에 대한 정보를 사용하려면 단어 정보 사용 목록에서 true를 선택하고, 그렇지 않으면 false를 선택합니다. f. 모델 필드에 지정된 요청에 대해 선택해야 하는 음성 모델을 제공합니다. 모델을 지정하지 않으면 입력을 기반으로 모델이 자동 선택됩니다. g. 모델 변형 목록에서 사용해야 할 음성 모델의 변형을 선택합니다.

질의 입력

작업

텍스트

a. 텍스트 필드에 처리될 자연 언어 텍스트를 UTF-8 형식으로 제공합니다.

b. 언어 코드 목록에서 올바른 언어를 선택합니다.

오디오

a. 입력 오디오 필드에서 이전 작업의 출력을 매핑하여 처리할 자연 언어 음성 오디오를 base64 형식으로 제공합니다. 단일 요청에는 최대 1분의 음성 오디오 데이터가 포함될 수 있습니다.

b. 오디오 인코딩 유형을 선택합니다.

c. 샘플 속도 필드에 오디오의 샘플 속도(Hz)를 제공합니다.

d. 언어 코드 목록에서 올바른 언어를 선택합니다.

e. 인식된 음성 단어에 대한 정보를 사용하려면 단어 정보 사용 목록에서 true를 선택하고, 그렇지 않으면 false를 선택합니다.

f. 모델 필드에 지정된 요청에 대해 선택해야 하는 음성 모델을 제공합니다. 모델을 지정하지 않으면 입력을 기반으로 모델이 자동 선택됩니다.

g. 모델 변형 목록에서 사용해야 할 음성 모델의 변형을 선택합니다.

9. 시간대 필드에 올바른 시간대(예: America/New York, Europe/Paris 등)를 입력합니다.

10. 위도 및 경도를 제공합니다.

11. 세션 엔티티 유형 섹션에서 개발자 엔티티 유형을 대체하거나 확장할 추가 세션 엔티티 유형을 제공합니다. 엔티티 동의어는 모든 언어에 적용되고 이 질의 세션 동안 유지됩니다.

이 양식에 나열된 개별 입력 필드의 입력을 제공하려면 양식을 선택하거나 모든 필수 입력이 있는 단일 JSON을 지정하려면 JSON 지정을 선택합니다.

양식을 선택한 경우
a. 세션 엔티티 유형 섹션에서 추가를 클릭합니다. b. 이름 필드에 이 세션 엔티티 유형의 고유한 식별자를 projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity type display name> 형식으로 제공합니다. 여기서 <Entity type display name>은 동일한 에이전트에 있는 기존 엔티티 유형의 표시 이름(재정의되거나 보완됨)이거나 이 세션 동안에만 유효한 새 엔티티 유형의 표시 이름일 수 있습니다. c. 엔티티 재정의 모드 목록에서 다음 중 하나를 선택합니다. ◦ 재정의 - 세션 엔티티가 사용자 정의 엔티티 유형 정의를 재정의합니다. ◦ 보완 - 세션 엔티티가 사용자 정의 엔티티 유형 정의를 보완합니다. d. 엔티티 유형과 연관될 엔티티 컬렉션을 추가하려면 엔티티에서 추가를 클릭합니다. a. 값 필드에 엔트리 값을 제공합니다. b. 동의어 필드에 지정된 값에 대한 동의어를 제공합니다. 동의어를 여러 개 추가하려면 추가를 클릭합니다. 추가한 동의어를 삭제하려면 을 클릭합니다. c. 값-동의어 쌍을 여러 개 추가하려면 추가를 클릭합니다. 추가한 값-동의어 쌍을 삭제하려면 을 클릭합니다. d. 세션 엔티티 유형을 여러 개 추가하려면 추가를 클릭합니다. 추가한 세션 엔티티 유형을 삭제하려면 을 클릭합니다.

양식을 선택한 경우

a. 세션 엔티티 유형 섹션에서 추가를 클릭합니다.

b. 이름 필드에 이 세션 엔티티 유형의 고유한 식별자를 projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity type display name> 형식으로 제공합니다. 여기서 <Entity type display name>은 동일한 에이전트에 있는 기존 엔티티 유형의 표시 이름(재정의되거나 보완됨)이거나 이 세션 동안에만 유효한 새 엔티티 유형의 표시 이름일 수 있습니다.

c. 엔티티 재정의 모드 목록에서 다음 중 하나를 선택합니다.

◦ 재정의 - 세션 엔티티가 사용자 정의 엔티티 유형 정의를 재정의합니다.

◦ 보완 - 세션 엔티티가 사용자 정의 엔티티 유형 정의를 보완합니다.

d. 엔티티 유형과 연관될 엔티티 컬렉션을 추가하려면 엔티티에서 추가를 클릭합니다.

a. 값 필드에 엔트리 값을 제공합니다.

b. 동의어 필드에 지정된 값에 대한 동의어를 제공합니다.

동의어를 여러 개 추가하려면 추가를 클릭합니다. 추가한 동의어를 삭제하려면

을 클릭합니다.

c. 값-동의어 쌍을 여러 개 추가하려면 추가를 클릭합니다. 추가한 값-동의어 쌍을 삭제하려면

을 클릭합니다.

d. 세션 엔티티 유형을 여러 개 추가하려면 추가를 클릭합니다. 추가한 세션 엔티티 유형을 삭제하려면

을 클릭합니다.

또는

JSON 지정을 선택한 경우
세션 엔티티 유형 필드에 모든 필수 입력을 [{"name":"string", "entityOverrideMode":"string", "entities":[{"value":"string", "synonyms":[{}]}]}] 형식으로 제공합니다.

12. 컨텍스트 섹션에서 질의를 실행하기 전에 활성화해야 하는 컨텍스트를 제공합니다.

이 양식에 나열된 개별 입력 필드의 입력을 제공하려면 양식을 선택하거나 모든 필수 입력이 있는 단일 JSON을 지정하려면 JSON 지정을 선택합니다.

양식을 선택한 경우
a. 컨텍스트 섹션에서 추가를 클릭합니다. b. 이름 필드에 컨텍스트 이름을 projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID> 또는 projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>/contexts/<Context ID> 형식으로 제공합니다. c. 수명 수 필드에 대화 질의 요청의 수를 제공합니다. 이 이후에 컨텍스트가 만료됩니다. 기본값은 0입니다. 0으로 설정하면 컨텍스트가 즉시 만료됩니다. 일치하는 질의가 없으면 20분 후에 컨텍스트가 자동으로 만료됩니다. 컨텍스트를 여러 개 추가하려면 추가를 클릭합니다. 추가한 컨텍스트를 삭제하려면 을 클릭합니다.

양식을 선택한 경우

a. 컨텍스트 섹션에서 추가를 클릭합니다.

b. 이름 필드에 컨텍스트 이름을 projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID> 또는 projects/<Project ID>/agent/environments/<Environment ID>/users/<User ID>/sessions/<Session ID>/contexts/<Context ID> 형식으로 제공합니다.

c. 수명 수 필드에 대화 질의 요청의 수를 제공합니다. 이 이후에 컨텍스트가 만료됩니다. 기본값은 0입니다. 0으로 설정하면 컨텍스트가 즉시 만료됩니다. 일치하는 질의가 없으면 20분 후에 컨텍스트가 자동으로 만료됩니다.

컨텍스트를 여러 개 추가하려면 추가를 클릭합니다. 추가한 컨텍스트를 삭제하려면

을 클릭합니다.

또는

JSON 지정을 선택한 경우
컨텍스트 필드에 모든 필수 입력을 [{"name":"string", "lifespanCount":0}] 형식으로 제공합니다.

13. 새 컨텍스트가 설정되기 전에 현재 세션의 모든 컨텍스트를 삭제하려면 컨텍스트 재설정 필드에서 true를 선택하고, 그렇지 않으면 false를 선택합니다.

14. 질의 텍스트에 대해 감정 분석을 수행하려면 질의 텍스트 감정 분석 목록에서 true를 선택하고, 그렇지 않으면 false를 선택합니다.

15. 완료를 클릭합니다.

출력 스키마

도움이 되셨나요?