readme.md

Rachael - C# Azure Bot

Features:

• .NET Core 3.1
• Running on a consumption model as an Azure serverless function v3.x
• Connected to the LUIS language understanding service v2.0
• Bot Framework SDK v4
• Connected to twitter API v2
• Custom OAuth ASP.NET DelegatingHandler
• Uses Adaptive cards v1.2 for web chat

To build & Run:

• Using Azure Functions Core Tools v3

$ func host start --csharp

• Install ms-azuretools.vscode-azurefunctions vscode extension. Then F5 for Debugging in VSCode.

Run botframework-cli tools locally

docker build -t wilsoncg/bf-cli .
docker run wilsoncg/bf-cli luis

Bot Framework Emulator application

Here you can see Rachael in the bot framework emulator v4:

AdaptiveCards vs HeroCard

Adaptive cards are only supported in certain channels. We therefore render tweets as an AdaptiveCard for the webchat channel, and as a HeroCard for the skype channel. Refer to the Azure bot service channels reference.

Tweet as HeroCard:

Tweet as AdaptiveCard:

Nuget referenced packages:

• Microsoft.NET.Sdk.Functions - Azure Functions docs
• Microsoft.Bot.Builder.Azure - Bot Framework SDK docs

Useful links:

• Bot Framework SDK repo https://github.com/microsoft/botframework-sdk/blob/master/README.md
• Microsoft.Bot.Builder.* packages & repo https://github.com/microsoft/botbuilder-dotnet/
• To learn how to debug Azure Bot Service bots, please visit https://aka.ms/bf-docs-azure-debug
• Full list of app settings variables: https://docs.microsoft.com/en-gb/azure/azure-functions/functions-app-settings
• Azure functions authentication/keys https://github.com/Azure/azure-functions-host/wiki/Http-Functions
• Adaptive cards SDK https://docs.microsoft.com/en-us/adaptive-cards/sdk/authoring-cards/net

Portal links:

• Microsoft applications: https://apps.dev.microsoft.com
• LUIS applications: https://eu.luis.ai/applications/
• Bot framework: https://dev.botframework.com/bots
• Resources viewer: https://resources.azure.com

Azure functions (Getting help):

• Azure Functions Documentation
• Azure Functions MSDN forum
• Azure Functions on Stack Overflow
• Azure Functions host wiki
• Reporting issues

Old links:

• Azure function tools for Visual Studio 2017: https://devblogs.microsoft.com/aspnet/visual-studio-tools-for-azure-functions/
• Azure function tools roadmap 2017: https://devblogs.microsoft.com/aspnet/azure-functions-tools-roadmap/