SetDialogflowResponse 정책

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

개요

SetDialogflowResponse 정책은 Dialogflow와 Apigee의 통합을 도와줍니다. 자세한 내용은 Apigee와 Contact Center AI 통합을 참조하세요.

SetDialogflowResponse 정책은 데이터를 WebhookResponse로 Dialogflow 에이전트에 보내기 전에 백엔드 시스템의 응답 데이터를 처리하고 형식을 지정합니다. Dialogflow 에이전트에는 특정 형식의 WebhookResponse가 필요하며 SetDialogflowResponse 정책은 필수 형식으로 응답을 빌드합니다. 정책은 Dialogflow 에이전트에 필요한 형식으로 WebhookResponse를 생성합니다. WebhookResponse에는 Dialogflow 에이전트가 이해하는 자연어 구문 및 기타 매개변수가 있습니다.

백엔드 서비스 통합업체는 Dialoglfow WebhookResponse의 형식을 이해하는 데 시간을 소비할 필요가 없습니다. 즉시 사용 가능한 SetDialogflowResponse 정책이 응답 데이터를 원활하게 처리해 줍니다.

이 정책은 확장 가능한 정책이며, 이 정책을 사용하면 Apigee 라이선스에 따라 비용 또는 사용률이 영향을 받을 수 있습니다. 정책 유형 및 사용 영향에 대한 자세한 내용은 정책 유형을 참조하세요.

`<SetDialogflowResponse>`

SetDialogflowResponse 정책을 정의합니다.

기본값	해당 사항 없음
필수 여부	필수
유형	복합 객체
상위 요소	해당 사항 없음
하위 요소	`<DisplayName>` `<Source>` `<DialogflowVersion>` `<NaturalLanguageResponse>` `<Parameters>` `<IgnoreUnresolvedVariables>`

다음 표에서는 SetDialogflowResponse 요소의 모든 하위 요소를 간략하게 설명합니다.

하위 요소	필수 여부	설명
`<DisplayName>`	선택사항	정책의 커스텀 이름입니다.
`<Source>`	선택사항	파싱할 변수를 지정합니다.
`<DialogflowVersion>`	선택사항	Dialogflow 버전을 지정합니다.
`<NaturalLanguageResponse>`	선택사항	`WebhookResponse.FulfillmentResponse` 객체로 전송해야 하는 모든 콘텐츠를 캡슐화합니다.
`<Parameters>`	선택사항	`<Parameter>`의 상위 요소입니다. 웹훅의 응답에 설정할 매개변수 집합을 정의합니다.
`<IgnoreUnresolvedVariables>`	선택사항	해결되지 않은 변수가 발생하면 처리를 중지할지 여부를 지정합니다.
기타 하위 요소
`<MergeBehavior>`	선택사항	응답 메시지의 병합 동작을 지정합니다.
`<Header>`	선택사항	응답 헤더에서 지정된 필드의 값을 추출합니다.
`<JSONPath>`	선택사항	지정된 JSON 경로의 값을 추출합니다.
`<Parameter>`	필수	웹훅 응답의 `sessionInfo.parameters` 객체에서 설정할 매개변수를 지정합니다.
`<Phrase>`	필수	웹훅 응답의 `fulfillmentResponse.messages` 객체에 설정할 구문(텍스트)을 지정합니다.
`<Phrases>`	선택사항	`<Phrase>`의 상위 요소입니다. 웹훅의 응답에 설정할 자연어 구문 집합을 정의합니다.
`<Ref>`	선택사항	지정된 참조 변수의 값을 추출합니다.
`<Value>`	선택사항	커스텀 텍스트를 지정된 매개변수로 설정합니다.

예시

다음 예시는 샘플 SetDialogflowResponse 정책 및 Dialogflow 에이전트에 전송되는 WebhookResponse를 보여줍니다.

