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.
Microsoft 365 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. Depois que o administrador do locatário aprovar a ação, ela poderá ser adicionada às experiências do Microsoft 365 Business Chat.
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
Não é possível usar ações de conversa criadas no Copilot Studio como uma ação com agentes personalizados.
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 criador fornece um texto descritivo ao orquestrador do copiloto 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 clientes devem ter uma licença para usar Microsoft 365 Copilot.
- Seu Power Platform locatário deve ser configurado para habilitar ações de publicação, conforme descrito no Microsoft 365 artigo Copilot Criar plug-ins usando aplicativos de negócios Microsoft.
- 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 Microsoft 365 Copilot em sua organização poderão interagir com a ação, a ação não oferecerá suporte à autorização do próprio usuário.
- A integração do Copilot Studio com o Copilot com o Microsoft 365 Copilot é habilitada por padrão. Isso significa que as ações criadas no Copilot Studio serão exibidas para os usuários em "Copilot Studio" ou "Power Automate", mesmo que os administradores de locatários não tenham implantado explicitamente o aplicativo para os usuários. 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, 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 Agentes.
Selecione Microsoft 365 Copilot. A página Visão geral de Microsoft 365 Copilot é 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 agente e Microsoft 365 no centro de administração, 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 Microsoft 365 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. Esta consulta foi o que o usuário perguntou que fez o Microsoft 365 Copilot chamar 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 Microsoft 365 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 agente do 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 Microsoft 365 Copilot é habilitada por padrão. Isso significa que as ações criadas no Copilot Studio serão exibidas para os usuários em "Copilot Studio" ou "Power Automate", mesmo que os administradores do locatário não tenham implantado explicitamente o aplicativo para os usuários. Isso pode mudar no futuro.
Um administrador sempre pode impedir que ações de conversação sejam exibidas para os usuários do Microsoft 365 Copilot que estão 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 365 Copilot.
Considerações
Interagir com Microsoft 365 Copilot provavelmente será uma experiência diferente do que você poderia ter tido integrando-se a sistemas anteriores.
- O Microsoft 365 Copilot sempre regrava suas respostas com sua própria voz. Não é possível, nesta visualização, que o conteúdo seja transmitido inalterado para o cliente.
- 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.