Introdução ao Bot Framework Composer

Artigo
05/01/2024

Importante

As capacidades e os recursos do Power Virtual Agents agora fazem parte do Microsoft Copilot Studio após investimentos significativos em IA generativa e integrações aprimoradas no Microsoft Copilot.

Alguns artigos e capturas de tela podem fazer referência ao Power Virtual Agents enquanto atualizamos a documentação e o conteúdo do treinamento.

Observação

Agora o Microsoft Copilot Studio oferece suporte estes recursos sem o Composer.

Para usar o Bot Framework Composer para ampliar seu bot do Microsoft Copilot Studio, você precisará primeiro importar o bot para um projeto do Composer.

Pré-requisitos

Estender o bot com o Bot Framework Composer

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.

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.
Selecione Abrir no Bot Framework Composer no menu suspenso para abrir seu bot no Composer.
Se ainda não tiver Composer instalado:
1. Selecione baixar o Composer.
2. Na janela Baixar o Bot Framework Composer, selecione Baixar o Composer.
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.
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.
2. Abra uma nova guia e cole o link na barra de endereços do seu navegador.
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.
Selecione Criar para terminar de importar seu bot para o Composer.

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.

Vá para a página Publicar.
Selecione seu bot na lista Bot e selecione Publicar bots selecionados.
Opcionalmente, insira uma mensagem em Comentários e selecione Ok.
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.
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.

No Composer, vá até a página Publicar.
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.
Em Histórico de publicação, selecione Exibir log.
Na janela Log de publicação, consulte se há erros ou avisos nos logs.