Descripción de los conceptos del bot

Las interacciones de un bot pueden usar texto, voz, imágenes o vídeo. Procesa la entrada del usuario para comprender su solicitud y evalúa la entrada para realizar las tareas pertinentes. Un bot puede solicitar información o habilitar el acceso a los servicios y responde al usuario.

Ámbitos de bot

Los bots en Microsoft Teams pueden formar parte de una conversación uno a uno, de un chat de grupo o de un canal de un equipo. Cada ámbito proporciona oportunidades y dificultades únicas para su bot de conversación.

En un canal

Los canales contienen conversaciones en subprocesos entre varias personas, incluso hasta 2000. Esto proporciona un alcance potencialmente masivo al bot, pero las interacciones individuales deben ser concretas. Las interacciones tradicionales de varios turnos no funcionan. En su lugar, debe buscar usar tarjetas o diálogos interactivos (denominados módulos de tareas en TeamsJS v1.x) o mover la conversación a una conversación uno a uno para recopilar mucha información. El bot solo tiene acceso a los mensajes en los que es @mentioned. Puede recuperar mensajes adicionales de la conversación con Microsoft Graph y los permisos a nivel de organización.

Los bots funcionan mejor en un canal en los siguientes casos:

• Notificaciones, especialmente si se proporciona una tarjeta interactiva para que los usuarios puedan obtener información adicional.
• Escenarios de comentarios, como sondeos y encuestas.
• El ciclo de solicitud o respuesta única resuelve las interacciones y los resultados son útiles para varios miembros de la conversación.
• Bots sociales o divertidos, donde hay imágenes de gatos geniales, se elige aleatoriamente un ganador, etc.

En un chat de grupo

Los chats de grupo son conversaciones entre tres o más personas que no se desarrollan en hilos. Tienden a tener menos miembros que un canal y son más transitorios. De forma similar a un canal, el bot solo tiene acceso a los mensajes donde está @mentioned directamente.

Los bots que funcionan mejor en un canal también funcionan mejor en un chat de grupo.

En un chat individual

Esta es la manera tradicional en la que un bot de conversación interactúa con un usuario. Algunos ejemplos de bots conversacionales individuales son:

• Bots de Q&A
• bots que inician flujos de trabajo en otros sistemas.
• bots que cuentan chistes.
• bots que toman notas. Antes de crear bots de chat uno a uno, considere si una interfaz basada en conversación es la mejor manera de presentar la funcionalidad.

Controlador de actividad y lógica de bot

Para crear una aplicación de bot que satisfaga sus necesidades, es esencial comprender el controlador de actividad y la lógica del bot de Microsoft Teams. Estos dos componentes clave funcionan juntos para organizar la lógica conversacional.

• Controlador de actividad de Teams: procesa eventos e interacciones específicos de Teams, como la creación de canales, adiciones de miembros del equipo y otras acciones exclusivas del entorno de Teams. En el SDK de Teams v2, los controladores se registran directamente en una App instancia en lugar de mediante la herencia de clases.

• Lógica del bot: el App objeto contiene la lógica conversacional del bot y es responsable de tomar decisiones basadas en la entrada del usuario. Las actividades entrantes se enrutan al controlador adecuado según el tipo de actividad y la coincidencia de patrones opcional.

Controlador de actividad de Teams

El controlador de actividad es el núcleo de la funcionalidad de un bot, la administración y el procesamiento de las interacciones del usuario. En el SDK de Teams v2:

