Compartilhar via


Criar ações de conversa para o Microsoft Copilot

Observação

As ações eram anteriormente conhecidas como plug-ins. Alguns artigos e capturas de tela podem fazer referência a ações enquanto atualizamos a documentação e o conteúdo do treinamento.

O Microsoft Copilot fornece funcionalidade para interagir com conteúdo e recursos de toda a sua organização. Em algumas situações, são necessárias respostas e interação com sistemas externos. Com o Copilot Studio, você pode criar um tópico de conversa e publicar isso como uma ação do Copilot Depois que o administrador do locatário aprovar a ação, ela poderá ser adicionada às experiências de chat do Microsoft 365.

Você pode criar uma ação de conversa que recebe a consulta do usuário (armazenada na variável Activity.Text), a processa concluindo uma ou mais operações e, em seguida, envia uma ou mais respostas de volta ao usuário no chat.

Importante

Você não pode usar ações de conversa que você criou no Copilot Studio como ações de plug-in.

O que é uma ação de conversa e como ela funciona?

O sistema de conversa do Copilot usa lógica de orquestração e modelos de linguagem grandes para ajudar o usuário a atingir seus objetivos. Esse sistema interpreta a solicitação do usuário, determina o melhor curso de ação e, em seguida, ativa o sistema, ação, componente ou série de componentes apropriados. Por fim, o sistema gera um resultado e o retorna ao usuário.

Uma ação de conversa interna do Copilot Studio permite que você estenda o comportamento do seu aplicativo. Você pode criar novas habilidades que não estão no modo natural no Copilot, como chamar uma API específica, aplicar lógica de negócios sofisticada ou acessar fontes de dados.

Um modelo de componente tradicional cria um ponto de integração codificado com o copiloto. Para ações de conversação, o criador fornece um texto descritivo ao orquestrador do Copilot sobre as habilidades da ação. O orquestrador pode tomar sua própria decisão sobre quando a ação seria mais útil e conduzir a lógica definida para a ação.

Pré-requisitos

  • Os usuários finais devem ter uma licença para usar o Copilot para Microsoft 365.
  • Seu locatário do Power Platform deve ser configurado para habilitar as ações de publicação, conforme descrito no artigo do Copilot para Microsoft 365 Criar plug-ins usando o Microsoft Business Applications.
  • O administrador do locatário do Microsoft 365 precisa habilitar a categoria do Microsoft Copilot Studio de Aplicativos Integrados no Centro de Administração da Microsoft.

Observação

O bloco no Centro de Administração da Microsoft era anteriormente Dynamics 365 e Microsoft Copilot Studio e foi dividido em dois Dynamics 365 e Microsoft Copilot Studio. Apenas o último é necessário para que este recurso funcione.

Importante

Nesta versão, há algumas limitações:

  • Seu tópico não poderá interagir (fazer perguntas) ao usuário e só poderá processar a consulta recebida do usuário (na variável Activity.Text) e enviar uma resposta.
  • As respostas serão limitadas a texto. Nenhuma mídia ou cartões adaptáveis serão suportados.
  • Nesta versão preliminar, o Copilot Studio não pode autenticar o usuário, portanto as fontes do SharePoint e do OneDrive para respostas generativas não funcionarão.
  • Esta versão é limitada a copilotos de língua inglesa.
  • Todos os usuários do Copilot em sua organização poderão interagir com a ação, a ação não suportará a autorização do próprio usuário.
  • A integração do Copilot Studio com o Copilot é ativada por padrão. Isso significa que as ações criadas no Copilot Studio aparecerão para os usuários no "Copilot Studio" ou no "Power Automate", mesmo que os administradores do locatário não tenham implantado explicitamente o aplicativo para os usuários finais. Isso pode mudar no futuro.

Um administrador sempre pode bloquear a exibição de seus usuários, bloqueando o aplicativo no Centro de Administração do Microsoft 365.

Criar uma ação de conversa básica para publicar no Microsoft Copilot

