Основные понятия бота

Бот может взаимодействовать с текстом, речью, изображениями или видео. Он обрабатывает входные данные пользователя для понимания его запроса и оценивает входные данные для выполнения соответствующих задач. Бот может запросить информацию или разрешить доступ к службам и ответить пользователю.

Области бота

Боты в Microsoft Teams могут быть частью личной беседы, группового чата или канала в команде. Каждая область предлагает уникальные возможности и задачи для вашего чат-бота

В канале

Каналы содержат потоковые беседы между несколькими людьми, даже до 2000. Это потенциально дает вашему боту огромный охват, но отдельные взаимодействия должны быть краткими. Традиционные многоэтапные взаимодействия не работают. Вместо этого необходимо использовать интерактивные карточки или диалоги (называемые модулями задач в TeamsJS версии 1.x) или переместить беседу в беседу "один к одному" для сбора большого количества сведений. Ваш бот имеет доступ только к сообщениям, где это @mentioned. Вы можете получить дополнительные сообщения из беседы с помощью Microsoft Graph и разрешений на уровне организации.

Боты лучше работают в канале в следующих случаях:

• Уведомления, где вы предоставляете пользователям интерактивную карту для получения дополнительной информации.
• Сценарии обратной связи, такие как опросы и исследования.
• Взаимодействия, решения которых можно получить в одном цикле из запроса и ответа, и результаты которых будут полезны для нескольких участников беседы.
• Социальные или забавные боты, где вы получаете классное изображение кота, случайным образом выбираете победителя и так далее.

В групповом чате

Групповые чаты — это не потоковые беседы между тремя или более пользователями. Как правило, у них меньше участников, чем у канала, и они более временные. Как и в случае с каналом, бот имеет доступ только к сообщениям, где он находится @mentioned непосредственно.

Боты, которые лучше работают в канале, также лучше работают в групповом чате.

В индивидуальном чате

Индивидуальный чат — это традиционный способ общения бота с пользователем. Вот несколько примеров диалоговых ботов для индивидуальной беседы:

• Боты для вопросов и ответов
• боты, инициирующие рабочие процессы в других системах.
• боты, которые говорят шутки.
• боты, которые принимают заметки. Прежде чем создавать чат-боты "один к одному", подумайте, является ли интерфейс на основе беседы лучшим способом представить свои функции.

Обработчик действий и логика бота

Чтобы создать приложение бота, соответствующее вашим потребностям, важно понимать обработчик действий Microsoft Teams и логику бота. Эти два ключевых компонента работают вместе для организации логики беседы.

• Обработчик действий Teams. Обрабатывает события и взаимодействия, связанные с Teams, такие как создание канала, добавление участников команды и другие действия, уникальные для среды Teams. В пакете SDK для Teams версии 2 обработчики регистрируются непосредственно в экземпляре App , а не через наследование классов.

• Логика бота. Объект App содержит логику бесед бота и отвечает за принятие решений на основе входных данных пользователя. Входящие действия направляются в соответствующий обработчик в зависимости от типа действия и необязательного сопоставления шаблонов.

Обработчик действий Teams

Обработчик действий — это ядро функциональных возможностей бота, управление и обработка взаимодействия с пользователем. В пакете SDK для Teams версии 2:

• Вы создаете App экземпляр объекта и регистрируете в нем обработчики.
• Обработчики получают типизированный объект контекста (IActivityContext в TypeScript, IContext<TActivity> в C#, ActivityContext[TActivity] в Python).
• Ответы и упреждающие сообщения отправляются через ctx.reply() или ctx.send().

Когда бот Teams получает действие, пакет SDK направляет его через зарегистрированный обработчик. События, относящиеся к Teams (жизненный цикл канала, изменения участников и т. д.), отображаются как отдельные именованные события, поэтому вам не нужно проверять channelData.eventType вручную.

Фрагменты кода обработчика действий

В следующих фрагментах показаны обработчики действий Teams для событий жизненного цикла канала и команды.

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

Пример обработчика действий бота

В следующем коде приведен пример действия бота:

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())

Логика бота

Логика бота включает в себя основные правила и платформы принятия решений, которые определяют действия и взаимодействия бота. В ней показано, как бот интерпретирует входные данные пользователя, формулирует ответы и участвует в беседах.

В пакете SDK для Teams версии 2 логика бота обрабатывает входящие действия из одного или нескольких каналов бота и создает исходящие действия. Вся маршрутизация действий обрабатывается экземпляром App — обработчики регистрируются, и пакет SDK автоматически отправляет им действия.

Теперь, когда вы ознакомились с обработчиками действий ботов, давайте посмотрим, как боты ведут себя по-разному в зависимости от беседы и сообщений, которые они получают или отправляют.

Рекомендации

Подробный диалог между вашим ботом и пользователем — это медленный и сложный способ выполнения задачи. Бот, который поддерживает чрезмерные команды, особенно широкий спектр команд, не является успешным и не просматривается пользователями положительно.

• Избегайте многоэтапных взаимодействий в чате Для расширенного диалога требуется, чтобы разработчик поддерживал состояние. Чтобы выйти из этого состояния, пользователь должен либо истекать время ожидания, либо нажать кнопку Отмена. К тому же процесс утомительный. Рассмотрим следующий сценарий разговора:

  ПОЛЬЗОВАТЕЛЬ: назначь встречу с Меган.

  БОТ: Я нашел 200 результатов, включая имя и фамилию.

  ПОЛЬЗОВАТЕЛЬ: назначь встречу с Меган Боуэн.

  БОТ: хорошо, в какое время вы хотели бы встретиться с Меган Боуэн?

  ПОЛЬЗОВАТЕЛЬ: 13:00.

  БОТ: в какой день?

• Поддержка шести или менее частых команд Так как в текущем меню бота есть только шесть видимых команд, больше ничего больше вряд ли будет использоваться с какой-либо частотой. Боты, которые углубляются в конкретную область, а не пытаются стать общим помощником, работают намного лучше.

• Оптимизация размера база знаний для более быстрого взаимодействия Один из недостатков ботов заключается в том, что трудно поддерживать большой база знаний получения с невыделяющимися ответами. Боты лучше всего подходят для коротких и быстрых взаимодействий, а не для просеивания длинных списков в поисках ответа.

Изучение других функций бота

Помимо обычных функций бота, вы также можете изучить дополнительные функции, доступные в приложении бота Teams:

• Получение контекста Teams для бота.
• Боты для звонков и собраний по сети.
• Включите единый вход для приложения.

Пример кода