구문

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<SetDialogflowResponse continueOnError="false" enabled="true"
        name="POLICY_NAME">
    <!-- The display name for this policy -->
    <DisplayName>DISPLAY_NAME</DisplayName>
    <!-- The message variable from which the policy extracts the required information -->
    <Source>MESSAGE_VARIABLE</Source>
    <!-- The version of Dialogflow for which this response policy is written up.
         This policy supports only the CX version. This element is optional and
         defaults to CX if unspecified -->
    <DialogflowVersion>DIALOGFLOW_VERSION</DialogflowVersion>
    <!-- A container object to encapsulate all content needed for a natural
         language response to be returned to Dialogflow from the Southbound API -->
    <NaturalLanguageResponse>
        <!-- Defines the merge behavior for existing responses and new responses.
             Refer here for more details -->
        <MergeBehavior>MERGE_BEHAVIOR</MergeBehavior>
        <!-- An ordered list of natural language phrases to be returned to
             Dialogflow from the Southbound API -->
        <Phrases>
            <!-- A phrase is a natural language phrase that Dialogflow agents
                 can send back to their caller/chatting customer -->
            <Phrase>
                <!-- A phrase can be extracted from the response JSON payload of a
                     service callout -->
                <JSONPath>JSON_PATH</JSONPath>
            </Phrase>
            <Phrase>
                <!-- A phrase can be extracted from the response headers of a
                     service callout -->
                <Header name="HEADER_NAME"/>
            </Phrase>
            <Phrase>
                <!-- A phrase refer to the value of an existing flow variable -->
                <Ref>EXISTING_FLOW_VARIABLE</Ref>
            </Phrase>
            <Phrase>
                <!-- A phrase can be static text -->
                <Value>CUSTOM_TEXT</Value>
            </Phrase>
        </Phrases>
    </NaturalLanguageResponse>
    <!-- A container object defining the parameters to be set as session parameters
         in the Webhook response sent to Dialogflow -->
    <Parameters>
        <!-- Defines a single parameter to be set in sessionInfo.parameters object
             of the WebhookResponse object. The name of the parameter is defined
             as an attribute -->
        <Parameter name="PARAMETER_NAME">
            <!-- A parameter's value can be extracted from the response JSON
                 payload of a service callout -->
            <JSONPath>JSON_PATH</JSONPath>
        </Parameter>
        <Parameter name="PARAMETER_NAME">
            <!-- A parameter's value can be extracted from the response headers
                 of a service callout -->
            <Header name="HEADER_NAME"/>
        </Parameter>
        <Parameter name="PARAMETER_NAME">
            <!-- A parameter's value can be refer to the value of an existing flow
                 variable -->
            <Ref>EXISTING_FLOW_VARIABLE</Ref>
        </Parameter>
        <Parameter name="PARAMETER_NAME">
            <!-- A parameter's value can be static text -->
            <Value>CUSTOM_TEXT</Value>
        </Parameter>
    </Parameters>
    <IgnoreUnresolvedVariables>BOOLEAN_VALUE</IgnoreUnresolvedVariables>
</SetDialogflowResponse>

SetDialogflowResponse 정책

다음 예시에서는 SetDialogflowResponse 정책 정의를 보여줍니다.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<SetDialogflowResponse continueOnError="false" enabled="true"
        name="CCAIDialogflowResponse-InsuranceAgent">
    <DisplayName>Insurance Agent Webhook Response Policy</DisplayName>
    <Source>myMessageVar</Source>
    <DialogflowVersion>CX</DialogflowVersion>
    <NaturalLanguageResponse>
        <MergeBehavior>APPEND</MergeBehavior>
        <Phrases>
            <Phrase>
                <JSONPath>$.claim.status.text</JSONPath>
            </Phrase>
            <Phrase>
                <Header name="X-Response-Text"/>
            </Phrase>
            <Phrase>
                <Ref>myVar</Ref>
            </Phrase>
            <Phrase>
                <Value>You call is important to us</Value>
            </Phrase>
        </Phrases>
    </NaturalLanguageResponse>
    <Parameters>
        <Parameter name="claimStatus">
            <JSONPath>$.claim.status.value</JSONPath>
        </Parameter>
        <Parameter name="claimAmount">
            <JSONPath>$.claim.amount</JSONPath>
        </Parameter>
        <Parameter name="timeSpent">
            <Header name="X-Time-Spent"/>
        </Parameter>
        <Parameter name="myVar">
            <Ref>dialogflow.my.var</Ref>
        </Parameter>
        <Parameter name="responder">
            <Value>SYSTEM</Value>
        </Parameter>
    </Parameters>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</SetDialogflowResponse>

