Criar ações de plug-in de IA para um Microsoft Copilot (versão preliminar)
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.
As ações de plug-in de IA podem ser usadas para estender um Microsoft Copilot. Eles também podem ser usados dentro de um copiloto personalizado como uma ação do plug-in.
Você pode criar vários tipos de ações de plug-in de IA no Microsoft Copilot Studio:
- Ações de solicitação, que usam o AI Builder e um reconhecimento de linguagem natural para atingir cenários e fluxos de trabalho específicos dentro da empresa.
- Ações de fluxo, que usam fluxos do Power Automate, para realizar ações, recuperar e trabalhar com dados.
- Ações de conector, que usam conectores do Power Platform para acessar dados de outros sistemas, como produtos empresariais conhecidos como Salesforce, Zendesk, MailChimp e GitHub.
Este artigo apresenta instruções para criar, compartilhar e publicar ações de plug-in.
Depois de criar ações de plug-in , habilite-as para serem usadas no Microsoft Copilot ou adicione-as a um copiloto personalizado.
O restante deste artigo descreve como criar cada tipo de ação.
Gerar conteúdo ou extrair insights com solicitações do AI Builder
Observação: A extensão com ações de solicitação só está disponível para alguns tipos de copilotos.
Para criar ações de solicitação:
- Entre no Copilot Studio e selecione Biblioteca no painel de navegação lateral.
- Escolha + Adicionar um item. Você precisará selecionar um Microsoft Copilot para estender.
- Selecione um dos copilotos a serem estendidos.
- Para o Copilot para Microsoft 365, você precisará escolher entre estender o Copilot com um Novo copiloto ou uma Nova ação. Escolha Nova ação.
- Um menu Nova ação é exibido. Selecione Solicitação.
- Digite um Nome para sua solicitação em Detalhes da solicitação. Use uma linguagem natural para descrever o que você deseja alcançar. Por exemplo, Resuma este texto como um parágrafo com menos de 50 palavras. Você também pode selecionar entre diversos modelos de solicitação predefinidos para ajudá-lo a começar a usar uma solicitação. Em seguida, você pode personalizar o modelo para seu cenário.
- Em Entrada, adicione variáveis para qualquer informação que você queira dar à solicitação como entrada. Você poderá definir várias entradas, se necessário. Você também pode adicionar dados de exemplo para cada variável de entrada. Por exemplo, se você quiser que um modelo de solicitação resuma um determinado texto, defina uma variável de entrada de texto e adicione um texto de amostra a ser resumido como um teste.
- Com as variáveis necessárias definidas, adicione uma variável de entrada em Solicitação para cada entrada que o copiloto deve fornecer ao invocar a ação de solicitação. Você poderá adicionar mais de uma variável à solicitação, se quiser receber mais de um dado contextual em runtime do copiloto.
- Você também pode adicionar tabelas e colunas do Dataverse como dados de justificativa para a resposta da solicitação. Ao adicionar uma tabela e as tabelas relacionadas, você pode informar a solicitação para usá-la como dados de referência a fim de gerar respostas justificadas.
- Para testar dados de exemplo específicos para as variáveis de entrada, clique em Testar solicitação para avaliar a qualidade do funcionamento da solicitação.
- Selecione Finalizar solicitação para revisar os detalhes definidos por você para a solicitação.
- Por fim, selecione Criar ação de solicitação para salvar a ação de solicitação.
Depois de criar a ação, você precisará habilitá-la para uso no Microsoft Copilot.
Para obter mais informações sobre como criar e usar plug-ins de solicitação, consulte Solicitações do AI Builder.
Automação personalizada com os fluxos do Power Automate
Os plug-ins de fluxo do Power Automate permitem definir fluxos que podem ser chamados de superfícies de IA no Power Platform. Os plug-ins de fluxo usam o novo gatilho Executar do Copiloto e a ação Responder ao Copilot para definir processos personalizados que podem ser invocados com linguagem natural.
Para criar plug-ins de automação:
- Entre no Copilot Studio e selecione Plugins (versão preliminar) no painel de navegação lateral.
- Selecione Adicionar um componente do Power Platform como um plug-in de IA.
- Selecione Automação Personalizada.
- O editor de fluxo é aberto automaticamente com o gatilho Executar do Copiloto e a ação Responder ao Copilot presente.
- Você pode adicionar entradas ao seu gatilho para obter informações que deseja coletar de seus usuários. Forneça descrições de texto úteis para cada entrada para que a IA possa identificar corretamente o que extrair dos dados ou entradas de um usuário.
- Adicione ações ao seu fluxo, como o Criar uma aprovação e Publicar uma mensagem no chat do Teams para criar um processo de aprovação.
- Como opção, adicione parâmetros à ação Responder ao copiloto para qualquer saída que você deseja enviar de volta ao copiloto.
- Salve seu fluxo com um nome de fluxo significativo e teste-o ou execute-o pelo menos uma vez. A IA usa o título e a descrição do fluxo para determinar quando invocar os plug-ins de fluxo. Verifique se os fluxos são executados corretamente, pois apenas fluxos testados aparecem como plugins disponíveis no Microsoft Copilot.
Depois de criar a ação, habilite-a para uso no Microsoft Copilot.
Criar uma ação de conector
As ações de conector permitem definir conectores que podem ser chamados a partir das superfícies de IA no Power Platform. Para ações do conector, você precisa identificar as ações habilitadas para uso no Microsoft Copilot. Você também pode capturar as informações que os modelos de linguagem grandes precisam para identificar e utilizar o plug-in com eficiência, como campos de resumo e descrição.
Adicionando uma ação de conector para o Copilot para Microsoft 365
Você deve ter credenciais no nível de criador e receber uma licença de copiloto e uma licença do Microsoft Teams para criar uma ação do plug-in para Microsoft 365.
Para adicionar uma ação de conector para o Copilot para Microsoft 365:
Na home page, selecione Copilots.
Na lista do Copilotos, na navegação no lado esquerdo, selecione Copilot para Microsoft 365.
A página principal Copilot para Microsoft 365 é exibida na guia de configuração.
Selecione a guia Extensões. Você poderá ver uma lista das ações já presentes no Copilot.
Para criar uma ação, selecione Adicionar Extensão e Nova ação.
Você recebeu uma lista de todos os tipos de ação compatíveis.
Selecione Conector. Você recebe uma lista de conectores disponíveis para seleção. Os conectores conectam os copilotos a diferentes serviços. A lista inclui todos os conectores certificados oferecidos pela Microsoft e todos os conectores personalizados presentes no ambiente atual em uso. Uma barra de pesquisa está disponível para ajudar a encontrar o conector que você deseja usar.
Encontre seu tipo de conector usando a barra de pesquisa e selecione-o.
A página Detalhes da ação é exibida.
Escreva um nome e uma descrição para o conector. O nome do conector deve ser exclusivo. Por padrão, ele usa o nome do tipo de conector escolhido. Você deve adicionar mais informações de definição para garantir que ele seja um nome exclusivo e fácil de discernir o que ele faz para os usuários que queiram habilitá-lo posteriormente. Considere incluir na descrição os tipos de ações que ele permite como "Serviço de Email – permite que você recupere e crie mensagens".
A descrição poderá ser fornecida, se estiver presente no conector selecionado. A descrição é usada pelo Copilot para identificar quando a ação pode ser usada para obter respostas para a solicitação do usuário. Deixe a descrição o mais detalhada e descritiva possível. Dê detalhes específicos usando termos que você espera que os usuários usem ao chamar a ação. Para continuar o exemplo de Serviço de Email acima, convém incluir algo como:
"O Serviço de Email oferece a possibilidade de obter listas de mensagens existentes, recuperar pastas onde as mensagens são armazenadas, listar títulos de mensagens e pastas, obter mensagens, atualizar títulos e corpos de mensagem, definir a prioridade para mensagens..."
Quanto mais específica e detalhada melhor. A descrição permite que o copiloto saiba usar o plug-in sem ser explicitamente instruído, possibilitando uma experiência de linguagem mais natural.
Em Solução, um menu suspenso lista todas as soluções disponíveis no ambiente atual. Selecione a solução que deseja usar. Para obter mais informações sobre quais são as soluções e por que elas beneficiam você, consulte Conceitos de solução.
Se você tiver uma solução preferida ou se o conector selecionado já estiver na solução, essa solução será selecionada automaticamente. Você pode selecionar uma solução ou deixá-la em branco. Se deixar em branco, uma solução será criada para você com o nome da ação e o editor padrão. Armazenar sua ação em uma solução permite movê-la facilmente entre ambientes.
Observação
Você não verá uma solução padrão ou uma solução padrão do CDS como uma opção nesse caso, pois recomendamos ter uma solução personalizada tendo em vista um gerenciamento mais fácil. Para obter mais informações, consulte: Solução padrão vs. solução personalizada.
Assim que a solução for escolhida, selecione Avançar.
A página Selecionar Ações é exibida. Esta página mostra todas as ações disponíveis a serem adicionadas para o conector. Você pode selecionar e configurar as ações às quais deseja que seu copiloto ofereça suporte. Uma barra de pesquisa está incluída para ajudar você a encontrar a ação que deseja selecionar. Não há limite para o número de ações que podem ser selecionadas para o conector.
Observação
Os conectores só executam as ações que você seleciona e configura especificamente aqui. Se uma ação não estiver listada, ela não estará disponível. Não é possível adicionar nem remover ações de um conector dentro do assistente de ações do Copilot Studio.
Usando a barra de pesquisa conforme necessário, encontre e selecione uma ação para prosseguir. A página Configurar Ação é exibida.
Dê um nome e uma descrição para a ação. O nome não precisa ser exclusivo nesse caso. É provável que esses valores sejam populados para você pelo conector. No entanto, como na descrição do conector, você deve fornecer uma descrição específica detalhada para que o copiloto saiba quando invocar a ação específica. A descrição ajuda a permitir uma abordagem de linguagem mais natural para selecionar a ação a ser executada. Por exemplo, se uma ação for "Listar pastas de mensagens", você poderá usar:
"Listar pastas de mensagens permite que você obtenha uma lista de todas as pastas de mensagens disponíveis no serviço de email. Essa ação recupera todas as pastas, coloca-as em uma exibição de lista e retornar-as para você."
A descrição da ação fornece as pistas de contexto "listar pastas de mensagens", "obter", "tudo", "recuperar", "lista", "serviço de email", "retornar", "pastas" e "exibir". O copiloto pode usar essas pistas de contexto para identificar quando a ação é a correta para uma solicitação do usuário.
Ao concluir, selecione Avançar. A página Selecionar parâmetros de ação é exibida. Todas as entradas e saídas da ação são listadas. A lista de entradas e saídas é fornecida pelo conector e não pode ser alterada. No entanto, as descrições podem ser modificadas. Essas descrições não afeta o copiloto. Elas simplesmente oferecem clareza para criadores futuros que gerenciam a ação.
Modifique as descrições como desejar.
Selecione Avançar para prosseguir.
A página Selecionar Ações é exibida, mostrando a ação que você configurou.
Selecione outra ação e repita as etapas anteriores de configuração de ação, se desejar.
Como alternativa, selecione Avançar. A tela Revisar, testar e publicar sua ação será exibida.
A tela Revisar, testar e publicar sua ação exibe os detalhes de todas as etapas de configuração até o momento. Você pode revisá-las e, em seguida, testar a ação antes de publicá-la.
Selecione a conexão existente no menu suspenso ou selecione + Nova conexão se você não tiver uma conexão.
Se você selecionar + Nova conexão, um assistente será aberto no qual você poderá adicionar detalhes, como nome de usuário e senha, para criar a conexão.
Quando terminar, selecione Testar a ação.
Assim que você vir a mensagem de que a ção está pronta para ser testada, acesse o chat do Copilot para M365, abra o submenu para ver a ação e a ative-a.
A ação é exibida com um ícone de béquer sob o conector escolhido com o formato Nome de Teste-ação.
Você já pode testar a ação tentando as solicitações esperadas que um usuário utilize. Você também pode usar o comando
–developer onpara obter mais informações sobre a execução da solicitação. Assim que você estiver satisfeito com os resultados, retorne ao Copilot Studio.Quando terminar o teste, selecione Publicar.
Uma página será exibida mostrando seu conector no processo de publicação. Após a conclusão, você verá uma página indicando que o conector foi publicado.
Selecione Ir para detalhes a fim de ver os detalhes do plug-in publicado.
Agora que seu conector foi publicado, um administrador deve habilitá-lo antes de ele ser usado no copiloto.
Você também pode mover facilmente um conector de um ambiente para outro usando uma solução. Para isso, selecione Exportar esta solução na página de detalhes. A exportação da solução permite que você exporte o conector.
Altere o número da versão, se necessário, e selecione se a solução deve ser Gerenciada ou Não Gerenciada.
- Gerenciado significa que você não espera ter que fazer mais alterações na solução
- Não gerenciado significa que você deseja fazer alterações na solução no ambiente de destino.
Depois da conclusão, você verá uma mensagem verde com a opção Baixar a solução, que salva um arquivo .zip em seu sistema.
Observação
Não é necessário selecionar Publicar no painel de soluções.
Selecione Importar Solução na página principal do Copilot no ambiente de destino.
Selecione o arquivo .zip e continue. Você poderá ver o conector exibido na lista de Extensões.
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários