Criar um bot

aplica-se a: SDK v4

Este artigo mostra como criar um bot usando o SDK do Bot Framework e, em seguida, mostra como testá-lo com o Bot Framework Emulator.

Criar um bot com o Serviço de Bot do Azure e criar um bot localmente são formas independentes e paralelas.

Pré-requisitos

Modelos

para adicionar os modelos de bot a Visual Studio, baixe e instale os modelos de SDK do bot Framework v4 para Visual Studio arquivo VSIX.

Observação

O pacote VSIX inclui as versões do .net Core 2,1 e do .net Core 3,1 dos modelos do C#. Ao criar bots no Visual Studio 2019, você deverá usar os modelos do .NET Core 3.1. As amostras de bot atuais usam modelos do .NET Core 3.1. Encontre as amostras que usam modelos do .NET Core 2.1 no branch 4.7-archive do repositório BotBuilder-Samples. Para obter informações sobre a implantação de bots do .NET Core 3,1 no Azure, consulte como implantar o bot no Azure.

Criar um bot

No Visual Studio, crie um projeto de bot usando o modelo Echo Bot (Bot Framework v4 – .NET Core 3.1) . Escolha Bots de IA nos tipos de projetos para mostrar apenas os modelos de bot.

Caixa de diálogo Criar um projeto do Visual Studio

Graças ao modelo, seu projeto contém todo o código necessário para criar o bot neste início rápido. Você não precisa de nenhum código adicional para testar o bot.

Observação

Se você criar um bot Core, precisará de um modelo de linguagem LUIS. Você pode criar um modelo de linguagem em luis.ai. Após a criação do modelo, atualize o arquivo de configuração.

Inicie seu bot

No Visual Studio

  1. Abra seu projeto de bot.
  2. Execute o projeto sem depuração.

Isso vai compilar o aplicativo, implantá-lo no localhost e iniciar o navegador da Web para exibir a página default.htm do aplicativo. Neste ponto, o bot está sendo executado localmente na porta 3978.

Iniciar o emulador e conectar seu bot

  1. Instale o Emulador do Bot Framework.

  2. selecione Bot aberto na guia de boas-vindas do Emulator.

  3. Insira a URL do bot, que é a URL da porta local, com /api/messages adicionado ao caminho, normalmente http://localhost:3978/api/messages .

    abrir um bot

  4. Depois, selecione Conectar.

    Envie uma mensagem para o bot e o bot responderá de volta.

    mensagem de eco

Recursos adicionais

  • consulte depurar um bot para saber como depurar usando Visual Studio ou Visual Studio Code e o Bot Framework Emulator.
  • Consulte tunelamento (ngrok) para obter informações sobre como instalar o ngrok.

Próximas etapas