다음 샘플로 이동하여 이 정책에서 생성된 웹훅 응답을 확인합니다.

웹훅 응답

다음 예시에서는 Dialogflow 에이전트로 전송된 WebhookResponse를 보여줍니다.

{
    "fulfillmentResponse": {
        "mergeBehavior": "APPEND",
        "messages": [{
            "text": {
                "text": ["Your claim is currently being processed",
                          "Please call back in a couple of days"]
            }
        }]
    },
    "sessionInfo": {
        "parameters": {
            "claimStatus": "PROCESSING",
            "claimAmount": 1000
        }
    }
}

이 요소에는 다음과 같이 모든 정책에 공통된 속성이 있습니다.

속성	기본	필수 여부	설명
`name`	해당 없음	필수	정책의 내부 이름입니다. `name` 속성의 값에는 문자, 숫자, 공백, 하이픈, 밑줄, 마침표가 포함될 수 있습니다. 이 값은 255자(영문 기준)를 초과할 수 없습니다. 원하는 경우 `<DisplayName>` 요소를 사용하여 관리 UI 프록시 편집기의 정책에 다른 자연어 이름을 사용하여 정책에 라벨을 지정합니다.
`continueOnError`	false	선택	정책이 실패할 경우 오류가 반환되도록 하려면 `false`로 설정합니다. 이는 대부분의 정책에서 예상되는 동작입니다. 정책이 실패해도 흐름 실행이 계속되도록 하려면 `true`로 설정합니다. 참조: 오류 규칙이 오류 상태(continueOnError)에서만 트리거됨 현재 흐름 내에서 정책 오류 처리
`enabled`	true	선택	정책을 시행하려면 `true`로 설정합니다. 정책을 중지하려면 `false`로 설정합니다. 정책이 흐름에 연결되어 있어도 정책이 시행되지 않습니다.
`async`	false	지원 중단됨	이 속성은 지원이 중단되었습니다.

하위 요소 참조

이 섹션에서는 <SetDialogflowResponse>의 하위 요소를 설명합니다.

`<DisplayName>`

name 속성 외에 이 요소를 사용하여 관리 UI 프록시 편집기에서 자연스러운 다른 이름으로 정책의 라벨을 지정합니다.

<DisplayName> 요소는 모든 정책에 공통으로 적용됩니다.

기본값	해당 사항 없음
필수 여부	선택사항. `<DisplayName>`을 생략하면 정책의 `name` 속성 값이 사용됩니다.
유형	문자열
상위 요소	<`PolicyElement`>
하위 요소	없음

<DisplayName> 요소는 다음 구문을 사용합니다.

구문

<PolicyElement>
  <DisplayName>POLICY_DISPLAY_NAME</DisplayName>
  ...
</PolicyElement>

예시

<PolicyElement>
  <DisplayName>My Validation Policy</DisplayName>
</PolicyElement>

<DisplayName> 요소에 속성 또는 하위 요소가 없습니다.

`<Source>`

파싱할 변수를 지정합니다. <Source>의 기본값은 message입니다. message 값은 상황에 따라 다릅니다. 요청 흐름에서 message는 요청 메시지로 확인됩니다. 응답 흐름에서 message는 응답 메시지로 확인됩니다.

이 정책을 사용하여 요청 또는 응답 메시지에서 정보를 추출하는 경우가 많지만 모든 변수에서 정보를 추출하는 데 사용할 수 있습니다. 예를 들어 AccessEntity 정책에서 생성된 항목 및 서비스 콜아웃 정책에서 반환한 데이터에서 정보를 추출하거나 XML 또는 JSON 객체에서 정보를 추출하는 데 사용할 수 있습니다.

<Source>를 확인할 수 없거나 메시지가 아닌 유형으로 확인되면 정책이 실패하고 런타임 오류가 발생합니다.

기본값	해당 사항 없음
필수 여부	선택사항
유형	문자열
상위 요소	`<SetDialogflowResponse>`
하위 요소	없음

<Source> 요소는 다음 구문을 사용합니다.

구문

<Source>MESSAGE_VARIABLE</Source>

예시

다음 예시에서는 소스를 myMessageVar로 설정합니다.

<Source>myMessageVar</Source>

`<DialogflowVersion>`

Dialogflow 버전을 지정합니다. SetDialogflowResponse 정책은 CX 버전만 지원합니다. 정책에서 이 요소를 지정하지 않으면 버전은 기본적으로 CX가 됩니다.

기본값	해당 사항 없음
필수 여부	선택사항
유형	문자열
상위 요소	`<SetDialogflowResponse>`
하위 요소	없음

<DialogflowVersion> 요소는 다음 구문을 사용합니다.

구문

<DialogflowVersion>DIALOGFLOW_VERSION</DialogflowVersion>

예시

다음 예시에서는 DialogflowVersion을 CX로 설정합니다.

<DialogflowVersion>CX</DialogflowVersion>

`<IgnoreUnresolvedVariables>`

해결되지 않은 변수가 발생하면 처리를 중지할지 여부를 결정합니다.

기본값	True
필수 여부	선택사항
유형	부울
상위 요소	`<SetDialogflowResponse>`
하위 요소	없음

확인되지 않은 변수를 무시하고 계속 처리하려면 true로 설정합니다. 그렇지 않으면 false로 설정합니다. 기본값은 true입니다.

<IgnoreUnresolvedVariables>를 true로 설정하는 것은 <SetDialogflowResponse>의 continueOnError를 true로 설정하는 것과 다릅니다. continueOnError를 true로 설정하면 Apigee가 모든 오류를 무시하지만 변수의 오류를 무시하지 않습니다.

<IgnoreUnresolvedVariables> 요소는 다음 구문을 사용합니다.

구문

 <IgnoreUnresolvedVariables>[true|false]</IgnoreUnresolvedVariables>

예시

다음 예시에서는 <IgnoreUnresolvedVariables>를 false로 설정합니다.

       <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

`<MergeBehavior>`

응답 메시지의 병합 동작을 정의합니다. 다음 값 중 하나를 지정할 수 있습니다.

APPEND: 사용자에게 전송 대기 중인 메시지 목록에 메시지를 추가합니다.
REPLACE: 사용자에게 전송 대기 중인 메시지 목록에서 이전 메시지를 새 메시지로 바꿉니다.

요소를 지정하지 않으면 동작의 기본값은 APPEND입니다.

기본값	해당 사항 없음
필수 여부	선택사항
유형	문자열
상위 요소	`<NaturalLanguageResponse>`
하위 요소	없음

<MergeBehavior> 요소는 다음 구문을 사용합니다.

구문

<MergeBehavior>BEHAVIOR</MergeBehavior>

예시

다음 예시에서는 병합 동작을 APPEND로 설정합니다.

<MergeBehavior>APPEND</MergeBehavior>

`<NaturalLanguageResponse>`

Dialogflow 에이전트로 전송하려는 모든 자연어 응답을 캡슐화합니다.

기본값	해당 사항 없음
필수 여부	선택사항
유형	복합 객체
상위 요소	`<SetDialogflowResponse>`
하위 요소	`<MergeBehavior>` `<Phrases>`

`<Parameters>`

웹훅의 응답에 설정할 매개변수 집합을 정의합니다. 매개변수 이름은 <Parameter> 요소의 속성입니다.

기본값	해당 사항 없음
필수 여부	선택사항
유형	복합 객체
상위 요소	`<SetDialogflowResponse>`
하위 요소	`<Parameter>`

`<Parameter>`

웹훅 응답의 sessionInfo.parameters 객체에 설정할 매개변수를 지정합니다.

