기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
UpdateIntent
인텐트에 대한 설정을 업데이트합니다.
요청 구문
PUT /bots/botId/botversions/botVersion/botlocales/localeId/intents/intentId/ HTTP/1.1
Content-type: application/json
{
"description": "string",
"dialogCodeHook": {
"enabled": boolean
},
"fulfillmentCodeHook": {
"enabled": boolean,
"fulfillmentUpdatesSpecification": {
"active": boolean,
"startResponse": {
"allowInterrupt": boolean,
"delayInSeconds": number,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
},
"timeoutInSeconds": number,
"updateResponse": {
"allowInterrupt": boolean,
"frequencyInSeconds": number,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
}
},
"postFulfillmentStatusSpecification": {
"failureResponse": {
"allowInterrupt": boolean,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
},
"successResponse": {
"allowInterrupt": boolean,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
},
"timeoutResponse": {
"allowInterrupt": boolean,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
}
}
},
"inputContexts": [
{
"name": "string"
}
],
"intentClosingSetting": {
"active": boolean,
"closingResponse": {
"allowInterrupt": boolean,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
}
},
"intentConfirmationSetting": {
"active": boolean,
"declinationResponse": {
"allowInterrupt": boolean,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
},
"promptSpecification": {
"allowInterrupt": boolean,
"maxRetries": number,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
}
},
"intentName": "string",
"kendraConfiguration": {
"kendraIndex": "string",
"queryFilterString": "string",
"queryFilterStringEnabled": boolean
},
"outputContexts": [
{
"name": "string",
"timeToLiveInSeconds": number,
"turnsToLive": number
}
],
"parentIntentSignature": "string",
"sampleUtterances": [
{
"utterance": "string"
}
],
"slotPriorities": [
{
"priority": number,
"slotId": "string"
}
]
}URI 요청 파라미터
요청은 다음의 URI 파라미터를 사용합니다.
- botId
-
인텐트가 포함된 봇의 식별자입니다.
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$: 필수 예
- botVersion
-
인텐트가 포함된 봇 버전입니다.
DRAFT여야 합니다.길이 제약 조건: 고정 길이 5입니다.
Pattern:
^DRAFT$: 필수 예
- intentId
-
업데이트할 의도의 고유한 식별자입니다.
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$: 필수 예
- localeId
-
이 인텐트가 사용되는 언어 및 로케일의 식별자입니다. 문자열은 지원되는 로케일 중 하나와 일치해야 합니다. 자세한 내용은 단원을 참조하십시오.지원되는 언어.
: 필수 예
요청 본문
요청은 JSON 형식의 다음 데이터를 받습니다.
- description
-
의도의 새 설명입니다.
Type: 문자열
길이 제약 조건: 최소 길이 0. 최대 길이는 200입니다.
: 필수 아니요
- dialogCodeHook
-
봇과의 대화 전환마다 사용할 새로운 Lambda 함수입니다.
유형: DialogCodeHookSettings 객체
: 필수 아니요
- fulfillmentCodeHook
-
필요한 모든 인텐트 슬롯이 제공되고 인텐트가 이행될 준비가 되었을 때 호출할 새로운 Lambda 함수입니다.
유형: FulfillmentCodeHookSettings 객체
: 필수 아니요
- inputContexts
-
Amazon Lex가 인텐트를 고려하기 위해 활성화되어야 하는 새로운 컨텍스트 목록입니다.
Type: 배열InputContext사물
배열 멤버: 최소 항목 수 0개. 최대 항목 수는 5개.
: 필수 아니요
- intentClosingSetting
-
인텐트가 닫힐 때 Amazon Lex가 사용자에게 보내는 새로운 응답입니다.
유형: IntentClosingSetting 객체
: 필수 아니요
- intentConfirmationSetting
-
인텐트 완료를 확인하기 위해 Amazon Lex가 사용자에게 보내는 새로운 프롬프트입니다.
유형: IntentConfirmationSetting 객체
: 필수 아니요
- intentName
-
의도의 새 이름입니다.
Type: 문자열
길이 제약 조건: 최소 길이는 1이고, 최대 길이는 100입니다.
Pattern:
^([0-9a-zA-Z][_-]?)+$: 필수 예
- kendraConfiguration
-
Amazon Kendra 인덱스에 연결하기 위한 새로운 구성 설정입니다.
유형: KendraConfiguration 객체
: 필수 아니요
- outputContexts
-
인텐트가 이행될 때 Amazon Lex가 활성화하는 새로운 컨텍스트 목록입니다.
Type: 배열OutputContext사물
배열 멤버: 최소 항목 수 0개. 최대 항목 수는 10개입니다.
: 필수 아니요
- parentIntentSignature
-
이 인텐트의 부모로 사용할 새로운 빌트인 인텐트의 서명입니다.
Type: 문자열
: 필수 아니요
- sampleUtterances
-
인텐트를 호출하는 데 사용되는 새로운 발언입니다.
Type: 배열SampleUtterance사물
: 필수 아니요
- slotPriorities
-
인텐트에 포함된 슬롯의 새로운 목록과 우선 순위
Type: 배열SlotPriority사물
: 필수 아니요
응답 구문
HTTP/1.1 200
Content-type: application/json
{
"botId": "string",
"botVersion": "string",
"creationDateTime": number,
"description": "string",
"dialogCodeHook": {
"enabled": boolean
},
"fulfillmentCodeHook": {
"enabled": boolean,
"fulfillmentUpdatesSpecification": {
"active": boolean,
"startResponse": {
"allowInterrupt": boolean,
"delayInSeconds": number,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
},
"timeoutInSeconds": number,
"updateResponse": {
"allowInterrupt": boolean,
"frequencyInSeconds": number,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
}
},
"postFulfillmentStatusSpecification": {
"failureResponse": {
"allowInterrupt": boolean,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
},
"successResponse": {
"allowInterrupt": boolean,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
},
"timeoutResponse": {
"allowInterrupt": boolean,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
}
}
},
"inputContexts": [
{
"name": "string"
}
],
"intentClosingSetting": {
"active": boolean,
"closingResponse": {
"allowInterrupt": boolean,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
}
},
"intentConfirmationSetting": {
"active": boolean,
"declinationResponse": {
"allowInterrupt": boolean,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
},
"promptSpecification": {
"allowInterrupt": boolean,
"maxRetries": number,
"messageGroups": [
{
"message": {
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
},
"variations": [
{
"customPayload": {
"value": "string"
},
"imageResponseCard": {
"buttons": [
{
"text": "string",
"value": "string"
}
],
"imageUrl": "string",
"subtitle": "string",
"title": "string"
},
"plainTextMessage": {
"value": "string"
},
"ssmlMessage": {
"value": "string"
}
}
]
}
]
}
},
"intentId": "string",
"intentName": "string",
"kendraConfiguration": {
"kendraIndex": "string",
"queryFilterString": "string",
"queryFilterStringEnabled": boolean
},
"lastUpdatedDateTime": number,
"localeId": "string",
"outputContexts": [
{
"name": "string",
"timeToLiveInSeconds": number,
"turnsToLive": number
}
],
"parentIntentSignature": "string",
"sampleUtterances": [
{
"utterance": "string"
}
],
"slotPriorities": [
{
"priority": number,
"slotId": "string"
}
]
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- botId
-
인텐트가 포함된 봇의 식별자입니다.
Type: 문자열
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$ - botVersion
-
인텐트가 포함된 봇 버전입니다. 는 항상 있을 것입니다
DRAFT.Type: 문자열
길이 제약 조건: 고정 길이 5입니다.
Pattern:
^DRAFT$ - creationDateTime
-
의도가 생성된 시기의 타임스탬프입니다.
Type: 타임스탬프
- description
-
인텐트에 대한 업데이트된 설명입니다.
Type: 문자열
길이 제약 조건: 최소 길이 0. 최대 길이는 200입니다.
- dialogCodeHook
-
사용자와의 대화가 시작될 때마다 호출되는 업데이트된 Lambda 함수입니다.
유형: DialogCodeHookSettings 객체
- fulfillmentCodeHook
-
인텐트가 이행될 준비가 되었을 때 호출되는 업데이트된 Lambda 함수입니다.
유형: FulfillmentCodeHookSettings 객체
- inputContexts
-
Amazon Lex에서 인텐트를 고려하기 위해 활성화되어야 하는 업데이트된 컨텍스트 목록입니다.
Type: 배열InputContext사물
배열 멤버: 최소 항목 수 0개. 최대 항목 수는 5개.
- intentClosingSetting
-
인텐트가 닫힐 때 Amazon Lex가 사용자에게 보내는 업데이트된 응답입니다.
유형: IntentClosingSetting 객체
- intentConfirmationSetting
-
Amazon Lex가 인텐트 완료를 확인하기 위해 사용자에게 보내는 업데이트된 프롬프트입니다.
유형: IntentConfirmationSetting 객체
- intentId
-
업데이트된 의도의 식별자입니다.
Type: 문자열
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$ - intentName
-
의도의 업데이트된 이름입니다.
Type: 문자열
길이 제약 조건: 최소 길이는 1이고, 최대 길이는 100입니다.
Pattern:
^([0-9a-zA-Z][_-]?)+$ - kendraConfiguration
-
Amazon Kendra 인덱스에 연결하기 위한 업데이트된 구성
AMAZON.KendraSearchIntent의도.유형: KendraConfiguration 객체
- lastUpdatedDateTime
-
의도가 마지막으로 수정된 시간의 타임스탬프입니다.
Type: 타임스탬프
- localeId
-
인텐트의 업데이트된 언어와 로캘입니다.
Type: 문자열
- outputContexts
-
인텐트가 이행될 때 Amazon Lex가 활성화하는 업데이트된 컨텍스트 목록입니다.
Type: 배열OutputContext사물
배열 멤버: 최소 항목 수 0개. 최대 항목 수는 10개입니다.
- parentIntentSignature
-
이 인텐트의 부모인 업데이트된 내장 인텐트입니다.
Type: 문자열
- sampleUtterances
-
인텐트에 대한 업데이트된 샘플 발언 목록입니다.
Type: 배열SampleUtterance사물
- slotPriorities
-
업데이트된 슬롯 목록 및 인텐트에 대해 사용자로부터 유도된 해당 우선 순위
Type: 배열SlotPriority사물
오류
모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.
- ConflictException
-
리소스가 충돌하는 상태이므로 수행하려고 시도한 작업을 완료할 수 없습니다. 예를 들어 CREATING 상태에 있는 봇을 삭제할 수 있습니다. 요청을 다시 시도하십시오.
HTTP 상태 코드: 409
- InternalServerException
-
서비스에 예상치 못한 조건이 발생했습니다. 요청을 다시 시도하십시오.
HTTP 상태 코드: 500
- PreconditionFailedException
-
하나 이상의 요청 필드가 유효하지 않기 때문에 요청을 완료할 수 없습니다. 요청의 필드를 확인하고 다시 시도하십시오.
HTTP 상태 코드: 412
- ServiceQuotaExceededException
-
봇에 대한 할당량에 도달했습니다.
HTTP 상태 코드: 402
- ThrottlingException
-
요청량이 너무 높습니다. 요청 횟수를 줄입니다.
HTTP 상태 코드: 429
- ValidationException
-
요청의 입력 매개 변수 중 하나가 잘못되었습니다. 파라미터를 확인하고 요청을 다시 시도하십시오.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
