Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Você pode usar a API de comunicações em nuvem no Microsoft Graph para criar bots para responder às necessidades de seus clientes e facilitar a colaboração. Este artigo descreve como registrar o bot e, em seguida, gerenciar o estado do bot.
Pré-requisitos
Antes de começar, familiarize-se com os seguintes tópicos:
- O Microsoft Entra ID (Microsoft Entra ID) e como o serviço ajuda os funcionários a entrar e acessar recursos.
- O Azure Serviço de Bot e suas funcionalidades.
Registrar um bot
Os termos "aplicativo de serviço" e "bot" podem ser usados de forma intercambiável. Você pode criar um bot diretamente pelo portal do Azure ou registrar um bot que não esteja hospedado no Azure. Para obter mais informações, consulte Registrando um bot de chamada.
Para facilitar as coisas mais tarde, é útil entender os diferentes tipos de permissões no Microsoft Entra ID. Aplicativos com permissões delegadas exigem um usuário conectado. As permissões baseadas em aplicativo não precisam de um usuário conectado e geralmente podem ser executadas como um serviço em segundo plano.
Depois de registrar seu bot, se você quiser adicionar seu bot ao Microsoft Teams, certifique-se de entender como usar o portal do desenvolvedor para equipes e definir os metadados necessários.
Gerenciar o estado do bot
Depois de registrar seu bot, decida se deseja que sua mídia baseada em áudio e vídeo seja hospedada no aplicativo ou hospedada no serviço. Em um alto nível, isso envolve decidir se você deseja ou não acessar uma transmissão ao vivo de mídia bruta.
Em seguida, você pode decidir se o bot deve ser com ou sem estado.
Bots sem estado
Qualquer máquina virtual pode lidar com qualquer instância de bot, o que significa que, se uma máquina cair, outra poderá cuidar dela. Isso cria uma solução resiliente.
Por outro lado, um cache compartilhado, como o REDIS, precisa estar acessível a todas as máquinas virtuais.
Bots com estado
Uma máquina virtual pode lidar com apenas uma instância de bot por vez. Como todos os estados estão em um computador, não há memória extra ou verificações de cache REDIS.
A desvantagem é que ele não é tão resiliente porque a instância do bot está apenas em um computador.
Observação
Os bots de mídia hospedados no serviço podem ser com ou sem estado. Os bots de mídia hospedados no aplicativo devem ter estado para usar o SDK de Mídia de Bot.
Use os SDKs
Os SDKs a seguir estão disponíveis em C#. Forneceremos suporte para outros idiomas no futuro.
- Se você estiver usando bots sem estado , instale o SDK do Graph Communications Core.
- Se você estiver usando bots stateful , instale o SDK de Chamada de Comunicação do Graph.
Exemplos
Saiba como implementar diferentes cenários usando bots com estado, como responder a uma chamada de entrada com mídia hospedada no aplicativo ou no serviço.
Para obter mais exemplos, consulte o repositório de exemplos de comunicações.
Privacidade e conformidade
Nas solicitações para nossas APIs, os dados confidenciais não devem ser enviados em IDs geradas no lado do cliente (como IDs de cenário, IDs de solicitação ou outras IDs de correlação) nos cabeçalhos ou no corpo da solicitação. Essas IDs são registradas no lado do servidor para diagnósticos.