정적 텍스트를 매개변수 값으로 지정하거나 응답의 다음 필드에서 값을 추출할 수 있습니다.

응답 헤더 필드
JSON 페이로드
흐름 변수

추출할 값마다 별도의 <Parameter> 요소를 정의해야 합니다.

기본값	해당 사항 없음
필수 여부	필수
유형	복합 객체
상위 요소	`<Parameters>`
하위 요소	`<Header>` `<JSONPath>` `<Ref>` `<Value>`

<Parameter> 요소에는 다음과 같은 속성이 있습니다.

속성	설명	필수 여부	유형
`name`	이 매개변수로 만들 변수의 이름입니다.	예	문자열

<Parameter> 요소는 다음 구문을 사용합니다.

구문


<Parameters>
  <Parameter name="PARAMETER_NAME">
  <Header name="HEADER_NAME"/>
</Parameter>
<Parameter name="PARAMETER_NAME">
  <JSONPath>JSON_PATH</JSONPath>
</Parameter>
<Parameter name="PARAMETER_NAME">
  <Ref>EXISTING_FLOW_VARIABLE</Ref>
</Parameter>
<Parameter name="PARAMETER_NAME">
  <Value>CUSTOM_TEXT</Value>
</Parameter>
</Parameters>

헤더 필드 값 추출

이 예시에서는 timeSpent 매개변수를 X-Time-Spent 헤더 필드의 값으로 설정합니다.

<Parameter name="timeSpent">
     <Header name="X-Time-Spent"/>
</Parameter>

JSON 경로 값 추출

이 예시에서는 claimAmount 매개변수를 JSON 페이로드의 claim.amount 필드 값으로 설정합니다.

<Parameter name="claimAmount">
   <JSONPath>$.claim.amount</JSONPath>
</Parameter>

흐름 변수 값 추출

이 예시에서는 myVar 매개변수를 dialogflow.my.var 흐름 변수의 값으로 설정합니다.

<Parameter name="myVar">
   <Ref>dialogflow.my.var</Ref>
</Parameter>

커스텀 텍스트 설정

이 예시에서는 responder 매개변수의 값을 SYSTEM으로 설정합니다.

<Parameter name="responder">
   <Value>SYSTEM</Value>
</Parameter>

`<Phrases>`

<Phrase>의 상위 요소입니다. 웹훅 응답에서 설정할 자연어 구문의 순서가 지정된 목록을 정의합니다.

기본값	해당 사항 없음
필수 여부	선택사항
유형	복합 객체
상위 요소	`<NaturalLanguageResponse>`
하위 요소	`<Phrase>`

`<Phrase>`

웹훅 응답의 fulfillmentResponse.messages 객체에 설정할 구문(텍스트)을 지정합니다.

정적 텍스트를 구문 값으로 지정하거나 응답의 다음 필드에서 값을 추출할 수 있습니다.

응답 헤더 필드
JSON 페이로드
흐름 변수

추출할 값마다 별도의 <Phrase> 요소를 정의해야 합니다.

기본값	해당 사항 없음
필수 여부	필수
유형	복합 객체
상위 요소	`<Phrases>`
하위 요소	`<Header>` `<JSONPath>` `<Ref>` `<Value>`

<Phrase> 요소는 다음 구문을 사용합니다.

구문

<Phrases>
  <Phrase>
    <Header name="HEADER_NAME"/>
  </Phrase>
  <Phrase>
    <JSONPath>JSON_PATH</JSONPath>
  </Phrase>
  <Phrase>
    <Ref>EXISTING_FLOW_VARIABLE</Ref>
  </Phrase>
  <Phrase>
    <Value>CUSTOM_TEXT</Value>
  </Phrase>
</Phrases>

헤더 필드 값 추출

이 예시에서는 응답의 자연어 텍스트를 X-Response-Text 헤더 필드의 값으로 설정합니다.

<Phrase>
     <Header name="X-Response-Text"/>
</Phrase>

JSON 경로 값 추출

이 예시에서는 응답의 자연어 텍스트를 JSON 페이로드의 claim.status.text 필드 값으로 설정합니다.

<Phrase>
   <JSONPath>$.claim.status.text</JSONPath>
</Phrase>

흐름 변수 값 추출

이 예시에서는 응답의 자연어 텍스트를 myVar 흐름 변수의 값으로 설정합니다.

<Phrase>
   <Ref>myVar</Ref>
</Phrase>

커스텀 텍스트 설정

이 예시에서는 응답의 자연어 텍스트에 You call is important to us 텍스트를 추가합니다.

<Phrase>
   <Value>You call is important to us</Value>
</Phrase>

`<Header>`

응답 헤더의 지정된 필드에서 값을 추출합니다. 헤더 값을 사용하여 자연어 텍스트 또는 응답 매개변수를 설정할 수 있습니다.

헤더 값을 자연어 응답으로 추출하려면 <Phrase> 요소 내에 <Header> 요소를 지정합니다.
헤더 값을 응답 매개변수로 추출하려면 <Parameter> 요소 내에 <Header> 요소를 지정합니다.

기본값	해당 사항 없음
필수 여부	선택사항
유형	문자열
상위 요소	`<Phrase>` `<Parameter>`
하위 요소	없음

<Header> 요소는 다음 구문을 사용합니다.

구문

<Header name="HEADER_FIELD"/>

예시 1

다음 예시에서는 X-Response-Text 헤더 필드의 값을 자연어 응답으로 가져옵니다.

<Phrase>
  <Header name="X-Response-Text"/>
<Phrase/>

예시 2

다음 예시에서는 X-Response-Text 헤더 필드의 값을 응답 매개변수로 가져옵니다.

<Parameter name="timeSpent">
  <Header name="X-Response-Text"/>
<Parameter/>

timeSpent 흐름 변수는 X-Response-Text 헤더 필드의 값으로 설정됩니다.

<Header> 요소에는 다음과 같은 속성이 있습니다.

속성	설명	필수 ?	유형
이름	값을 추출할 응답 헤더의 이름을 지정합니다.	필수	문자열

`<JSONPath>`

서비스 콜아웃의 JSON 페이로드에서 JSON 경로 값을 추출합니다. 이 값을 사용하여 자연어 텍스트 또는 응답 매개변수를 설정할 수 있습니다.

JSON 값을 자연어 텍스트로 추출하려면 <Phrase> 요소 내에 <JSONPath> 요소를 지정합니다.
JSON 값을 응답 매개변수로 추출하려면 <Parameter> 요소 내에 <JSONPath> 요소를 지정합니다.

기본값	해당 사항 없음
필수 여부	선택사항
유형	문자열
상위 요소	`<Phrase>` `<Parameter>`
하위 요소	없음

<JSONPath> 요소는 다음 구문을 사용합니다.

구문

<JSONPath>JSON_PATH</JSONPath>

예시 1

다음 예시에서는 claim.status.text JSON 필드의 값을 자연어 응답으로 가져옵니다.

<Phrase>
  <JSONPath>$.claim.status.text</JSONPath>
<Phrase/>

예시 2

다음 예시에서는 claim.amount JSON 필드의 값을 응답 매개변수로 가져옵니다.

<Parameter name="claimAmount">
  <JSONPath>$.claim.amount.</JSONPath>
<Parameter/>

claimAmount 흐름 변수는 {claim.amount} JSON 필드의 값으로 설정됩니다.

`<Ref>`

기존 흐름 변수의 값을 추출합니다. 이 값을 사용하여 자연어 텍스트 또는 응답 매개변수를 설정할 수 있습니다.

변수 값을 자연어 텍스트로 추출하려면 <Phrase> 요소 내에 <Ref> 요소를 지정합니다.
변수의 값을 응답 매개변수로 추출하려면 <Parameter> 요소 내에 <Ref> 요소를 지정합니다.

기본값	해당 사항 없음
필수 여부	선택사항
유형	문자열
상위 요소	`<Phrase>` `<Parameter>`
하위 요소	없음

<Ref> 요소는 다음 구문을 사용합니다.

