SkillHandler 클래스

  • 참조
패키지:
com.microsoft.bot.builder.skills
Maven 아티팩트:
com.microsoft.bot:bot-builder:4.14.3

public class SkillHandler
extends ChannelServiceHandler

기술에 대한 Bot Framework 처리기입니다.

필드 요약

한정자 및 형식 필드 및 설명
static final java.lang.String SKILL_CONVERSATION_REFERENCE_KEY

기술 대화 참조입니다.

생성자 요약

생성자 Description
SkillHandler(BotAdapter adapter, Bot bot, SkillConversationIdFactoryBase conversationIdFactory, CredentialProvider credentialProvider, AuthenticationConfiguration authConfig, ChannelProvider channelProvider)

자격 증명 공급자를 사용하여 SkillHandler 클래스의 새 인스턴스를 초기화합니다.

메서드 요약

한정자 및 형식 메서드 및 설명
protected java.util.concurrent.CompletableFuture<java.lang.Void> onDeleteActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId)

API를 삭제합니다.
protected java.util.concurrent.CompletableFuture<ResourceResponse> onReplyToActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

기술용 ToActivity() API에회신합니다.
protected java.util.concurrent.CompletableFuture<ResourceResponse> onSendToConversation(ClaimsIdentity claimsIdentity, String conversationId, Activity activity)

기술용ToConversation() API를 보냅니다.
protected java.util.concurrent.CompletableFuture<ResourceResponse> onUpdateActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

업데이트작업() API.

다음에서 상속된 메서드 ChannelServiceHandler

getChannelProvider handleCreateConversation handleDeleteActivity handleDeleteConversationMember handleGetActivityMembers handleGetConversationMembers handleGetConversationPagedMembers handleGetConversations handleReplyToActivity handleSendConversationHistory handleSendToConversation handleUpdateActivity handleUploadAttachment onCreateConversation onDeleteActivity onDeleteConversationMember onGetActivityMembers onGetConversationMembers onGetConversationPagedMembers onGetConversations onReplyToActivity onSendConversationHistory onSendToConversation onUpdateActivity onUploadAttachment

다음에서 상속된 메서드 java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

필드 세부 정보

SKILL_CONVERSATION_REFERENCE_KEY

public static final String SKILL_CONVERSATION_REFERENCE_KEY

기술 대화 참조입니다.

생성자 세부 정보

SkillHandler

public SkillHandler(BotAdapter adapter, Bot bot, SkillConversationIdFactoryBase conversationIdFactory, CredentialProvider credentialProvider, AuthenticationConfiguration authConfig, ChannelProvider channelProvider)

자격 증명 공급자를 사용하여 SkillHandler 클래스의 새 인스턴스를 초기화합니다.

매개 변수:

adapter - 요청을 처리할 BotAdapter 인스턴스입니다.
bot - IBot 인스턴스입니다.
conversationIdFactory - 대화 ID의 압축을 풀고 호출 봇에 매핑하는 SkillConversationIdFactoryBase.
credentialProvider - 자격 증명 공급자입니다.
authConfig - 인증 구성입니다.
channelProvider - 채널 공급자입니다. MiddlewareSet 개체를 사용하여 생성자에 여러 미들웨어 구성 요소를 추가합니다. Use(Middleware ) 메서드를 사용하여 생성 후 어댑터에 미들웨어를 추가합니다.

메서드 세부 정보

onDeleteActivity

protected CompletableFuture onDeleteActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId)

OnDeleteActivity() API. 이 메서드를 재정의하여 기존 활동을 삭제합니다. 일부 채널을 사용하면 기존 활동을 삭제할 수 있으며, 성공하면 이 메서드가 지정된 활동을 제거합니다.

재정의:

SkillHandler.onDeleteActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId)

매개 변수:

claimsIdentity
conversationId
activityId

onReplyToActivity

protected CompletableFuture onReplyToActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

기술용 ReplyToActivity() API입니다. 이 메서드를 사용하면 활동에 회신할 수 있습니다. SendToConversation()과 약간 다릅니다. * SendToConversation(conversationId) - 채널의 타임스탬프 또는 의미 체계에 따라 대화 끝에 활동을 추가합니다. * ReplyToActivity(conversationId,ActivityId) - 채널이 지원하는 경우 활동을 다른 활동에 회신으로 추가합니다. 채널이 중첩된 회신을 지원하지 않는 경우 ReplyToActivity는 SendToConversation으로 돌아갑니다. 대화의 특정 활동에 회신할 때 ReplyToActivity를 사용합니다. 다른 모든 경우에 SendToConversation을 사용합니다.

재정의:

SkillHandler.onReplyToActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

매개 변수:

claimsIdentity - 봇에 대한 claimsIdentity에는 AudienceClaim, AppIdClaim 및 ServiceUrlClaim이 있어야 합니다.
conversationId - 대화 ID입니다.
activityId - activityId 회신입니다(선택 사항).
activity - 보낼 활동입니다.

반환:

리소스 응답에 대한 작업입니다.

onSendToConversation

protected CompletableFuture onSendToConversation(ClaimsIdentity claimsIdentity, String conversationId, Activity activity)

기술용 SendToConversation() API입니다. 이 메서드를 사용하면 대화가 끝날 때까지 활동을 보낼 수 있습니다. ReplyToActivity()와 약간 다릅니다. * SendToConversation(conversationId) - 채널의 타임스탬프 또는 의미 체계에 따라 대화 끝에 활동을 추가합니다. * ReplyToActivity(conversationId,ActivityId) - 채널이 지원하는 경우 활동을 다른 활동에 회신으로 추가합니다. 채널이 중첩된 회신을 지원하지 않는 경우 ReplyToActivity는 SendToConversation으로 돌아갑니다. 대화의 특정 활동에 회신할 때 ReplyToActivity를 사용합니다. 다른 모든 경우에 SendToConversation을 사용합니다.

재정의:

SkillHandler.onSendToConversation(ClaimsIdentity claimsIdentity, String conversationId, Activity activity)

매개 변수:

claimsIdentity - 봇에 대한 claimsIdentity에는 AudienceClaim, AppIdClaim 및 ServiceUrlClaim이 있어야 합니다.
conversationId - conversationId.
activity - 보낼 활동입니다.

반환:

리소스 응답에 대한 작업입니다.

onUpdateActivity

protected CompletableFuture onUpdateActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

OnUpdateActivity() API. 이전에 보낸 기존 활동을 편집하려면 이 메서드를 재정의합니다. 일부 채널을 사용하면 기존 활동을 편집하여 봇 대화의 새 상태를 반영할 수 있습니다. 예를 들어 누군가가 "승인" 단추를 클릭한 후 단추를 제거할 수 있습니다.

재정의:

SkillHandler.onUpdateActivity(ClaimsIdentity claimsIdentity, String conversationId, String activityId, Activity activity)

매개 변수:

claimsIdentity
conversationId
activityId
activity

적용 대상