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)

回复技能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

方法继承自 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 - 一个 SkillConversationIdFactoryBase,用于解压缩会话 ID 并将其映射到调用机器人。
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)

Skill 的 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

适用于