• Crea una instancia de un App objeto y registra controladores en él.
• Los controladores reciben un objeto de contexto con tipo (IActivityContext en TypeScript, IContext<TActivity> en C#, ActivityContext[TActivity] en Python).
• Las respuestas y los mensajes proactivos se envían a través de ctx.reply() o ctx.send().

Cuando un bot de Teams recibe una actividad, el SDK la enruta a través del controlador registrado. Los eventos específicos de Teams (ciclo de vida del canal, cambios de miembros, etc.) se exponen como eventos con nombre distintos, por lo que no es necesario inspeccionar channelData.eventType manualmente.

Fragmentos de código del controlador de actividad

En los fragmentos de código siguientes se muestran los controladores de actividad de Teams para los eventos de ciclo de vida del canal y del equipo.

import { App } from '@microsoft/teams.apps';

const app = new App();

app.on('channelCreated', async ({ activity }) => {
  const channel = activity.channelData.channel; // { id, name }
  const team    = activity.channelData.team;    // { id, name }
  // Code logic here
});

app.on('channelDeleted', async ({ activity }) => {
  // Code logic here
});

app.on('channelRenamed', async ({ activity }) => {
  // Code logic here
});

app.on('teamRenamed', async ({ activity }) => {
  // Code logic here
});

app.on('membersAdded', async ({ activity, send }) => {
  for (const member of activity.membersAdded) {
    await send(`Welcome, ${member.name}!`);
  }
});

app.on('membersRemoved', async ({ activity }) => {
  // Code logic here
});

app.on('messageUpdate', async ({ activity }) => {
  // Code logic here
});

app.on('messageDelete', async ({ activity }) => {
  // activity.channelData.eventType === 'softDeleteMessage' for soft deletes
  // Code logic here
});

using Microsoft.Teams.Apps;

var app = new App();

app.OnChannelCreated(async context => {
    var channel = context.Activity.ChannelData.Channel;
    var team    = context.Activity.ChannelData.Team;
    // Code logic here
});

app.OnChannelDeleted(async context => {
    // Code logic here
});

app.OnChannelRenamed(async context => {
    // Code logic here
});

app.OnTeamRenamed(async context => {
    // Code logic here
});

app.OnMembersAdded(async context => {
    foreach (var member in context.Activity.MembersAdded) {
        // Code logic here
    }
});

app.OnMembersRemoved(async context => {
    foreach (var member in context.Activity.MembersRemoved) {
        // Code logic here
    }
});

app.OnMessageUpdate(async context => {
    // Code logic here
});

app.OnMessageDelete(async context => {
    // Code logic here
});

from microsoft_teams.apps import App, ActivityContext
from microsoft_teams.api.activities import ConversationUpdateActivity

app = App()

@app.on_channel_created
async def handle_channel_created(ctx: ActivityContext[ConversationUpdateActivity]):
    channel = ctx.activity.channel_data.channel
    team    = ctx.activity.channel_data.team
    # Code logic here

@app.on_channel_deleted
async def handle_channel_deleted(ctx: ActivityContext[ConversationUpdateActivity]):
    # Code logic here

@app.on_channel_renamed
async def handle_channel_renamed(ctx: ActivityContext[ConversationUpdateActivity]):
    # Code logic here

@app.on_team_renamed
async def handle_team_renamed(ctx: ActivityContext[ConversationUpdateActivity]):
    # Code logic here

@app.on_conversation_update
async def handle_conversation_update(ctx: ActivityContext[ConversationUpdateActivity]):
    if ctx.activity.members_added:
        for member in ctx.activity.members_added:
            await ctx.send(f"Welcome, {member.name}!")
    if ctx.activity.members_removed:
        # Code logic here

@app.on_edit_message
async def handle_edit_message(ctx: ActivityContext):
    # Code logic here

@app.on_soft_delete_message
async def handle_soft_delete_message(ctx: ActivityContext):
    # Code logic here

@app.on_undelete_message
async def handle_undelete_message(ctx: ActivityContext):
    # Code logic here

Ejemplo de controlador de actividad de bot

El código siguiente proporciona un ejemplo de una actividad de bot:

import { App } from '@microsoft/teams.apps';

const app = new App();

app.on('message', async ({ activity, reply }) => {
  const senderName = activity.from.name;
  await send(`Hello <at>${senderName}</at>.`);
});

app.start().catch(console.error);

using Microsoft.Teams.Apps.Activities;
using Microsoft.Teams.Apps.Extensions;
using Microsoft.Teams.Plugins.AspNetCore.DevTools.Extensions;
using Microsoft.Teams.Plugins.AspNetCore.Extensions;

var builder = WebApplication.CreateBuilder(args);
builder.AddTeams().AddTeamsDevTools();
var app = builder.Build();
var teams = app.UseTeams();

teams.OnMessage(async (context, cancellationToken) =>
{
    var senderName = context.Activity.From.Name;
    await context.Send($"Hello <at>{senderName}</at>.", cancellationToken);
});

app.Run();

import asyncio
from microsoft_teams.apps import App, ActivityContext
from microsoft_teams.api import MessageActivity

app = App()

@app.on_message
async def handle_message(ctx: ActivityContext[MessageActivity]):
    sender_name = ctx.activity.from_property.name
    await ctx.send(f"Hello <at>{sender_name}</at>.")

if __name__ == "__main__":
    asyncio.run(app.start())

Lógica del bot

La lógica del bot incorpora las reglas fundamentales y los marcos de toma de decisiones que dictan las acciones e interacciones de un bot. Describe cómo interpreta el bot la entrada del usuario, formula respuestas y participa en conversaciones.

En el SDK de Teams v2, la lógica del bot procesa las actividades entrantes desde uno o varios canales de bot y genera actividades salientes. La instancia controla todo el App enrutamiento de actividad: registra los controladores y el SDK les envía actividades automáticamente.

Ahora que se ha familiarizado con los controladores de actividad del bot, veamos cómo se comportan los bots de forma diferente en función de la conversación y de los mensajes que recibe o envía.

Recomendaciones

Un amplio diálogo entre el bot y el usuario es una manera lenta y compleja de completar una tarea. Un bot que admite comandos excesivos, especialmente una amplia gama de comandos, no es correcto o los usuarios no los ven de forma positiva.

• Evitar experiencias de varios turnos en el chat Un cuadro de diálogo extenso requiere que el desarrollador mantenga el estado. Para salir de este estado, un usuario debe agotar el tiempo de espera o seleccionar Cancelar. Además, el proceso es tedioso. Por ejemplo, consulte el siguiente escenario de conversación:

  USUARIO: Programe una reunión con Megan.

  BOT: he encontrado 200 resultados, incluidos el nombre y el apellido.

  USUARIO: Programe una reunión con Megan Bowen.

  BOT: Ok, ¿a qué hora le gustaría reunirse con Megan Bowen?

  USUARIO: 1:00 p.m.

  BOT: ¿En qué día?

• Compatibilidad con seis comandos o menos frecuentes Dado que solo hay seis comandos visibles en el menú del bot actual, es poco probable que se use nada más con cualquier frecuencia. Bots que profundizan en un área específica en lugar de tratar de ser un asistente de trabajo amplio y funcionan mejor.

• Optimizar el tamaño de knowledge base para una interacción más rápida Una de las desventajas de los bots es que es difícil mantener una gran knowledge base de recuperación con respuestas no clasificadas. Los bots son más adecuados para interacciones breves y rápidas y no para examinar listas largas en busca de una respuesta.

Exploración de otras características del bot

Además de las características de bot convencionales, también puede explorar las características avanzadas disponibles en una aplicación de bot de Teams:

• Obtenga el contexto específico de Teams para el bot.
• Llamadas y bots de reuniones en línea.
• Habilite el inicio de sesión único para la aplicación.

Ejemplo de código