Улучшение сообщений бота, созданных ИИ

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

• Метка ИИ позволяет пользователям идентифицировать, что сообщение было создано с помощью ИИ.
• Ссылка позволяет пользователям ссылаться на источник сообщения бота с помощью текстовых ссылок и ссылок.
• Кнопки обратной связи позволяют пользователям предоставлять положительные или отрицательные отзывы для сообщений бота.
• Метка конфиденциальности позволяет пользователям понять конфиденциальность сообщения бота.

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

Метка ИИ

Метка ИИ в сообщении бота указывает, что она создана СИ. Хотя боты на основе ИИ, использующие большие языковые модели (LLM), как правило, надежны, метка помогает предотвратить путаницу в источнике информации.

Добавление метки ИИ

Чтобы создать бота с помощью пакета SDK Для Teams, используйте метод, который помечает addAiGenerated() сообщение как созданное СИ. В следующем фрагменте кода показано, как включить метку ИИ в сообщении бота:

app.message(/label/i, async ({ send }) => {
  await send(new MessageActivity("Hi, this message is generated by AI").addAiGenerated());
});

async Task SendAILabel(IContext context)
{
    await context.Send(new MessageActivity
    {
        Text = "Hi, this message is generated by AI"
    }.AddAIGenerated());
}

@app.on_message_pattern(re.compile(r"label", re.IGNORECASE))
async def add_ai_label(ctx: ActivityContext[MessageActivity]):
    await ctx.send(
        MessageActivityInput(
            text="Hi, this message is generated by AI",
        ).add_ai_generated()
    )

После добавления метки ИИ в сообщении бота рядом с именем бота отображается метка, созданная ИИ . При наведении указателя мыши на метку ИИ появляется заявление об отказе от ответственности, указывающее, что созданное ИИ содержимое может быть неправильным. Метку ИИ и заявление об отказе от ответственности нельзя настроить для ботов на основе ИИ.

Обработка ошибок

Цитаты

Цитирование источников в сообщениях бота помогает пользователям задавать дополнительные вопросы или проводить независимые исследования. Цитировать источники данных, такие как файлы, сообщения, сообщения электронной почты и рабочие элементы, чтобы получить ценные аналитические сведения. Ссылки имеют решающее значение для ботов, использующих такие методы, как создание Retrieval-Augmented (RAG).

Ссылки в сообщениях бота могут включать следующие:

