Principais conceitos na API do Bot Connector

A Estrutura de Bot e o Serviço de Bot de IA do Azure permitem que seu bot se comunique com usuários no Teams, 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 do Azure AI.
  • Como bibliotecas de adaptador para uso com o Bot Framework SDK.

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 seu bot troque mensagens com canais configurados no portal do Azure. Ele usa REST e JSON padrão do setor sobre HTTPS e permite a autenticação com tokens JWT Bearer. Para obter informações detalhadas sobre como usar o serviço Bot Connector, consulte Autenticação e os artigos restantes nesta seção.

Atividade

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

Autenticação

O Bot Framework Service usa tokens JWT Bearer para autenticação. Para obter informações detalhadas sobre como autenticar solicitações de saída que seu bot envia para o Bot Framework e como autenticar solicitações de entrada que seu bot recebe do Bot Framework, consulte Autenticação.

Bibliotecas de cliente

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

Nota

Os SDKs JavaScript, C# e Python do Bot Framework continuarão a ser suportados, no entanto, o Java SDK está sendo desativado com suporte final de longo prazo terminando em novembro de 2023. Apenas segurança crítica e correções de bugs dentro deste repositório serão realizadas.

Os bots existentes construídos com o Java SDK continuarão a funcionar.

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

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

Além de simplificar as chamadas para 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, prompts internos para coisas simples, como Sim/Não, strings, números e enumerações, suporte interno para estruturas de IA poderosas, como LUIS, e muito mais.

Nota

O Azure AI QnA Maker será desativado em 31 de março de 2025. A partir de 1º de outubro de 2022, você não poderá criar novos recursos ou bases de conhecimento do QnA Maker. Uma versão mais recente do recurso de perguntas e respostas agora está disponível como parte da Linguagem de IA do Azure.

A resposta a perguntas personalizadas, um recurso do Azure AI Language, é 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, consulte Compreensão de linguagem natural.

Nota

O Language Understanding (LUIS) será aposentado em 1 de outubro de 2025. A partir de 1 de abril de 2023, não será possível criar novos recursos LUIS. Uma versão mais recente do entendimento de idiomas agora está disponível como parte do Azure AI Language.

O entendimento de linguagem conversacional (CLU), um recurso do Azure AI Language, é a versão atualizada do LUIS. Para obter mais informações sobre o suporte à compreensão de linguagem no SDK do Bot Framework, consulte Compreensão de linguagem natural.

Nota

Como alternativa ao uso desses SDKs, você pode gerar sua própria biblioteca de cliente no idioma de sua escolha usando o arquivo ou código do Bot Connector Swagger diretamente para sua API REST.

Serviço de Estado do Bot

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

Informações adicionais

Saiba mais sobre como criar bots usando o serviço Connector examinando os artigos ao longo desta seção, começando com Autenticação. Se você encontrar problemas ou tiver sugestões sobre o serviço Connector, consulte Suporte para obter uma lista de recursos disponíveis.