구문

<Ref>EXISTING_FLOW_VARIABLE</Ref>

예시 1

다음 예시에서는 myVar 흐름 변수의 값을 자연어 응답으로 가져옵니다.

<Phrase>
  <Ref>myVar</Ref>
<Phrase/>

예시 2

다음 예시에서는 dialogflow.my.var 흐름 변수의 값을 응답 매개변수로 가져옵니다.

<Parameter name="customVar">
  <Ref>dialogflow.my.var</Ref>
<Parameter/>

customVar 흐름 변수는 dialogflow.my.var 변수 값으로 설정됩니다.

`<Value>`

리터럴 값을 자연어 텍스트 또는 응답 매개변수로 설정합니다.

리터럴 값을 자연어 텍스트로 설정하려면 <Phrase> 요소 내에 <Value> 요소를 지정합니다.
리터럴 값을 응답 매개변수로 설정하려면 <Parameter> 요소 내에 <Value> 요소를 지정합니다.

기본값	해당 사항 없음
필수 여부	선택사항
유형	문자열
상위 요소	`<Phrase>` `<Parameter>`
하위 요소	없음

<Value> 요소는 다음 구문을 사용합니다.

구문

<Value>CUSTOM_TEXT</Value>

예시 1

다음 예시에서는 리터럴 텍스트 You call is important to us를 자연어 응답으로 설정합니다.

<Phrase>
  <Value>You call is important to us</Value>
<Phrase/>

예시 2

다음 예시에서는 리터럴 텍스트 SYSTEM을 응답 매개변수로 설정합니다.

<Parameter name="responder">
  <Value>SYSTEM</Value>
<Parameter/>

responder 흐름 변수는 SYSTEM으로 설정됩니다.

오류 코드

이 섹션에서는 반환되는 오류 코드 및 오류 메시지와 이 정책이 오류를 트리거할 때 Apigee에서 설정한 오류 변수를 설명합니다. 오류를 처리하기 위해 오류 규칙을 개발 중인 경우, 이 정보는 중요합니다. 자세한 내용은 정책 오류에 대해 알아야 할 사항 및 오류 처리를 참조하세요.

런타임 오류

이러한 오류는 정책이 실행될 때 발생할 수 있습니다.

오류 코드	HTTP 상태	원인
`steps.setdialogflowresponse.ExecutionFailed`	`500`	이 오류는 일반 예외로 인해 정책 실행이 실패할 때 발생합니다. 오류 메시지에는 예외에 대한 세부정보가 포함됩니다.
`steps.setdialogflowresponse.InvalidSourceType`	`500`	이 오류는 <Source> 요소에 지정된 변수가 메시지 유형이 아닌 경우에 발생합니다.
`steps.setdialogflowresponse.MalformedInput`	`500`	이 오류는 이 정책에 제공된 JSON이 유효하지 않거나 잘못되었을 때 발생합니다.
`steps.setdialogflowresponse.SourceMessageNotAvailable`	`500`	이 오류는 정책의 `Source` 요소에 지정된 message 변수가 다음 중 하나일 때 발생합니다. 범위를 벗어난 경우(정책이 실행되는 특정 흐름에서 사용할 수 없음) 또는 확인할 수 없는 경우(정의되지 않음)
`steps.setdialogflowresponse.UnresolvedHeader`	`500`	이 오류는 `Header` 요소에 잘못된 헤더가 있을 때 발생합니다. 예를 들어 `Header` 요소에 `X-Response-Text` 값이 있고, 응답 헤더에 `X-Response-Text`가 없으면 이 오류가 표시됩니다.
`steps.setdialogflowresponse.UnresolvedJSONPath`	`500`	이 오류는 `JSONPath` 요소에 잘못된 경로가 포함되었을 때 발생합니다. 예를 들어 `JSONPath` 요소에 `{claim.status.value}` 값이 있고 JSON 페이로드에 `status` 객체가 없으면 이 오류가 표시됩니다.
`steps.setdialogflowresponse.UnresolvedVariable`	`500`	이 오류는 SetDialogflowResponse 정책에 지정된 변수가 다음 중 하나인 경우에 발생합니다. 범위를 벗어난 경우(정책이 실행 중인 특정 흐름에서 사용할 수 없음) 또는 확인할 수 없는 경우(정의되지 않음)

