Conectar os Serviços de Comunicação do Azure com os serviços de IA do Azure

  • Artigo

As APIs de Automação de Chamadas dos Serviços de Comunicação do Azure fornecem aos desenvolvedores a capacidade de orientar e controlar as chamadas de Telefonia, VoIP ou WebRTC dos Serviços de Comunicação do Azure usando gatilhos de eventos em tempo real para executar ações com base na lógica de negócios personalizada específica para seu domínio. Dentro das APIs de automação de chamadas, os desenvolvedores podem usar APIs simples alimentadas por IA, que podem ser usadas para reproduzir mensagens de saudação personalizadas, reconhecer entradas de voz conversacionais para coletar informações sobre perguntas contextuais para impulsionar um modelo mais de autoatendimento com os clientes, usar a análise de sentimento para melhorar o atendimento ao cliente em geral. Essas APIs específicas de conteúdo são orquestradas por meio dos Serviços de IA do Azure com suporte para personalização de modelos de IA sem que os desenvolvedores precisem encerrar fluxos de mídia em seus serviços e transmitir de volta ao Azure para funcionalidade de IA.

Tudo isto é possível com um clique onde as empresas podem aceder a uma solução segura e ligar os seus modelos através do portal. Além disso, desenvolvedores e empresas não precisam gerenciar credenciais. Conectar seus serviços de IA do Azure usa identidades gerenciadas para acessar recursos de propriedade do usuário. Os desenvolvedores podem usar identidades gerenciadas para autenticar qualquer recurso que ofereça suporte à autenticação do Microsoft Entra.

Os serviços de IA do Azure podem ser facilmente integrados em qualquer aplicativo, independentemente da linguagem de programação. Ao criar um Recurso do Azure no portal do Azure, habilite a opção e forneça a URL para os serviços de IA do Azure. Essa experiência simples permite que os desenvolvedores atendam às suas necessidades, escalem e evitem investir tempo e recursos no projeto e manutenção de uma solução personalizada.

Nota

Essa integração é suportada em regiões limitadas para serviços de IA do Azure, para obter mais informações sobre quais regiões são suportadas, consulte a seção de limitações na parte inferior deste documento. Esta integração suporta apenas o recurso do Serviço Cognitivo Multisserviço, recomendamos que, se estiver a criar um novo recurso do Serviço de IA do Azure, crie um recurso do Serviço Cognitivo Multisserviço ou, quando estiver a ligar um recurso existente, confirme que se trata de um recurso do Serviço Cognitivo Multisserviço.

Casos comuns de utilização

Crie aplicativos que possam reproduzir e reconhecer a fala

Com a capacidade de conectar seus serviços de IA do Azure aos Serviços de Comunicação do Azure. Você pode habilitar a funcionalidade de reprodução personalizada, usando a configuração Text-to-Speech e SSML (Speech Synthesis Markup Language), para reproduzir áudio com som mais personalizado e natural para os usuários. Por meio da conexão de serviços de IA do Azure, você também pode usar o serviço de fala para texto para incorporar o reconhecimento de respostas de voz que podem ser convertidas em tarefas acionáveis por meio da lógica de negócios no aplicativo. Essas funções podem ser aprimoradas ainda mais por meio da capacidade de criar modelos personalizados nos serviços de IA do Azure que são feitos sob medida para seu domínio e região, por meio da capacidade de escolher quais idiomas são falados e reconhecidos, vozes personalizadas e modelos personalizados criados com base em sua experiência.

Fluxo de runtime

Captura de tela do fluxo de tempo de execução da integração.

Experiência do portal do Azure

Você precisará conectar seu recurso dos Serviços de Comunicação do Azure com o recurso de IA do Azure por meio do portal do Azure. Há duas maneiras de realizar essa etapa:

  • Navegando pelas etapas da guia Serviços Cognitivos em seus Serviços de Comunicação do Azure (recomendado).
  • Adicionar manualmente a Identidade Gerenciada ao seu recurso dos Serviços de Comunicação do Azure. Esta etapa é mais avançada e requer um pouco mais de esforço para conectar seus Serviços de Comunicação do Azure aos seus serviços de IA do Azure.

Pré-requisitos

  • Conta do Azure com uma subscrição ativa e acesso ao portal do Azure, para obter detalhes, consulte Criar uma conta gratuitamente.
  • Recurso dos Serviços de Comunicação do Azure. Consulte Criar um recurso dos Serviços de Comunicação do Azure.
  • Um recurso dos Serviços de IA do Azure .

Ligar através do portal do Azure

  1. Abra o recurso dos Serviços de Comunicação do Azure e clique na guia Serviços Cognitivos.

  2. Se a identidade gerenciada atribuída ao sistema não estiver habilitada, você precisará habilitá-la.

  3. Na guia Serviços Cognitivos, clique no botão "Ativar identidade gerenciada".

    Captura de ecrã do botão Ativar Identidade Gerida.

  4. Habilite a identidade atribuída ao sistema. Esta ação inicia a criação da identidade; É apresentada uma notificação pop-up a notificá-lo de que o pedido está a ser processado. Captura de tela de habilitar identidade gerenciada.

  5. Quando a identidade estiver ativada, você verá algo semelhante. Captura de ecrã da identidade ativada.

  6. Quando a identidade gerenciada está ativada, a guia Serviço Cognitivo deve mostrar um botão 'Conectar serviço cognitivo' para conectar os dois serviços. Captura de ecrã do botão Ligar serviços cognitivos.

  7. Clique em 'Conectar serviço cognitivo', selecione a Assinatura, Grupo de Recursos e Recurso e clique em 'Conectar' no painel de contexto que se abre. Captura de ecrã do painel Subscrição, Grupo de Recursos e Recurso.

  8. Se a conexão for bem-sucedida, você verá um banner verde confirmando a conexão bem-sucedida.

    Captura de tela da conexão bem-sucedida.

  9. Agora, na guia Serviço Cognitivo, você verá seus serviços conectados aparecendo. Captura de tela do serviço cognitivo conectado na página principal.

Opção avançada: adicionar manualmente a Identidade Gerenciada ao recurso dos Serviços de Comunicação do Azure

Alternativamente, se você gostaria de passar pelo processo manual de conectar seus recursos, você pode seguir estas etapas.

Ativar identidade atribuída ao sistema

  1. Navegue até o recurso dos Serviços de Comunicação do Azure no portal do Azure.
  2. Selecione a guia Identidade.
  3. Habilite a identidade atribuída ao sistema. Esta ação inicia a criação da identidade. É apresentada uma notificação pop-up a notificá-lo de que o pedido está a ser processado. Captura de tela de ativar a identidade do sistema.

Opção 1: Adicionar função dos Serviços Cognitivos do Azure no portal do Azure

  1. Navegue até o recurso dos Serviços Cognitivos do Azure.
  2. Selecione a guia "Controle de acesso (IAM)".
  3. Clique no botão "+ Adicionar".
  4. Selecione "Adicionar atribuições de função" no menu. Captura de ecrã a mostrar a adição de uma atribuição de função.
  5. Escolha a função "Usuário de Serviços Cognitivos" a ser atribuída e clique em "Avançar". Captura de ecrã do Utilizador dos Serviços Cognitivos.
  6. Para o campo "Atribuir acesso a", escolha o "Usuário, grupo ou entidade de serviço".
  7. Pressione "+ Selecionar membros" e uma guia lateral será aberta.
  8. Procure o nome do recurso dos Serviços de Comunicação do Azure na caixa de texto e clique nele quando ele aparecer e, em seguida, clique em "Selecionar". Captura de ecrã do painel lateral de recursos dos Serviços de Comunicação do Azure.
  9. Clique em "Rever + atribuir", isto atribui a função à identidade gerida.

Opção 2: Adicionar função através do separador Identidade dos Serviços de Comunicação do Azure

  1. Navegue até o recurso dos Serviços de Comunicação do Azure no portal do Azure.
  2. Selecione a guia Identidade.
  3. Clique em "Atribuições de função do Azure". Captura de ecrã do ecrã de atribuição de funções.
  4. Clique no botão "Adicionar atribuição de função (Pré-visualização)", que abre o separador "Adicionar atribuição de função (Pré-visualização)".
  5. Selecione o "Grupo de recursos" para "Escopo".
  6. Selecione a opção "Assinatura".
  7. Selecione o "Grupo de Recursos" que contém o Serviço Cognitivo.
  8. Selecione a função "Usuário de Serviços Cognitivos". Captura de ecrã do separador de atribuição de função preenchido.
  9. Clique em Guardar.

Seu Serviço de Comunicação do Azure agora foi vinculado ao seu recurso do Serviço Cognitivo do Azure.

Regiões de serviços de IA do Azure suportadas

Esta integração entre os Serviços de Comunicação do Azure e os serviços de IA do Azure só é suportada nas seguintes regiões:

  • centralus
  • northcentralus
  • E.U.A Centro-Sul
  • E.U.A. Centro-Oeste
  • eastus
  • eastus2
  • westus
  • westus2
  • westus3
  • canadacentral
  • northeurope
  • westeurope
  • uksouth
  • southafricanorth
  • centralindia
  • eastasia
  • Sudeste Asiático
  • australiaeast
  • brazilsouth
  • uaenorth

Limitações conhecidas

  • Os prompts de texto de conversão de texto em fala suportam um máximo de 400 caracteres, se o prompt for maior do que isso, sugerimos usar SSML para ações de reprodução baseadas em conversão de texto em fala.
  • Para cenários em que você excede o limite de cota do serviço de Fala, você pode solicitar o aumento desse limite seguindo as etapas descritas aqui.

Próximos passos