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 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.
No painel de navegação lateral, selecione Copilotos.
Selecione a experiência do Copilot que você deseja estender. A página Visão geral do Copilot específico é exibida.
Selecione a guia Ações.
Selecione + Adicionar ação. Um menu de tipos de ação disponíveis é exibido.
Selecione Nova ação. Você verá um menu de tipos de ação disponíveis para a nova ação.
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.
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ê.
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.
Selecione Editar os tópicos em Refinar para editar sua ação de conversa.
Você recebe algumas orientações sobre como configurar a ação de conversa.
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.
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.
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.
Para o campo Entrada, chame o seletor de variáveis selecionando a seta na caixa Entrada.
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.
Selecione o editor Fontes de Dados no centro do bloco Criar respostas generativas. É exibida uma janela de configuração Criar propriedades de respostas generativas.
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.
Assim que o vincular for adicionado (não se esqueça de clicar em "+" após inserir a URL), feche o painel de propriedades.
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.
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.
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:
Primeiro, crie, edite e salve sua ação de conversa, conforme descrito nas seções anteriores.
Na página de ação Visão geral, selecione Publicar.
Selecione Publicar. Uma mensagem será exibida solicitando que você confirme sua intenção.
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.
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.
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.