Introdução ao Bot Framework Composer

  • Artigo

Observação

Agora o Power Virtual Agents oferece suporte estes recursos sem o Composer.

Para usar o Bot Framework Composer para ampliar seu bot do Power Virtual Agents, você precisará primeiro importar o bot para um projeto do Composer.

Pré-requisitos

Abrir seu bot no Composer

Importante

Você deve sempre abrir o Composer no Power Virtual Agents. Isso garantirá que o Composer tenha todos os plug-ins necessários para a integração com o Power Virtual Agents.

  1. Acesse a página Tópicos para o bot que você deseja editar e selecione o símbolo de seta para baixo ao lado de + Novo tópico.

  2. Selecione Abrir no Bot Framework Composer no menu suspenso para abrir seu bot no Composer.

    Captura de tela do botão usado para abrir um bot no Composer.

  3. Se ainda não tiver Composer instalado:

    1. Selecione baixar o Composer.

      Captura de tela do link Baixar o Composer realçado.

    2. Na janela Baixar o Bot Framework Composer, selecione Baixar o Composer.

      Captura de tela da janela do Power Virtual Agents Composer, indicando que ele não foi instalado.

    3. Quando o download for concluído, execute-o para instalar o Composer.

    4. Depois de instalar o Composer, volte para o Power Virtual Agents. Volte para a página Tópicos e selecione o símbolo de seta para baixo ao lado de + Novo tópico.

      Observação

      Em alguns casos, um firewall pode estar bloqueando alguns recursos no Composer e você pode precisar permitir o acesso explicitamente. Confirme com o administrador para obter detalhes.

  4. Se o Power Virtual Agents não conseguir iniciar o Composer automaticamente, você poderá iniciá-lo manualmente:

    1. Selecione Copiar Link para copiar o link na sua área de transferência.

      Captura de tela do botão Copiar Link.

    2. Abra uma nova guia e cole o link na barra de endereços do seu navegador.

  5. Na primeira vez que você abrir um bot do Power Virtual Agents no Composer, ele será importado para um novo projeto do Composer. O nome especificado no Power Virtual Agents será usado automaticamente como o nome do projeto, mas você também pode inserir um nome personalizado.

    Captura de tela da tela de importação no Composer.

  6. Selecione Criar para terminar de importar seu bot para o Composer.

    Captura de tela da página de importação no Composer com o botão Criar realçado.

Testar o conteúdo do Composer no Power Virtual Agents

Você não pode usar o Bot Framework Emulator para testar o conteúdo do Composer criado para bots do Power Virtual Agents. Em vez disso, você precisará publicar o conteúdo do Composer no seu bot do Power Virtual Agents e usar o painel Bot de teste.

Importante

Selecionar Publicar no Composer torna as mudanças disponíveis para teste, mas não publica automaticamente o seu bot.

Publique seu bot no Power Virtual Agents para atualizá-lo em todos os canais aos quais ele está conectado.

  1. Vá para a página Publicar.

    Captura de tela da guia Publicar no Composer

  2. Selecione seu bot na lista Bot e selecione Publicar bots selecionados.

    Captura de tela do bot selecionado para publicação.

  3. Opcionalmente, insira uma mensagem em Comentários e selecione Ok.

    Captura de tela da janela Publicar.

  4. Quando a publicação for concluída, vá até o Power Virtual Agents. Talvez seja necessário atualizar a página para ver os novos tópicos adicionados ao Composer.

  5. Abra o painel Bot de teste inicie uma conversa digitando uma frase de gatilho.

Exibir o log de publicação

Se você estiver tendo problemas para publicar o conteúdo do Composer no Power Virtual Agents, é possível solucionar problemas consultando o log de publicação. O log de publicação fornece uma descrição detalhada de qualquer aviso ou erro encontrado durante a validação e sugestões sobre como corrigi-lo.

Observação

Se estiver tendo problemas com seu bot do Power Virtual Agents, use o verificador de tópico.

  1. No Composer, vá até a página Publicar.

  2. Selecione a seta para a direita (>) ao lado do seu bot. Pode ser necessário aumentar o tamanho da janela do Composer para tornar a seta visível.

    Captura de tela do botão de seta direita.

  3. Em Histórico de publicação, selecione Exibir log.

    Captura de tela do botão Exibir log em Histórico de publicação.

  4. Na janela Log de publicação, consulte se há erros ou avisos nos logs.

    Captura de tela do log de publicação.

Se encontrar problemas de desenvolvimento no Composer, você poderá:

Próximas etapas

Para ajudar você a começar a usar o Composer, criamos quatro exemplos que detalham diferentes cenários: