Skip to content

Latest commit

 

History

History
 
 

01.console-echo

README.md

This sample shows a simple echo bot and demonstrates the bot working as a console app using a sample console adapter.

Concepts introduced in this sample

What is a bot?

A bot is an app that users interact with in a conversational way using text, graphics (cards), or speech. It may be a simple question and answer dialog, or a sophisticated bot that allows people to interact with services in an intelligent manner using pattern matching, state tracking and artificial intelligence techniques well-integrated with existing business services.

Adapters

Adapters provide an abstraction for your bot to work with a variety of environments.

A bot is directed by it's adapter, which can be thought of as the conductor for your bot. The adapter is responsible for directing incoming and outgoing communication, authentication, and so on. The adapter differs based on it's environment (the adapter internally works differently locally versus on Azure) but in each instance it achieves the same goal.

In most situations we don't work with the adapter directly, such as when creating a bot from a template, but it's good to know it's there and what it does. The bot adapter encapsulates authentication processes and sends activities to and receives activities from the Bot Connector Service. When your bot receives an activity, the adapter wraps up everything about that activity, creates a context object, passes it to your bot's application logic, and sends responses generated by your bot back to the user's channel.

To try this sample

  • Clone the repository
git clone https://github.com/microsoft/botbuilder-samples.git

Prerequisites

Visual studio

  • Navigate to the samples folder (botbuilder-samples/samples/csharp_dotnetcore/01.console-echo) and open Console-EchoBot.csproj in Visual studio
  • Run the project (press F5 key)

Visual studio code

  • Open botbuilder-samples/samples/csharp_dotnetcore/01.console-echo folder
  • Bring up a terminal, navigate to botbuilder-samples/samples/csharp_dotnetcore/01.console-echo folder
  • Type dotnet run.

Update packages

  • In Visual Studio right click on the solution and select "Restore NuGet Packages". Note: this sample requires Microsoft.Bot.Builder.
  • In Visual Studio Code type dotnet restore

Further reading