Блог

как я могу реализовать bot framework в моем коде Visual Studio и какие пакеты необходимо установить для использования bot framework в коде Visual Studio?

Это довольно широкий вопрос, но я постараюсь охватить все базовые базы и включить ответы для Node / JS / TS, а также C #.

Создайте бота

У вас есть 4 варианта:

1. Создайте бота в Azure:

   1. На портале Azure создайте ресурс> Бот веб-приложения > Выполните шаги и создайте.
   2. Откройте только что созданный ресурс «Web App Bot» > Сборка> Загрузить исходный код бота.

2. [ТОЛЬКО JS / TS / Node] Создайте бота с помощью Yeoman: (Смотрите Краткое начало JavaScript ниже)

   1. npm install -g yo generator-botbuilder
   2. yo botbuilder .
   3. Следуйте инструкциям и создайте своего бота.
      • Вот объяснение параметров шаблона бота, которые вы можете выбрать
      • Это автоматически установит все необходимые пакеты.

3. [ТОЛЬКО C #]: Используйте шаблон VSIX в Visual Studio:**

   1. Загрузите шаблон BotBuilder V4 VSIX
   2. Создайте новый проект в Visual Studio (вы можете получить более подробную информацию о каждом шаблоне бота по ссылке выше)

4. Клонировать образец:

   1. Клонируйте один из этих примеров
      • Я рекомендую базовый бот: JS / Node / C #, для чего-то несколько сложного и простую подсказку: JS / Node / C #, для чего-то более простого
   2. Следуйте каждому образцу REAMDE.md для получения дальнейших инструкций.

5. Создайте его с нуля, как упоминал @TobiasC. Я настоятельно не рекомендую идти этим путем, если вы не знаете, что делаете. Гораздо проще начать с примера. Использование Yeoman для создания пустого бота — хороший способ, если вы хотите что-то довольно простое.

Упаковка

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

JS / TS / Node: Вот фрагмент базового бота package.json , показывающий все пакеты, которые он использует:

 "dependencies": {
    "botbuilder": "^4.2.0",
    "botbuilder-ai": "^4.2.0",
    "botbuilder-dialogs": "^4.2.0",
    "botframework-config": "^4.2.0",
    "dotenv": "^6.1.0",
    "restify": "^7.2.3"
},
"devDependencies": {
    "eslint": "^5.9.0",
    "eslint-config-standard": "^12.0.0",
    "eslint-plugin-import": "^2.14.0",
    "eslint-plugin-node": "^8.0.0",
    "eslint-plugin-promise": "^4.0.1",
    "eslint-plugin-standard": "^4.0.0",
    "nodemon": "^1.18.6"
}
  

C # Вот список пакетов NuGet для базового бота из .csproj файла:

 <PackageReference Include="Microsoft.ApplicationInsights.AspNetCore" Version="2.1.1" />
<PackageReference Include="Microsoft.AspNetCore.All" Version="2.0.9" />
<PackageReference Include="Microsoft.Azure.CognitiveServices.ContentModerator" Version="0.12.1-preview" />
<PackageReference Include="Microsoft.Azure.CognitiveServices.Language" Version="1.0.1-preview" />
<PackageReference Include="Microsoft.Bot.Builder" Version="4.2.2" />
<PackageReference Include="Microsoft.Bot.Builder.AI.Luis" Version="4.2.2" />
<PackageReference Include="Microsoft.Bot.Builder.Azure" Version="4.2.2" />
<PackageReference Include="Microsoft.Bot.Builder.Dialogs" Version="4.2.2" />
<PackageReference Include="Microsoft.Bot.Builder.Integration.AspNet.Core" Version="4.2.2" />
<PackageReference Include="Microsoft.Bot.Configuration" Version="4.2.2" />
<PackageReference Include="Microsoft.Bot.Connector" Version="4.2.2" />
<PackageReference Include="Microsoft.Bot.Schema" Version="4.2.2" />
<PackageReference Include="Microsoft.Graph" Version="1.10.0" />
<PackageReference Include="StyleCop.Analyzers" Version="1.1.0-beta008">
  

Запустите бота

Запустите npm start из каталога бота (Node / JS / TS) или нажмите F5 в Visual Studio (C #). По умолчанию бот будет прослушивать сообщения на http://localhost:3978

Тестирование и отладка

Используйте эмулятор BotFramework для локального тестирования. Смотрите «Эмулятор Botframework — начало работы» ниже.

Общая информация

Действительно, я рекомендую как можно больше следовать документам и примерам и при необходимости использовать ссылку на SDK. Ссылки ниже.

Ссылки

Быстрый запуск JavaScript

C # Быстрый запуск

Отладка бота

Эмулятор Botframework — Начало работы

Документы

Ссылка на TS SDK

Ссылка на C # SDK

есть два способа: создать бота в Azure с использованием одного из шаблонов и загрузить файлы впоследствии или создать его с нуля. Выбор необходимых пакетов зависит от вашего варианта использования. Однако базовые пакеты должны быть:

• restify
• botbuilder
• botbuilder-ai
• botbuilder-диалоги

Для локального запуска и тестирования бота вам также понадобится эмулятор Bot Framework.

Надеюсь, это поможет

Если вы используете VS Code и хотите использовать .Net Core вы можете импортировать следующие шаблоны. Они находятся в README.md из каталога Generator / template на github.

https://github.com/microsoft/BotBuilder-Samples/tree/master/generators/dotnet-templates

 # Installs all three templates (echo, core, empty)
dotnet new -i Microsoft.Bot.Framework.CSharp.EchoBot
dotnet new -i Microsoft.Bot.Framework.CSharp.CoreBot
dotnet new -i Microsoft.Bot.Framework.CSharp.EmptyBot
  

затем создайте проект на основе шаблона, как и любой другой шаблон.

 # example using the echobot template
dotnet new echobot