O documento discute o Microsoft Bot Framework, que é um serviço para construir bots completos. O Bot Framework usa o Bot Builder SDK para criar bots em C# ou Node.js e integra-los com serviços como LUIS e canais como Skype, Facebook e Teams. Ele troca mensagens entre bots e usuários usando atividades JSON no Bot Connector.

1. Conhecendo o Microsoft Bot
Framework
Douglas Romão
Microsoft MVP
Renato Romão
MTAC

3. - Somente IA
- Somente texto
- Somente linguagem natural
ryanv 8:26 AM
Cancelar
Azure Bot Bot 8:26 AM
Você cancelou a operação. O que você gostaria de fazer
agora?
ryanv 8:26 AM
login
Azure Bot Bot 8:26 AM
Por favor selecione onde você deseja fazer o login?
1. Event Bots
2. QA Environment 1

4. De forma prática, bot é uma aplicação
que executa tarefas automáticas.

6. Suposições
- Esperar que o usuário use o bot
- Usuários preferirem a experiência do bot ao invés de outras alternativas
(webapps, aplicativos mobile)
Priorize os fatores corretos quando desenhar seu bot

7. Quão “inteligente” seu bot é
- Bots inteligente não garantem que seus usuários fiquem felizes e nem a adoção de uso
- Muitos bots tem pouca processamento de linguagem natural (NLP)
Quanto de linguagem natural seu bot suporta
- Bots podem conversar muito bem
- Bots podem ter bom vocabulário
- Alguns bots não tem capacidades de conversa e ainda assim em vários casos isso é perfeitamente
plausível

8. Voz
- Habilitar bots para falar ou ouvir nem sempre dão boas experiências ao usuário
- Forçar os usuários a usar voz podem trazer uma experiência frustrante
- Considerações chave
- A voz é a melhor forma de atender à necessidade?
- O ambiente é ou pode ser barulhento?
- A voz transmitirá corretamente as informações para o usuário?

9. Ótima experiência de usuário
Considerações chave:
- O bot resolve de forma simples e com poucos passos o problema do usuário?
- O bot resolve o problema do usuário mais fácil/rápido/melhor que experiências
alternativas?
- O bot roda em diferentes dispositivos e plataformas?
- Os usuários sabem naturalmente como agir com o bot e utilizá-lo?

12. Bot Framework
Bot Framework é um serviço/SDK da
Microsoft
Bot Framework é uma das várias ofertas
da Microsoft para construer um bot
complete
Outras inclusas: LUIS, APIs de Speech,
Azure, e mais

13. Logic
Your bot
Bot Builder SDK
(Node.js + c#)
LUIS
Web
service

14. Portal
Bot Connector
Send/receive messages
Store state
Translation
Telemetry
…
Your bot
Channels

15. Your bot
Bot
Connector
{
“type” : “message” ,
“id” : 68YrxgtB53Y” ,
“conversationId” : “DphpaFQrDuZDKyCez4AFGcT4vy5aQDjellLGIjB8v18MFtb”,
“language” : “en” ,
“text” : “You can say “/ order” to order!”,
“attachments” : [ ],
“from” : {
“name” : “+12065551212”,
“channelId” : “sms”,
“address” : “ +12065551212”,
“id” : “Ro52hKN287”,
“isBot” : false
},
“channelData” : { SMS data here },
…
}

19. Bot Connector service
- Serviço responsável pela troca de mensagens no canais de comunicação do bot,
essa configuração é feita no Azure;
- Utiliza REST/Json em um ambiente https
Client libraries
- O Bot framework providencia bibliotecas de cliente (Bot Builder SDK) que podem ser
utilizadas para programar tanto em C# or Node.js. O SDK suporta:
1. Diálogos que encapsulam lógicas
2. Questões de SIM/NÃO
3. Poderosos frameworks de IA como o LUIS e mais

20. Channel
- O canal é a comunicação entre o Bot Framework e os apps de comunicação, como:
• Skype
• Slack
• Facebook Messenger
• Office 365 mail
• Microsoft Teams
• Cortana
• Others
- Configuramos os canais no Portal do Azure

21. Activity
- O serviço do Bot Connector troca informações entre o bot e o canal (usuário) passando um objecto do
tipo Activity
Activity type Description
message Representa a comunicação entre o bot e o usuário
conversationUpdate Indica que o bot foi adicionado a uma conversa, outro membros foram
adicionados ou removidos da conversa, ou os metadados da conversa mudaram
contactRelationUpdate Indica que o bot foi adicionado ou removido da lista de contatos do usuário
typing Indica que o bot está compilando uma resposta
ping Representa uma tentative de determiner se o endpoint do bot está acessível
deleteUserData Indica para o bot que o usuário solicitou que o bot delete toda informação de
usuário que possa estar armazenada
endOfConversation Indica o fim da conversa

22. State Data
O “estágio” ou status da informação pode servir para vários propósitos:
- Determinar onde a conversa anterior foi interrompida
- Cumprimentar um usuário
- Salvando as preferências do usuário você pode customizar o modo como seu bot irá
responder na próxima conversa
Bot State Service
- Possibilita ao seu bot armazenar e recuperar o estágio/status do seu bot e recuperar
informações relacionadas ao usuário, conversa ou context específico
- Utiliza REST e Json
- Habilita autenticação e segurança

23. Authentication
Tanto o serviço de Bot Connector como o serviço de Bot State habilitam a autenticação
utilizando tokens JWT Bearer (Json)
JWT Bearer tokens
JSON Web Token (JWT) é um modelo open source para definição de segurança e transmissão
de dados entre partes utilizando decodificação e fazendo parse de objetos JSON
A informação pode ser verificada e confiável por que é assinada digitalmente

24. https://jwt.io/

25. Utilizando HTTPS e Bot Framework Authentication
Para garantir que o endpoint do seu bot será acessado apenas pelo conector do Bot
Framework, você deve configurar o endpoint para que utilize apenas HTTPS registrando seu
bot
Configurando a autenticação
Uma vez que seu bot foi registrado, você deve especificar o App Id e senha no web.config do
seu bot:
<appSettings>
<add key="MicrosoftAppId" value="_appIdValue_" />
<add key="MicrosoftAppPassword" value="_passwordValue_" />
</appSettings>

26. A autenticação utilizando o Bot Builder SDK for .NET
Para autenticar seu bot utilizando as informações que você configurou no web.config,
especifique o atributo [BotAuthentication] sem parâmetros

31. • Título
• Subtítulo
• Botão de ação
• Imagens

32. Card type Description
AdaptiveCard Combinação de texto, fala, imagens, botões e campos de input de dados
AnimationCard Reproduz GIFs e videos curtos
AudioCard Pode tocar áudios
HeroCard Tipicamente contém uma única imagem grande, um ou mais botões e texto
ThumbnailCard Tipicamente contém uma imagem miniature
ReceiptCard Tipicamente tem dados sumarizados
SignInCard Tipicamente contém textos e botões para login
VideoCard Card para rodar videos

36. - Interceptar mensagens;
- Enviar mensagens pró-ativas;
- Criar handlers globais para ações próprias; (cancelar, abortar)

37. Obrigado!

38. Douglas Romão
@douglasromao
douglasromao.com
Bit.ly/youtubedouglas
Renato Romão
Bit.ly/renatoromao