Compartilhar via

Introdução ao Bot Framework Composer

  • Artigo

Observação

Este artigo é aplicável apenas aos chatbots clássicos. Para estender agentes criados no Copilot Studio, você não precisa usar o Bot Framework Composer. Todos os recursos descritos neste artigo estão disponíveis para agentes, diretamente em Copilot Studio.

Para usar o Bot Framework Composer para estender seu bot do Copilot Studio, você precisa primeiro importar seu bot para um projeto do Composer.

Pré-requisitos

Abrir seu bot no Composer

Importante

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

  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 Microsoft Copilot Studio 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 Microsoft Copilot Studio. 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 Microsoft Copilot Studio 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 Microsoft Copilot Studio no Composer, ele será importado para um novo projeto do Composer. O nome especificado no Microsoft Copilot Studio 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 Microsoft Copilot Studio

Você não pode usar o Bot Framework Emulator para testar o conteúdo do Composer criado para bots do Microsoft Copilot Studio. Em vez disso, você precisará publicar o conteúdo do Composer no seu bot do Microsoft Copilot Studio 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 Microsoft Copilot Studio 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 Microsoft Copilot Studio. 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 Microsoft Copilot Studio, é 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 Microsoft Copilot Studio, 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: