SkillHandler 类

包:

com.microsoft.bot.builder.skills

Maven 项目:

com.microsoft.bot:bot-builder:4.14.3

• java.lang.Object
• • com.microsoft.bot.builder.ChannelServiceHandler
  • • com.microsoft.bot.builder.skills.SkillHandler

public class SkillHandler
extends ChannelServiceHandler

用于技能的 Bot Framework 处理程序。

字段摘要

修饰符和类型	字段和描述
static final java.lang.String	SKILL_CONVERSATION_REFERENCE_KEY 技能对话参考。

构造函数摘要

构造函数	说明
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) ReplyToActivity () API for Skill。
protected java.util.concurrent.CompletableFuture<ResourceResponse>	onSendToConversation(ClaimsIdentity claimsIdentity, String conversationId, Activity activity) 发送ToConversation () API for Skill。
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 。

Parameters:

adapter - 将处理请求的 的实例 BotAdapter 。

bot - IBot 实例。

conversationIdFactory - 一个 ， SkillConversationIdFactoryBase 用于解包聊天 ID 并将其映射到调用机器人。

credentialProvider - 凭据提供程序。

authConfig - 身份验证配置。

channelProvider - 通道提供程序。 MiddlewareSet使用 Object 在构造函数中添加多个中间件组件。 使用 Use (Middleware ) 方法在构造后向适配器添加其他中间件。

方法详细信息

onDeleteActivity

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

OnDeleteActivity () API。 重写此方法以删除现有活动。 某些通道允许删除现有活动，如果成功，此方法将删除指定的活动。

Overrides:

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

Parameters:

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。

Overrides:

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

Parameters:

claimsIdentity - 机器人的 claimsIdentity 应具有 AudienceClaim、AppIdClaim 和 ServiceUrlClaim。

conversationId - 对话 ID。

activityId - activityId 答复 (OPTIONAL) 。

activity - 要发送的活动。

Returns:

资源响应的任务。

onSendToConversation

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

SendToConversation () API for Skill。 此方法允许将活动发送到会话的末尾。 这与 ReplyToActivity () 略有不同。 * SendToConversation (conversationId) - 将根据通道的时间戳或语义将活动追加到会话的末尾。 * ReplyToActivity (conversationId，ActivityId) - 将活动作为回复添加到另一个活动（如果通道支持）。 如果通道不支持嵌套答复，则 ReplyToActivity 将回退到 SendToConversation。 回复聊天中的特定活动时，请使用 ReplyToActivity。 在所有其他情况下使用 SendToConversation。

Overrides:

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

Parameters:

claimsIdentity - 机器人的 claimsIdentity 应具有 AudienceClaim、AppIdClaim 和 ServiceUrlClaim。

conversationId - conversationId。

activity - 要发送的活动。

Returns:

资源响应的任务。

onUpdateActivity

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

OnUpdateActivity () API。 重写此方法可编辑以前发送的现有活动。 某些通道允许编辑现有活动，以反映机器人聊天的新状态。 例如，可以在某人单击“批准”按钮后删除按钮。

Overrides:

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

Parameters:

claimsIdentity

conversationId

activityId

activity