Conceptos básicos de bot
- Tiempo de lectura: 9 minutos
Se trata de una introducción que se basa en el artículo sobre Cómo funcionan los bots en la documentación principal del marco de bot. Puede que le resulte útil el artículo y los otros artículos de la sección conceptos .
La diferencia principal en los bots desarrollados para Microsoft Teams es la forma en que se administran las actividades. El controlador de actividades de Microsoft Teams se deriva del controlador de actividad del marco de robots para enrutar todas las actividades de Teams antes de permitir que se controlen actividades específicas que no pertenecen a teams.
Controladores de actividades de Microsoft Teams
Cuando un bot para Microsoft Teams recibe una actividad, lo pasa a sus controladores de actividad. En las cubiertas, hay un controlador base denominado el controlador de torneado, al que se redirigen todas las actividades. El controlador de torneado llama al controlador de actividades necesario para controlar cualquier tipo de actividad que se haya recibido. La diferencia entre un bot diseñado para Microsoft Teams es que se deriva de TeamsActivityHandler la clase derivada de la clase del ActivityHandler marco de robots.
Como con cualquier bot creado mediante Microsoft bot Framework, si el bot recibe una actividad de mensaje, el controlador de torneado ve esa actividad entrante y la OnMessageActivityAsync envía al controlador de actividad. En Teams, esta funcionalidad sigue siendo la misma. Si el bot recibe una actividad de actualización de conversación, el controlador de torneado ve esa actividad entrante y OnConversationUpdateActivityAsync la envía al controlador de actividad de Microsoft Teams que primero comprobará los eventos específicos de Microsoft Teams y los pasa al controlador de actividad del marco de bot si no se encuentra ninguno.
En la clase del controlador de actividad de Microsoft Teams, hay dos controladores de OnConversationUpdateActivityAsync actividad principales de teams que enrutan todas las actividades de actualización de la conversación y OnInvokeActivityAsync que enrutan todas las actividades de invocación de Teams.
Para implementar la lógica de los controladores de actividades específicos de Teams, invalide estos métodos en el bot, tal como se muestra en la sección lógica de bot a continuación. Para cada uno de estos controladores, no hay ninguna implementación base, así que solo agregue la lógica que desee en su reemplazo.
Lógica de bot
La lógica de bot procesa las actividades entrantes de uno o varios de los canales de robot y genera actividades de salida en respuesta. Esto sigue siendo el caso de los bots derivados de la clase del controlador de actividad de Microsoft Teams, que primero comprueba las actividades de Microsoft Teams y, a continuación, pasa todas las demás actividades al controlador de actividad de los marcos de bot.
Controladores de Framework bot principales
Todos los controladores de actividades que se describen a continuación seguirán funcionando como lo hacen con un bot que no es de Microsoft Teams, con la excepción de controlar los miembros agregados y las actividades eliminadas por los miembros, éstos serán distintos en el contexto de un equipo, donde el nuevo miembro se agrega al equipo en lugar de a un hilo de mensaje.
Los controladores definidos en ActivityHandler se describen a continuación.
| Evento | Controlador | Descripción |
|---|---|---|
| Cualquier tipo de actividad recibido | OnTurnAsync |
Llama a uno de los otros controladores, en función del tipo de actividad que se ha recibido. |
| Actividad de mensaje recibida | OnMessageActivityAsync |
Invalide esto para Message controlar una actividad. |
| Actividad de actualización de conversación recibida | OnConversationUpdateActivityAsync |
En una ConversationUpdate actividad, llama a un controlador si los miembros que no son el bot se unen a la conversación o la dejan. |
| Los miembros que no son de bot se unieron a la conversación | OnMembersAddedAsync |
Invalide esto para controlar los miembros que se unen a una conversación. |
| Los miembros que no son de bot dejan la conversación | OnMembersRemovedAsync |
Invalide esto para controlar a los miembros que abandonen una conversación. |
| Actividad de evento recibida | OnEventActivityAsync |
En una Event actividad, llama a un controlador específico para el tipo de evento. |
| Actividad de evento de respuesta de token-respuesta recibida | OnTokenResponseEventAsync |
Invalide esto para controlar los eventos de respuesta de token. |
| Actividad de evento que no es de respuesta de tokens recibida | OnEventAsync |
Invalide esto para controlar otros tipos de eventos. |
| Se recibió otro tipo de actividad | OnUnrecognizedActivityTypeAsync |
Invalide esto para controlar cualquier tipo de actividad no controlado de otro modo. |
Controladores específicos de Teams
El TeamsActivityHandler extiende la lista de controladores anteriores para incluir lo siguiente:
| Evento | Controlador | Descripción |
|---|---|---|
| channelCreated | OnTeamsChannelCreatedAsync |
Invalide esto para controlar el canal de teams que se está creando. Para obtener más información, consulte Channel created in Conversation Update Events. |
| channelDeleted | OnTeamsChannelDeletedAsync |
Invalide esto para controlar el canal de Microsoft teams que se va a eliminar. Para obtener más información, consulte canal eliminado en eventos de actualización de conversación. |
| channelRenamed | OnTeamsChannelRenamedAsync |
Invalide esto para controlar el canal de un canal de Microsoft Teams. Para obtener más información, consulte canal con nombre cambiado en Conversation Update Events. |
| teamRenamed | OnTeamsTeamRenamedAsync |
return Task.CompletedTask;Invalide esto para administrar el cambio de nombre de un equipo de Teams. Para obtener más información, vea cambio de nombre de equipo en eventos de actualización de conversaciones. |
| MembersAdded | OnTeamsMembersAddedAsync |
Llama al OnMembersAddedAsync método en ActivityHandler. Invalide esto para controlar a los miembros que se unen a un equipo. Para obtener más información, vea miembros del equipo agregados en eventos de actualización de conversación. |
| MembersRemoved | OnTeamsMembersRemovedAsync |
Llama al OnMembersRemovedAsync método en ActivityHandler. Invalide esto para controlar a los miembros que salen de un equipo. Para obtener más información, vea miembros del equipo quitados en eventos de actualización de conversaciones. |
Actividades de invocación de Microsoft Teams
A continuación, se muestra una lista de todos los controladores de actividad de Teams a los que se llama desde el OnInvokeActivityAsync controlador de actividad de Microsoft Teams :
| Tipos de invocación | Controlador | Descripción |
|---|---|---|
| CardAction. Invoke | OnTeamsCardActionInvokeAsync |
Invocar acción de tarjeta de equipo. |
| fileConsent/Invoke | OnTeamsFileConsentAcceptAsync |
Aceptación del consentimiento del archivo de Microsoft Teams. |
| fileConsent/Invoke | OnTeamsFileConsentAsync |
Consentimiento del archivo de Teams. |
| fileConsent/Invoke | OnTeamsFileConsentDeclineAsync |
Consentimiento del archivo de Teams. |
| actionableMessage/executeAction | OnTeamsO365ConnectorCardActionAsync |
Acción de la tarjeta del conector de O365 de Teams. |
| Inicio de sesión/verifyState | OnTeamsSigninVerifyStateAsync |
El estado de comprobación de inicio de sesión de Microsoft Teams. |
| tarea/recopilación | OnTeamsTaskModuleFetchAsync |
Búsqueda de módulos de tareas de Microsoft Teams. |
| tarea o envío | OnTeamsTaskModuleSubmitAsync |
Envío del módulo de tareas de Microsoft Teams. |
Las actividades de invocación enumeradas anteriormente son para bots de conversación en Microsoft Teams. El SDK de bot Framework también admite invocaciones específicas de las extensiones de mensajería. Para obtener más información, consulte What is Messaging Extensions