• Текстовые ссылки обозначают номера ссылок, добавленные в сообщение бота в формате [#], каждый из которых соответствует ссылке. Ссылку можно вставить в любом месте текста.
• Сведения о ссылке на ссылку включают заголовок, значок, ключевые слова, абстракт, гиперссылку, сведения о конфиденциальности и кнопку для открытия модального окна с дополнительным содержимым. Ссылки отображаются в виде всплывающих окон для каждой текстовой ссылки.
• Метки конфиденциальности для ссылок указывают на конфиденциальность ссылочного содержимого и не добавляются автоматически. Сведения о добавлении меток конфиденциальности для ссылок см. в статье Добавление метки конфиденциальности.
• Модальное окно с дополнительным содержимым отображает адаптивную карточку без интерактивных элементов.

Добавление ссылок

Если вы используете пакет SDK Для Teams для создания бота, используйте для addCitation() включения текстовых ссылок и метаданных ссылок в сообщение. Ниже приведен пример фрагмента кода:

app.message(/citation/i, async ({ send }) => {
  const card = new AdaptiveCard(new TextBlock("Adaptive Card text"))
    .withOptions({ version: "1.6" });
  const appearance: CitationAppearance = {
    name: "AI messages bot",
    url: "https://example.com/claim-1",
    abstract: "Excerpt description",
    text: JSON.stringify(card),
    keywords: ["keyword 1", "keyword 2", "keyword 3"],
    icon: "Microsoft Word",
  };
  await send(
    new MessageActivity("Hey I'm a friendly AI bot. This message is generated through AI [1]")
      .addCitation(1, appearance)
  );
});

async Task SendCitations(IContext context)
{
var message = new MessageActivity
{
Text = "Hey I'm a friendly AI bot. This message is generated through AI [1]"
};

message.AddCitation(1, new CitationAppearance
{
    Name = "AI messages bot",
    Url = "https://example.com/claim-1",
    Abstract = "Excerpt description",
    Keywords = new List<string> { "keyword 1", "keyword 2", "keyword 3" },
    Icon = CitationIcon.MicrosoftWord
});

await context.Send(message);
}

@app.on_message_pattern(re.compile(r"citation", re.IGNORECASE))
async def add_citations(ctx: ActivityContext[MessageActivity]):
    await ctx.send(
        MessageActivityInput(
            text="Hey I'm a friendly AI bot. This message is generated through AI [1]",
        ).add_citation(
            position=1,
            appearance=CitationAppearance(
                name="AI messages bot",
                url="https://example.com/claim-1",
                abstract="Excerpt description",
                text=AdaptiveCard(version="1.6", body=[TextBlock(text="Adaptive Card text")]).model_dump_json(by_alias=True, exclude_none=True),
                keywords=["keyword 1", "keyword 2", "keyword 3"],
                icon=CitationIconName.MICROSOFT_WORD,
            ),
        )
    )

После включения ссылок сообщение бота содержит текстовые ссылки и ссылки. Текстовые ссылки отображают сведения о ссылке при наведении указателя мыши на ссылку.

Обработка ошибок

Кнопки обратной связи

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

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

Кнопки обратной связи находятся в нижнем колонтитуле сообщения бота и включают кнопку 👍 (большие пальцы вверх) и кнопку 👎 (вниз), которую выбирает пользователь.

Добавить кнопки обратной связи

Чтобы включить кнопки обратной связи в боте, созданном с помощью пакета SDK для Teams, используйте addFeedback() метод в действии сообщения.

app.message(/feedback/i, async ({ send }) => { 

  await send(new MessageActivity("This is an example of a feedback button - this helps to provide feedback for a message").addFeedback()); 

}); 

async Task SendFeedbackButtons(IContext context)
{
await context.Send(new MessageActivity("This is an example of a feedback button - this helps to provide feedback for a message")
.AddFeedback());
}

@app.on_message_pattern(re.compile(r"feedback", re.IGNORECASE))
async def add_feedback_buttons(ctx: ActivityContext[MessageActivity]):
await ctx.send(
MessageActivityInput(
text="This is an example of a feedback button - this helps to provide feedback for a message",
).add_feedback('custom')
)

Если задано значение feedbackLoop.typedefault, форма обратной связи по умолчанию отображается, когда пользователь нажимает кнопки обратной связи. Если вы хотите отобразить настраиваемую форму обратной связи, задайте для значение feedbackLoop.typecustom. Следующий запрос на вызов отправляется боту для получения пользовательской формы, отображаемой для пользователя:

{
    "type": "invoke",
    "name": "message/fetchTask",
    "value": {
        "actionName": "feedback",
        "actionValue": {
            "reaction": "like" // like or dislike
        }
    }
}

Вы должны отвечать на этот вызов с помощью диалогового окна (называемого модулями задач в TeamsJS версии 1.x) так же, как и на task/fetch вызов. Дополнительные сведения о вызове диалогов в ботах см. в разделе Использование диалогов с ботами.

Обработка отзывов

Бот получает от пользователя входные данные из формы обратной связи через поток вызова бота. Для ботов, созданных с помощью пакета SDK для Teams, запрос на вызов бота обрабатывается автоматически. Обработка отзывов пользователей message.submit.feedback с помощью события.

app.on("message.submit.feedback", async (context) => { 
  // custom logic here... 
}); 

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

Обработка ошибок

Метка конфиденциальности

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

Добавление метки конфиденциальности

Для ботов, созданных с помощью пакета SDK Для Teams, добавьте метку конфиденциальности в сообщение бота, изменив сообщение для включения usageInfo в entities объект .

В следующем фрагменте кода показано, как добавить метки конфиденциальности как в сообщения бота, так и в ссылку на ссылки:

await context.sendActivity({
  type: ActivityTypes.Message,
  text: `Hey, I'm a friendly AI bot. This message is generated through AI [1]`,
  entities: [
    {
      type: "https://schema.org/Message",
      "@type": "Message",
      "@context": "https://schema.org",
      usageInfo: {
        "@type": "CreativeWork",
        name: "Sensitivity title",
        description: "Sensitivity description",
      },
    },
  ],
});

await context.sendActivity({
  type: ActivityTypes.Message,
  text: `Hey, I'm a friendly AI bot. This message is generated through AI [1]`,
  entities: [
    {
      type: "https://schema.org/Message",
      "@type": "Message",
      "@context": "https://schema.org",
      usageInfo: {
        "@type": "CreativeWork",
        name: "Sensitivity title",
        description: "Sensitivity description",
      },
      citation: [
        {
          "@type": "Claim",
          position: 1,
          appearance: {
            "@type": "DigitalDocument",
            name: "AI bot",
            url: "https://example.com/claim-1",
            usageInfo: {
              "@type": "CreativeWork",
              "@id": "sensitivity1",
              name: "Sensitivity title",
              description: "Sensitivity description",
            },
          },
        },
      ],
    },
  ],
});

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

Обработка ошибок

Пример кода

См. также

• Обработчики действий ботов
• Формат сообщений бота
• Начало работы с пакетом SDK для Teams
• Пользовательский интерфейс потоковой передачи в ботах