Seu tópico, quando acionado em um chat do Copilot, usa a variável do sistema Activity.Text como entrada. Activity.Text representa a pergunta do usuário. O chat processa o texto da pergunta, por exemplo, passando-o para respostas generativas, e retorna o resultado como uma ou mais mensagens. Essas mensagens podem incluir as resposta que vêm de respostas generativas ou mensagens de nós de mensagem. Várias mensagens podem ser incluídas e enviadas separadamente para formar a saída.

As etapas a seguir ajudam você a criar uma nova ação de conversa no Copilot Studio. Você cria recursos básicos e os publica no Centro de Administração.

  1. No painel de navegação lateral, selecione Copilotos.

  2. Selecione a experiência do Copilot que você deseja estender. A página Visão geral do Copilot específico é exibida.

  3. Selecione a guia Ações.

  4. Selecione + Adicionar ação. Um menu de tipos de ação disponíveis é exibido.

  5. Selecione Nova ação. Você verá um menu de tipos de ação disponíveis para a nova ação.

    Captura de tela mostrando Escolha um novo tipo de ação para o Copilot para Microsoft 365

  6. Selecione Conversacional para criar uma ação de conversa. Uma janela de configuração é exibida permitindo que você defina algumas configurações básicas para a ação de conversa.

  7. Escolha um nome e idioma principal. Como opção, você também pode especificar uma solução e um nome de esquema para usar. Caso contrário, uma solução padrão e um nome do esquema serão selecionados para você.

  8. Selecione Criar para continuar. Sua nova ação de conversa é criada. Isso levará vários segundos. Quando terminar, você será solto na tela de criação de conversas.

Com sua ação de conversa criada, você pode prosseguir para refinar a ação usando o editor de tópicos. Quando terminar, você poderá publicar sua ação.

Refine seu exemplo de ação de conversa

Vejamos um exemplo de refinamento de uma ação de conversa.

Você pode usar o editor de tópico para definir a lógica da ação de conversa. O processo é semelhante ao processo para configurar qualquer outro tópico. Isso pode incluir chamar uma ação, iniciar uma solicitação de respostas generativas ou enviar uma mensagem ao usuário.

As ações de conversa somente suportam lógica que não requer interação do usuário.

Para este exemplo, vamos usar o nó de respostas generativas para pesquisar conteúdo da Web em um site especificado e fornecer uma resposta ao usuário no Copilot.

  1. Selecione Editar os tópicos em Refinar para editar sua ação de conversa.

    Captura de tela mostrando a revisão ou publicação da ação de conversa

    Você recebe algumas orientações sobre como configurar a ação de conversa.

    Captura de tela que mostra a ação de configuração da conversa no editor de tópico

  2. Antes de continuar a criação, defina o nome do tópico no painel superior acima da tela de criação. Esse nome fica visível para o usuário e o administrador no Copilot e no centro de administração do Microsoft 365, respectivamente.

  3. Na descrição do nó de Gatilho, forneça uma descrição clara de como a ação de conversa pode ajudar o usuário e o que ele pode fazer. Ao contrário de outras descrições de nó de gatilho, esta tem finalidade funcional e é usada pelo Copilot para determinar se deve invocar sua ação ou não. Descreva o que sua ação faz pelo usuário e o que ela retorna.

  4. Para adicionar o nó de respostas generativas, selecione o sinal de mais na tela sob o nó de Gatilho, em seguida, selecione Respostas generativas na guia Avançado do menu pop-up.

  5. Para o campo Entrada, chame o seletor de variáveis selecionando a seta na caixa Entrada.

  6. Escolha a variável do sistema Activity.Text que representa a última consulta do usuário para o Microsoft 365 Copilot. Essa consulta foi feita pelo usuário no chat do Microsoft 365 o que fez com que o Copilot invocasse a ação.

  7. Selecione o editor Fontes de Dados no centro do bloco Criar respostas generativas. É exibida uma janela de configuração Criar propriedades de respostas generativas.

  8. Em Dados clássicos e Fontes de dados dentro do campo Sites públicos insira um link para um site público que tenha o conteúdo que você deseja para o seu copiloto. Este conteúdo da web é usado para responder às perguntas dos usuários. Como alternativa, em Fontes de conhecimento, selecione + Adicionar conhecimento para abrir a caixa de diálogo Adicionar fontes de conhecimento disponíveis para adicionar um site público lá. Para obter mais informações sobre como adicionar conhecimento, consulte Adicionar conhecimento a um copiloto existente.

    Observação

    A fonte de conteúdo deve ser um site público. Verifique se o Bing consegue localizar e indexar esse site.

  9. Assim que o vincular for adicionado (não se esqueça de clicar em "+" após inserir a URL), feche o painel de propriedades.

  10. Como opção, adicione uma ou mais mensagens ao usuário. Você pode usar um nó de mensagem ou mais nós de resposta generativa, conforme necessário.

  11. Se sua ação precisar receber parâmetros de entrada de um conector ou passar parâmetros de saída para um conector, você poderá usar variáveis de entrada e saída.

  12. Finalmente, selecione Salvar para salvar sua ação de conversa.

Publique sua ação de conversa para o Copilot

Publicar sua ação de conversa cria uma nova ação no registro do Dataverse de seu locatário. Uma vez disponível lá, o administrador do locatário precisará aprovar sua ação para que fique disponível aos usuários.

No Copilot, sua ação de conversa é rotulada como Nome da ação de conversa na biblioteca. Com isso em mente, escolha o nome da sua ação de conversa para facilitar a leitura.

Para publicar sua ação de conversa:

  1. Primeiro, crie, edite e salve sua ação de conversa, conforme descrito nas seções anteriores.

  2. Na página de ação Visão geral, selecione Publicar.

  3. Selecione Publicar. Uma mensagem será exibida solicitando que você confirme sua intenção.

  4. Por fim, selecione Publicar novamente. A publicação deve ser concluída rapidamente. A disponibilidade real no centro de administração do Microsoft 365 pode levar alguns minutos. Se ocorrer um erro, tente novamente. Se o erro continuar, arquive um tíquete de suporte no centro de administração do Power Platform.

  5. O administrador pode encontrar o aplicativo integrado do Copilot Studio no centro de administração do Microsoft 365 em Configurações, em seguida, em Aplicativos Integrados. Implantar/bloquear está apenas neste nível de categoria.

    Importante

    Nesta liberação, a integração do Copilot Studio com o Copilot é ativada por padrão. Isso significa que as ações criadas no Copilot Studio aparecerão para os usuários no "Copilot Studio" ou no "Power Automate", mesmo que os administradores do locatário não tenham implantado explicitamente o aplicativo para os usuários finais. Isso pode mudar no futuro.

    Um administrador sempre pode impedir que ações de conversação sejam exibidas para os usuários bloqueando o aplicativo no centro de administração do Microsoft 365.

  6. Depois que o administrador do locatário aprovar o aplicativo integrado, ele deverá aparecer na lista de ações do usuário na interface do usuário de experiência do Copilot.

Depois que a ação for habilitada, o usuário poderá fazer perguntas no chat do Copilot e ver a ação invocada e retornando os resultados mais relevantes.

Observação

Para remover sua ação de conversa do catálogo, nos detalhes da ação de conversa, desmarque a caixa de seleção Status, salve sua ação de conversa e publique-o novamente, o que o removerá do registro do Dataverse e do catálogo de aplicativos do Microsoft Copilot.

Considerações

Interagir com o Copilot provavelmente será uma experiência diferente daquela que você teria na integração com sistemas anteriores.

  • O Copilot sempre reescreve suas respostas com sua própria voz. Não é possível nesta visualização fazer com que o conteúdo seja transmitido inalterado ao usuário final.
  • A descrição de sua ação de conversa é fundamental para a confiabilidade com que ela será invocada. A descrição ensina ao orquestrador em que sua ação é boa e quais respostas ela pode fornecer. Certifique-se de usar uma linguagem clara ao escrever a descrição e experimente alterações para obter o melhor resultado.