배포 오류

이 오류는 이 정책이 포함된 프록시를 배포할 때 발생할 수 있습니다.

오류 이름	원인
`UnsupportedOperation`	이 오류는 `DialogflowVersion` 요소에 지원되지 않는 Dialogflow 버전을 지정한 경우에 발생합니다. SetDialogflowResponse 정책은 `CX` 버전만 지원합니다.

오류 변수

정책에 실행 오류가 발생할 때마다 Apigee는 오류 메시지를 생성합니다. 오류 응답에서 이러한 오류 메시지를 볼 수 있습니다. 시스템에서 생성된 오류 메시지가 제품의 컨텍스트와 관련이 없을 경우가 많습니다. 메시지를 보다 의미 있게 만들기 위해 오류 유형에 따라 오류 메시지를 맞춤설정할 수 있습니다.

오류 메시지를 맞춤설정하려면 오류 규칙 또는 RaiseFault 정책을 사용하면 됩니다. 오류 규칙과 RaiseFault 정책의 차이점에 대한 자세한 내용은 FaultRules와 RaiseFault 정책 비교를 참조하세요. 오류 규칙과 RaiseFault 정책 모두에서 Condition 요소를 사용하여 조건을 확인해야 합니다. Apigee는 각 정책에 고유한 오류 변수를 제공하며 정책이 런타임 오류를 트리거할 때 오류 변수 값이 설정됩니다. 이러한 변수를 사용하여 특정 오류 조건을 확인하고 적절한 조치를 취할 수 있습니다. 오류 조건 확인에 대한 자세한 내용은 빌드 조건을 참조하세요.

다음 표에서는 이 정책과 관련된 오류 변수를 설명합니다.

변수	각 항목의 의미는 다음과 같습니다.	예시
`fault.name="FAULT_NAME"`	`FAULT_NAME`은 런타임 오류 표에 나열된 오류 이름입니다. 오류 이름은 오류 코드의 마지막 부분입니다.	`fault.name Matches "UnresolvedVariable"`
`setdialogflowresponse.POLICY_NAME.failed`	`POLICY_NAME`은 오류를 발생시킨 정책의 사용자 지정 이름입니다.	`setdialogflowresponse.My-Set-Dialogflow-Response.failed = true`

정책 오류에 대한 자세한 내용은 정책 오류에 대해 알아야 할 사항을 참조하세요.

SetDialogflowResponse 정책

개요

<SetDialogflowResponse>

예시

구문

SetDialogflowResponse 정책

웹훅 응답

하위 요소 참조

<DisplayName>

구문

예시

<Source>

구문

예시

<DialogflowVersion>

구문

예시

<IgnoreUnresolvedVariables>

구문

예시

<MergeBehavior>

구문

예시

<NaturalLanguageResponse>

<Parameters>

<Parameter>

구문

헤더 필드 값 추출

JSON 경로 값 추출

흐름 변수 값 추출

커스텀 텍스트 설정

<Phrases>

<Phrase>

구문

헤더 필드 값 추출

JSON 경로 값 추출

흐름 변수 값 추출

커스텀 텍스트 설정

<Header>

구문

예시 1

예시 2

<JSONPath>

구문

예시 1

예시 2

<Ref>

구문

예시 1

예시 2

<Value>

구문

예시 1

예시 2

오류 코드

런타임 오류

배포 오류

오류 변수

관련 주제

`<SetDialogflowResponse>`

`<DisplayName>`

`<Source>`

`<DialogflowVersion>`

`<IgnoreUnresolvedVariables>`

`<MergeBehavior>`

`<NaturalLanguageResponse>`

`<Parameters>`

`<Parameter>`

`<Phrases>`

`<Phrase>`

`<Header>`

`<JSONPath>`

`<Ref>`

`<Value>`