microsoftbotframework

Estrutura de bots da Microsoft

Microsoft Bot Framework é um wrapper para a API Microsoft Bot da Microsoft. Ele usa Flask para receber mensagens postadas da Microsoft e do Celery para concluir tarefas assíncronas.

O objetivo era criar uma biblioteca realmente simples de usar para permitir a interface com a estrutura de bot da Microsoft.

A documentação completa pode ser encontrada aqui: http://microsoftbotframework.readthedocs.io/

Para executar este aplicativo usando o simulador local

Baixe e execute o simulador em: https://docs.botframework.com/en-us/tools/bot-framework-emulator/

Instale a biblioteca

 pip install microsoftbotframework

Definir uma tarefa

Crie um arquivo no diretório raiz chamado tasks.py. No arquivo defina uma tarefa da seguinte maneira. Mais informações sobre o objeto ReplyToActivity e outros podem ser encontradas em http://microsoftbotframework.readthedocs.io/en/latest/conversationoperations/

 from microsoftbotframework import ReplyToActivity

def echo_response ( message ):
    if message [ "type" ] == "message" :
        ReplyToActivity ( fill = message ,
                        text = message [ "text" ]). send ()

Crie o arquivo principal

 from microsoftbotframework import MsBot
from tasks import *

bot = MsBot ()
bot . add_process ( echo_response )

if __name__ == '__main__' :
    bot . run ()

Execute seu aplicativo

 python main.py

Conecte-se ao seu bot

Por padrão, o aplicativo é executado em http://localhost:5000/api/messages.

Insira este endereço no cabeçalho Insira seu URL de endpoint do emulador.

Comece a conversar! Se você seguiu as instruções acima, o que você digitou deverá repetir.

Para executar este aplicativo usando a estrutura de bot online

Para interagir com a estrutura de bot da Microsoft, você precisa ter um endpoint https voltado para a Internet com um certificado válido. Este guia mostrará como usar gunicorn e heroku para hospedar o aplicativo, mas você pode usar facilmente qualquer opção de hospedagem wsgi, pois o objeto MsBot estende o Flask.

Crie um chatbot da Microsoft

Acesse https://dev.botframework.com/bots. Registre um bot e gere um 'Microsoft App ID' e um 'Microsoft App Secret'. Não se preocupe com o endpoint de mensagens, pois o criaremos em breve. Crie um arquivo config.yaml na raiz do seu projeto e coloque as seguintes informações:

 other :
    app_client_id : 
    app_client_secret :  

Publicar no Heroku

Crie um arquivo chamado requisitos.txt e adicione o seguinte.

 microsoftbotframework
gunicorn

Crie um arquivo chamado "Procfile" e adicione o seguinte. Usaremos o gunicorn como nosso servidor web. Você pode remover "--log-level INFO" ou configurá-lo para um nível inferior para produção.

 web: gunicorn -b '0.0.0.0:'$PORT --log-level INFO main:bot

Crie um arquivo chamado runtime.txt e adicione o seguinte.

 python-3.6.0

Se você ainda não instalou o git

sudo apt-get install git

Cadastre-se para uma conta Heroku aqui: https://www.heroku.com/ e crie um novo aplicativo. Siga as instruções para implantar usando Heroku Git

Volte para a guia Microsoft MyBots e atualize o Messaging Endpoint para ser o domínio encontrado na guia de configurações do Heroku. Certifique-se de adicionar "/api/messages" no URL.

Parabéns, agora você poderá conversar com seu bot no Skype!

Executando os testes desta biblioteca

1. Certifique-se de ter as bibliotecas necessárias instaladas na seção setup.py testes_require com pip install -e .[test]
2. Certifique-se de que redis e mongodb estejam instalados localmente
3. Ative o redis: redis-server
4. Ative o mongobd: mongod
5. Abra um terminal na raiz deste diretório
6. Execute os testes com uma das opções abaixo
   • nosetests (requer a instalação das bibliotecas da etapa 1)
   • python setup.py test (não requer a instalação das bibliotecas da etapa 1)