Estender o Microsoft Copilot com ações do conector (versão preliminar)

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 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.

Pré-requisitos

Alguns pré-requisitos são necessários para estender as experiências de copiloto da marca Microsoft com ações do conector.

Pré-requisitos gerais

Para todos os tipos de Copilot, você deve ter credenciais no nível de criador, uma licença de copiloto e uma licença do Microsoft Teams.

Pré-requisitos do Dynamics 365 Customer Service e Copilot para Vendas

Para Copilot para Dynamics 365 Customer Service e Copilot para Vendas, você deve estar conectado a um ambiente que contenha o Copilot que deseja estender.

Pré-requisitos do Copilot para Vendas

• Os clientes do Salesforce precisam estar conectado em seu ambiente do Dataverse (O ambiente geralmente é chamado msdyn_viva).
• Você deve fazer logon no Copilot para Vendas por meio do Outlook no ambiente que deseja estender pelo menos uma vez antes de fazer a extensão.

Adicionar uma ação de conector

Adicionar uma ação do conector a um copiloto da marca Microsoft envolve algumas etapas. As seções a seguir fornecem orientações sobre como adicionar uma ação do conector para o Copilot para Microsoft 365, Copilot para Vendas e Copilot para Dynamics 365 Customer Service.

Select a experiência do Copilot e escolha a ação do conector

1. Na home page, selecione Copilotos.

   

2. Na lista de Copilotos na navegação à esquerda, selecione a experiência de copiloto da marca Microsoft que deseja estender.

   

   A página de visão geral do Copilot é exibida.

   

3. Dependendo do Copilot selecionado, selecione a guia Ações ou Extensões. Você pode ver uma lista das ações já presentes no Copilot.

4. Em seguida, selecione estender o Copilot com uma ação.

   Para o Copilot para Microsoft 365, selecione Adicionar Extensão e, em seguida, selecione Nova ação.

   Para outros tipos de Copilot, selecione Adicionar Ação.

   

   Você recebeu uma lista de todos os tipos de ação para o Copilot.

   

5. Selecione Conector para estender com uma ação do conector.

   A página Selecionar seu conector é exibida. Você recebe uma lista de tipos 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.

   Dependendo do Copilot, a lista também pode incluir quaisquer 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.

   Observação

   No momento, conectores personalizados não podem ser usados para estender o Copilot para Dynamics 365 Customer Service.

Selecione tipo de conector e uma solução

1. Encontre seu tipo de conector usando a barra de pesquisa e selecione-o.

   

   A página Criar uma ação de IA personalizada usando seu conector é exibida.

2. 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. Inclua 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 Copiloto 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 com 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".

   A descrição permite que o Copilot saiba usar a ação sem ser explicitamente instruído, possibilitando uma experiência de linguagem mais natural.

3. 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.

4. Escolha uma solução e selecione Próximo.

   A página Selecionar e configurar sua página ação do plug-in é exibida. Esta página mostra todas as ações disponíveis a serem adicionadas para o conector. Você pode selecionar e configurar quaisquer ações que deseja que seu copiloto suporte, uma de cada vez. 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.

   

Adicionar ações ao conector

Em seguida, você precisa selecionar das ações disponíveis para adicionar ao conector.

1. Selecione uma ação para continuar. A página Configurar ação do plug-in é exibida para essa ação escolhida.

   

2. 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", "devolver", "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.

3. Depois de preencher a página, selecione Avançar. A página Revisar parâmetros de sua ação é exibida.

4. Selecione Avançar para prosseguir.

   Você retornará à página Selecionar e configurar sua página ação do plug-in na qual estava antes. Você pode ver a nova ação selecionada.

   

5. 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 página 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 da publicação.

Teste

Com a ação do conector configurada, agora você pode testá-la.

1. 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 para criar a conexão. Quando terminar, você poderá selecionar a nova conexão no menu suspenso.

2. Quando terminar de selecionar uma conexão, selecione Testar ação.

3. Quando você vir uma mensagem informando que a ação está pronta para teste, selecione Abrir para testar para abrir o chat do Copilot em uma nova janela. Abra o submenu para ver a ação criada e a ative.

   A ação é exibida com um ícone de béquer sob o conector escolhido com o formato Nome de Teste-ação.

4. Você já pode testar o plug-in tentando as solicitações esperadas que um usuário utilize. Você também pode usar o comando –developer on para obter mais informações sobre a execução da solicitação. Assim que você estiver satisfeito com os resultados, volte para a janela do Copilot Studio.

Publicar

1. 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.

2. Selecione Acessar a Página de Detalhes para ver os detalhes do conector publicado.

   Observação

   Agora que seu conector foi publicado, um administrador deve habilitá-lo antes de ele ser usado no copiloto. Se você não vir o conector no copiloto, certifique-se de que ele esteja habilitado no Microsoft Admin Center ou na página de extensões do copilot. Uma vez habilitado corretamente, o conector aparecerá no menu suspenso. Este etapa pode ter um atraso de até 24 horas na primeira vez que você fizer isso.

3. 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.

   

4. 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.

5. 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.

6. Retorne à página Ações/Extensões no Copilot Studio e selecione Importar Solução no ambiente de destino.

   

7. Procure para selecionar o arquivo .zip da solução exportada e selecione Avançar para continuar. Você poderá ver o conector exibido na lista Ações/Extensões.

Excluir uma ação do conector

Se você precisar excluir uma ação do conector, execute o seguinte procedimento.

Localizar solução usada pela ação do conector

O procedimento para excluir uma ação do conector é realizado no portal Maker. Power Apps Entretanto, você precisa da solução usada para a ação do conector em Copilot Studio.

1. Abrir Copilot Studio.

2. Select o ambiente usado para criar a ação do conector.

3. Em Copilotos, Select o Copiloto onde a ação do conector foi criada.

4. Select a aba Ações para visualizar a lista de ações associadas ao Copilot.

5. Select a ação que você deseja excluir e anote o nome da solução.

   

Excluir conector no portal Maker Power Apps

1. Acesse o portal Maker (https://make.powerapps.com) e Select o ambiente que você usou em Copilot Studio para criar ações.

2. No painel de navegação, Select Soluções para visualizar a lista de soluções no ambiente.

3. Localize a solução que você usou para criar a ação e Select.

   Você verá uma lista de objetos associados à solução.

4. Encontre a ação do conector que você deseja excluir. A ação é do tipo AIPlugin.

   Dica

   Se você não vir sua ação na solução, mova a ação do estado rascunho para o estado pronto publicando-a.

5. Antes de excluir a ação, você precisa excluir a dependência na tabela AICopilot_AIPlugin . Primeiro, Select Avançado>Mostrar dependências.

   

   As dependências para a ação do conector são exibidas.

6. Para a entrada AICopilot_AIPlugin na lista de dependências, Select Excluir.

   

7. Retorne à lista de objetos e exclua a ação selecionando Remover>Excluir deste ambiente.

   

8. Exclua quaisquer operações do tipo AIPluginOperation na tabela selecionando Remover>Excluir deste ambiente.

   

9. Retorne para Copilot Studio para verificar se a ação foi removida da visualização Ações do Copilot.