Principais conceitos da API do Bot Connector

  • Artigo

O Bot Framework e o Serviço de Bot de IA do Azure permitem que o bot se comunique com os usuários no Teams, no Facebook e muito mais. Os canais estão disponíveis de duas formas:

  • Como um serviço incluído como parte do Serviço de Bot de IA do Azure.
  • Como bibliotecas de adaptador para uso com o SDK do Bot Framework.

Este artigo se concentra nos canais padrão incluídos no Serviço de Bot de IA do Azure.

Canais do Bot Framework

Os canais do Bot Framework permitem que o bot troque mensagens com canais configurados no Portal do Azure. Ele usa o padrão do setor REST e JSON via HTTPS e permite a autenticação com tokens de Portador JWT. Para obter informações detalhadas sobre como usar o serviço do Bot Connector, consulte Autenticação e os outros artigos desta seção.

Atividade

O serviço do Connector troca informações entre o bot e o canal (usuário) passando um objeto de Atividade. O tipo de atividade mais comum é mensagem, mas há outros tipos de atividade que podem ser usados para comunicar diversos tipos de informações a um bot ou canal. Para obter detalhes sobre as Atividades no serviço do Conector do Bot, consulte Visão geral das atividades.

Autenticação

Os Bot Framework Service usa tokens de portador JWT para autenticação. Para obter informações detalhadas sobre como autenticar solicitações de saída enviadas pelo bot para o Bot Framework, como autenticar solicitações de entrada que o bot recebe do Bot Framework, confira Autenticação.

Bibliotecas de cliente

O Bot Framework fornece bibliotecas de clientes que podem ser usadas para criar bots em C#, JavaScript, Python e Java.

Observação

Os SDKs JavaScript, C# e Python do Bot Framework continuarão a ser compatíveis. No entanto, o SDK Java está sendo desativado, com o suporte final de longo prazo terminando em novembro de 2023.

Os bots existentes criados com o SDK para Java continuarão a funcionar.

Para a criação de novos bots, considere usar o Power Virtual Agents e ler sobre como escolher a solução de chatbot correta.

Para obter mais informações, confira O futuro da criação de bots.

Além de simplificar chamadas às APIs REST do Bot Framework, cada SDK do Bot Framework também fornece suporte para a criação de diálogos que encapsulam a lógica de conversação, solicitações internas de coisas simples, como Sim/Não, sequências, números e enumerações, suporte interno para estruturas de IA avançadas, como LUIS, e muito mais.

Observação

O QnA Maker da IA do Azure será desativada em 31 de março de 2025. A partir de 1° de outubro de 2022, não será mais possível criar recursos ou bases de conhecimento do QnA Maker. Uma versão mais recente da funcionalidade de perguntas e respostas agora está disponível como parte da Linguagem de IA do Azure.

Respostas às perguntas personalizadas, um recurso de Linguagem de IA do Azure, é a versão atualizada do serviço QnA Maker. Para obter mais informações sobre o suporte a perguntas e respostas no SDK do Bot Framework, confira reconhecimento de linguagem natural.

Observação

O reconhecimento de linguagem (LUIS) será desativado em 1º de outubro de 2025. A partir de 1º de abril de 2023, você não poderá criar recursos do LUIS. Uma versão mais recente do reconhecimento de linguagem já está disponível como parte da Linguagem de IA do Azure.

A compreensão da linguagem coloquial (CLU), um recurso da Linguagem de IA do Azure, é a versão atualizada do LUIS. Para obter mais informações sobre o suporte ao reconhecimento de linguagem no SDK do Bot Framework, confira Reconhecimento de linguagem natural.

Observação

Como alternativa ao uso desses SDKs, você pode gerar sua própria biblioteca de clientes na linguagem de sua escolha usando o arquivo Swagger do Bot Connector ou codificar diretamente para a API REST.

Serviço de Estado do Bot

O serviço de Estado do Microsoft Bot Framework foi desativado em 30 de março de 2018. Anteriormente, bots criados no Serviço de Bot de IA do Azure ou no SDK do Bot Builder tinham uma conexão padrão com esse serviço hospedado pela Microsoft para armazenar dados de estado do bot. Os bots deverão ser atualizados para usar seu próprio armazenamento de estado.

Informações adicionais

Saiba mais sobre a criação de bots usando o serviço do Connector revisando os artigos apresentados nesta seção, começando por Autenticação. Se você encontrar problemas ou tiver sugestões sobre o serviço do Connector, confira Suporte para obter uma lista de recursos disponíveis.