botbuilder package

BotFrameworkAdapter
BotFrameworkHttpClient
ChannelServiceHandler
ChannelServiceHandlerBase

ChannelServiceHandlerBase 实现 API 以将活动转发到技能,并通过机器人/适配器实现从技能向上路由 ChannelAPI 调用。

ChannelServiceRoutes

使用 ChannelServiceHandler 方法路由 API 调用。

CloudAdapter

实现 Bot Framework 协议的适配器,可以托管在不同的云环境(公共环境和专用环境)。

CloudChannelServiceHandler

一个类,可帮助使用 BotFrameworkAuthentication实现 Bot Framework 协议。

EventFactory

包含用于创建各种事件类型的实用工具方法。

FileTranscriptStore

文件脚本存储将脚本存储在文件系统中,每个活动都作为文件存储。

HandoffEventNames

定义交接事件名称的值。

InspectionMiddleware

用于模拟器检查运行时活动和 BotState 的 InspectionMiddleware。

InspectionState

InspectionState 供 InspectionMiddleware 用于模拟器检查运行时活动和 BotState。

RouteConstants

表示紧跟 basePath 的 API 路径的常量。 这些目前是内部的,但我们将来将重新评估使其公开。

示例

RouteConstants.Activities = '/v3/conversations/:conversationId/activities'。

SetSpeakMiddleware

支持 DirectLine 语音和电话通道,以确保在 Activity Speak 属性上设置适当的 SSML 标记。

CloudSkillHandler

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

SkillHandler
SkillHandlerImpl
SkillHttpClient

BotFrameworkHttpClient 专用于用于封装对话 ID 生成的技能。

StatusCodeError

扩展错误以提供专用错误消息。

StreamingHttpClient

HttpClient 的实现,增加了与流式处理连接的兼容性。

TokenResolver

在活动附件中查找 OAuthCard,并对其执行操作

TeamsSSOTokenExchangeMiddleware

如果活动名称为 signin/tokenExchange,则此中间件将尝试交换令牌,并删除传入调用,确保只处理一个交换请求。 如果用户登录到多个 Teams 客户端,机器人可能会从每个客户端接收“signin/tokenExchange”。 特定用户登录的每个令牌交换请求将具有相同的 activity.value.id。

机器人只应处理其中一个令牌交换请求。 其他人返回 StatusCodes.PRECONDITION_FAILED。 对于生产中的分布式机器人,这需要分布式存储,确保只处理一个令牌交换。 此中间件支持在 botbuilder-azure 或 MemoryStorage 中找到用于本地开发的 CosmosDb 存储。

TeamsActivityHandler

添加了对 Microsoft Teams 特定事件和交互的支持。

TeamsInfo

为Microsoft Teams 中发生的事件和交互提供实用工具方法。

接口

BotFrameworkAdapterSettings
BotFrameworkHttpAdapter
WebServer

表示 Express 应用程序或 Restify 服务器的接口。

ConnectorClientBuilder

用于生成连接器客户端的抽象。

Request

表示 Node.js HTTP 请求,包括最少的使用属性集。 与 Restify、Express 和 Node.js core http 兼容。

Response
WebRequest

表示 Express 或 Restify 请求对象。 此接口支持框架,不应直接为代码调用。

WebResponse

表示 Express 或 Restify 响应对象。 此接口支持框架,不应直接为代码调用。

类型别名

RouteHandler

函数

validateAndFixActivity(Activity)

验证 活动 并设置时间戳字段的格式。

teamsGetChannelId(Activity)

Teams 的活动帮助程序方法。

teamsGetSelectedChannelId(Activity)

从当前活动获取团队选择的频道 ID。

teamsGetTeamId(Activity)

从当前 活动获取团队 ID。

teamsGetTeamInfo(Activity)

从当前 活动获取 TeamsInfo 对象。

teamsGetTeamMeetingInfo(Activity)

从当前 活动获取 TeamsMeetingInfo 对象。

teamsGetTenant(Activity)

从当前 活动获取 TenantInfo 对象。

teamsNotifyUser(Partial<Activity>, boolean, string)

配置当前 活动 以在 Teams 中生成通知。

函数详细信息

validateAndFixActivity(Activity)

验证 活动 并设置时间戳字段的格式。

function validateAndFixActivity(activity: Activity): Activity

参数

activity

Activity

(xref:botbuilder-core。要验证的活动。

返回

Activity

活动

teamsGetChannelId(Activity)

Teams 的活动帮助程序方法。

function teamsGetChannelId(activity: Activity): string | null

参数

activity

Activity

当前 活动

返回

string | null

当前 活动团队的频道 ID 或 null。

teamsGetSelectedChannelId(Activity)

从当前活动获取团队选择的频道 ID。

function teamsGetSelectedChannelId(activity: Activity): string

参数

activity

Activity

当前 活动

返回

string

当前活动的团队选择的频道或空字符串。

teamsGetTeamId(Activity)

从当前 活动获取团队 ID。

function teamsGetTeamId(activity: Activity): string | null

参数

activity

Activity

当前 活动

返回

string | null

当前 活动团队 ID 或 null。

teamsGetTeamInfo(Activity)

从当前 活动获取 TeamsInfo 对象。

function teamsGetTeamInfo(activity: Activity): TeamInfo | null

参数

activity

Activity

当前 活动

返回

TeamInfo | null

当前 活动团队的信息或 null。

teamsGetTeamMeetingInfo(Activity)

从当前 活动获取 TeamsMeetingInfo 对象。

function teamsGetTeamMeetingInfo(activity: Activity): TeamsMeetingInfo | null

参数

activity

Activity

当前 活动

返回

TeamsMeetingInfo | null

当前 活动团队会议信息或 null。

teamsGetTenant(Activity)

从当前 活动获取 TenantInfo 对象。

function teamsGetTenant(activity: Activity): TenantInfo | null

参数

activity

Activity

当前 活动

返回

TenantInfo | null

当前 活动的租户信息或 null。

teamsNotifyUser(Partial<Activity>, boolean, string)

配置当前 活动 以在 Teams 中生成通知。

function teamsNotifyUser(activity: Partial<Activity>, alertInMeeting?: boolean, externalResourceUrl?: string)

参数

activity

Partial<Activity>

当前 活动

alertInMeeting

boolean

发送到会议聊天,这将导致 Teams 客户端在通知弹出窗口和聊天线程中呈现它。

externalResourceUrl

string

指向外部资源的 URL。 必须包含在清单的有效域中。