这篇文章我们来说一下Activity和Turn这两个bot framework中最重要的两个概念，同时也介绍一下TurnContext和BotAdapter

Activity

一个activity是聊天双方的一个信息载体，它可以是一条消息，也可以是一个动作。比如用户给bot发送一条文字消息，这就是一个activity，bot给用户回复一张图片，那这是另一个activity。

Activity是bot framework里最重要的概念，让我们来一起看一下c# sdk里对activity的定义。真实感受一下

    public class Activity{public string Type { get; set; }public string Id { get; set; }public DateTimeOffset? Timestamp { get; set; }public DateTimeOffset? LocalTimestamp { get; set; }public string LocalTimezone { get; set; }public string ServiceUrl { get; set; }public string ChannelId { get; set; }public ChannelAccount From { get; set; }public ConversationAccount Conversation { get; set; }public ChannelAccount Recipient { get; set; }public string TextFormat { get; set; }public string AttachmentLayout { get; set; }public IList<ChannelAccount> MembersAdded { get; set; }public IList<ChannelAccount> MembersRemoved { get; set; }public IList<MessageReaction> ReactionsAdded { get; set; }public IList<MessageReaction> ReactionsRemoved { get; set; }public string TopicName { get; set; }public bool? HistoryDisclosed { get; set; }public string Locale { get; set; }public string Text { get; set; }public string Speak { get; set; }public string InputHint { get; set; }public string Summary { get; set; }public SuggestedActions SuggestedActions { get; set; }public IList<Attachment> Attachments { get; set; }public IList<Entity> Entities { get; set; }public object ChannelData { get; set; }public string Action { get; set; }public string ReplyToId { get; set; }public string Label { get; set; }public string ValueType { get; set; }public object Value { get; set; }public string Name { get; set; }public ConversationReference RelatesTo { get; set; }public string Code { get; set; }public DateTimeOffset? Expiration { get; set; }public string Importance { get; set; }public string DeliveryMode { get; set; }public IList<string> ListenFor { get; set; }public IList<TextHighlight> TextHighlights { get; set; }public SemanticAction SemanticAction { get; set; }public string CallerId { get; set; }}

除了上面这么多的属性，还有很多方法和扩展方法，是一个非常大的类，我们以后详细一一说明。

Turn

下面是对于turn的官方说明：

In a conversation, people often speak one-at-a-time, taking turns speaking. With a bot, it generally reacts to user input. Within the Bot Framework SDK, a turn consists of the user’s incoming activity to the bot and any activity the bot sends back to the user as an immediate response. You can think of a turn as the processing associated with the arrival of a given activity.

一个turn就是对一个activity的相关处理。比如说，对于用户发给我们bot一条消息，我们把这条消息转发给另一个用户，同时对消息本身点赞，那这两个操作一起是一个turn，是针对用户发来的消息的处理的turn。

Turn上下文(Turn Context)

我认为TurnContext是仅次于Activity的概念，turn context对象跟随着整个消息的处理过程。地位非常类似以前asp.net的HttpContext概念。

    public interface ITurnContext{BotAdapter Adapter { get; }TurnContextStateCollection TurnState { get; }Activity Activity { get; }bool Responded { get; }Task<ResourceResponse> SendActivityAsync(...);Task<ResourceResponse> UpdateActivityAsync(...);Task DeleteActivityAsync(...);ITurnContext OnSendActivities(...);ITurnContext OnUpdateActivity(...);ITurnContext OnDeleteActivity(...);}

可以看到TurnContext不算庞大，其他的属性和方法看名字比较容易理解。其中一个主要概念是BotAdapter

BotAdapter

从官方说明，我们可以看到这个是链接你bot endpoint和bot处理逻辑的一个桥梁，它封装了对于安全验证和对middleware的处理。当你的bot endpoint收到一个请求时，BotAdapter会验证这个请求是不是从正式渠道发送来的请求，如果是，它会创建Turn Context，然后开始各个middleware的处理。

要注意的一点是：Activity是贯穿于Azure bot service和bot framework sdk整条pipeline的，但是turn，turn context和BotAdapter，目前版本（v4）只是存在于bot framework sdk，是帮助开发人员处理bot的一个东西，如果你不想用turn，想自己处理整个bot的聊天，你可以只使用 Microsoft.Bot.Schema（包含Activity定义），不添加Microsoft.Bot.Builder库（含有turncontext和BotAdapter定义）。