Compartilhar via


Os pedidos de exportação que os utilizadores guardavam, gostavam ou partilhavam no Galeria de prompts do Copilot

No Galeria de prompts do Copilot, os utilizadores podem guardar ou partilhar pedidos que criaram, incluindo pedidos de partilha com uma equipa específica (no Microsoft Teams) de que são membros. Os utilizadores também podem gostar de pedidos criados por outras pessoas. Enquanto administrador, pode utilizar Windows PowerShell para exportar dados para um ficheiro sobre qualquer um dos seguintes tipos de pedidos no Galeria de prompts do Copilot:

  • Os pedidos guardados, apreciados e partilhados de um utilizador específico.
  • Os pedidos partilhados com uma equipa específica.

Configurar o ambiente de Windows PowerShell

A conta de utilizador que executa o script do PowerShell para exportar os dados tem de ser atribuída à função de Administrador Global.

Importante

A Microsoft recomenda que você use funções com o menor número de permissões. A utilização de contas com permissões mais baixas ajuda a melhorar a segurança da sua organização. O Administrador Global é uma função altamente privilegiada que deve ser limitada a cenários de emergência quando não for possível usar uma função existente. Para saber mais, veja Acerca das funções de administrador no Centro de administração do Microsoft 365.

Antes de poder exportar pedidos que os utilizadores guardaram, gostaram ou partilharam no Galeria de prompts do Copilot, tem de configurar o seu ambiente do PowerShell através dos seguintes passos:

  1. Transferir o script do PowerShell CopilotLabDSR
  2. Instalar o módulo MSAL.PS
  3. Carregar o módulo CopilotLabDSR

Transferir o script do PowerShell CopilotLabDSR

  1. Para começar, tem de transferir o script do PowerShell CopilotLabDSR.

  2. No Explorador de Arquivos, aceda à localização onde guardou o ficheiro CopilotLabDSR.psm1.

  3. Clique com o botão direito do rato no ficheiro CopilotLabDSR.psm1 e selecione Propriedades.

  4. No separador Geral , selecione Desbloquear caixa de verificação e, em seguida, selecione Ok.

    Tem de desbloquear o ficheiro porque, por predefinição, a execução de scripts transferidos a partir da Internet não é permitida.

Instalar o módulo MSAL.PS

  1. Verifique se o módulo MSAL.PS está instalado ao executar o seguinte comando no PowerShell:

    Get-Module -ListAvailable MSAL.PS
    
  2. Se o módulo não estiver instalado, instale o módulo ao executar o seguinte comando no PowerShell:

    Install-Module -Name MSAL.PS -Scope CurrentUser 
    

Carregar o módulo CopilotLabDSR

  1. Execute o seguinte comando no PowerShell para ativar a execução de scripts transferidos da Internet apenas para esta sessão. Poderá pedir-lhe para confirmar ao escrever "Y".

    Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope Process
    
  2. Execute o seguinte comando para importar o módulo com todos os cmdlets disponíveis.

    Import-module "<location where you saved the CopilotLabDSR.psm1 file>"
    

    Por exemplo, se o ficheiro for guardado em C:\AdminScripts, escreverá:

    Import-module "C:\AdminScripts\CopilotLabDSR.psm1"
    

Exportar os pedidos guardados, apreciados e partilhados de um utilizador específico

  1. A partir de Windows PowerShell, utilize o Export-PromptsUserContent cmdlet para exportar os pedidos guardados, apreciados ou partilhados de um utilizador específico de Galeria de prompts do Copilot.

    Export-PromptsUserContent -UserAadIdOrPrincipalName <Entra ID or UPN of user> -ExportDirectory <output location> -PromptType <type of prompt>
    
Parâmetro Descrição
UserAadIdOrPrincipalName Utilize o ID de Microsoft Entra ou o Nome Principal de Utilizador (UPN) do utilizador para o qual pretende exportar conteúdo.
ExportDirectory Local para armazenar os arquivos de saída. A pasta já deve existir. Se não for especificado, os ficheiros de exportação são guardados na pasta atual.
PromptType Especifique "guardado" para exportar os pedidos guardados pelo utilizador. Especifique "partilhado" para exportar os pedidos para os quais foi gerada uma ligação partilhável para o pedido. Especifique "gostou" para exportar pedidos de que o utilizador gostou.

Por exemplo, o seguinte exporta os pedidos guardados de Reed Smiths no Galeria de prompts do Copilot através do UPN e transfere os ficheiros de exportação para a localização C:\PromptsExportReedSmith.

Export-PromptsUserContent -UserAadIdOrPrincipalName reedsmith@contoso.com -ExportDirectory C:\PromptsExportReedSmith -PromptType saved
  1. Quando lhe for pedido para se autenticar, inicie sessão com uma conta atribuída à função Administração Global e não como o utilizador que pretende exportar.
  2. Depois de o cmdlet do PowerShell ser executado com êxito, aceda à sua localização de exportação para ver os ficheiros exportados.

Exportar pedidos partilhados com uma equipa específica

  1. A partir de Windows PowerShell, utilize o Export-PromptsGroupContent cmdlet para exportar os pedidos publicados para a equipa específica no Galeria de prompts do Copilot.
Export-PromptsGroupContent -M365TeamsGroupId <team ID> -ExportDirectory <output location>
Parâmetro Descrição
M365TeamsGroupId ID da equipa para a qual os pedidos foram partilhados.
ExportDirectory Local para armazenar os arquivos de saída. A pasta já deve existir. Se não for especificado, os ficheiros de exportação são guardados na pasta atual.

Por exemplo, o seguinte exporta os pedidos partilhados no Galeria de prompts do Copilot para a equipa com um ID de "d0efcad2-6744-0de6-0624-ea467d4293af" e transfere os ficheiros de exportação para a localização C:\PromptsExportReedSmith.

Export-PromptsGroupContent -M365TeamsGroupId d0efcad2-6744-0de6-0624-ea467d4293af -ExportDirectory C:\PromptsExportReedSmith

Dica

Para encontrar o ID da equipa, aceda a Equipas>Gerir equipas no centro de administração do Teams.

  1. Quando lhe for pedido para se autenticar, inicie sessão com uma conta atribuída à função Administração Global.
  2. Depois de o cmdlet do PowerShell ser executado com êxito, aceda à sua localização de exportação para ver os ficheiros exportados.

Propriedades contidas no ficheiro de exportação e respetivas descrições

Depois de executar o cmdlet do PowerShell para exportar os dados do utilizador do Galeria de prompts do Copilot, receberá um ficheiro na pasta de localização de transferência. Pode utilizar as informações nas secções seguintes para o ajudar a compreender as propriedades que vê no ficheiro que recebeu.

Exportar ficheiro para os pedidos guardados, apreciados e partilhados de um utilizador específico

O nome do ficheiro tem o prefixo "Utilizador" e o ID de Microsoft Entra do utilizador seguido do tipo de pedidos utilizado para exportação. O ficheiro tem as propriedades listadas na tabela seguinte.

Propriedade Descrição
Prompts Uma matriz de utilizadores guardadas ou partilhadas solicita informações.
Prompt.Title Título do pedido fornecido pelo utilizador ao guardar ou partilhar o pedido.
Prompt.PromptText Texto de pedido
Prompt.Products Uma lista que contém o produto no qual o utilizador guardou ou partilhou o pedido.
Prompt.IsFavorite Booleano (verdadeiro ou falso) que indica que um utilizador guardou ou gostou do pedido.
Prompt.UserActivity.Favorite.IsFavorite Booleano (verdadeiro ou falso) que indica que um utilizador guardou ou gostou do pedido.
Prompt.UserActivity.Favorite.ActivityDateTimeInUtc Hora em que o utilizador guardou ou gostou do pedido.
Prompt.CreatedTime Hora em que o utilizador guardou o pedido.
Prompt.SharedTime Hora em que o utilizador partilhou o pedido
Prompt.HydratedEntities Lista de entidades com informações de tipo e entidade.
Prompt.HydratedEntities.Type Atualmente, são suportados os tipos de entidade Pessoas, Ficheiro e Reunião.
Prompt.HydratedEntities.Entity Informações de entidade com base no tipo de entidade.
Prompt.HydratedEntities.Entity.Id ID de entidade exclusivo.
Prompt.HydratedEntities.Entity.DisplayName Nome a apresentar da entidade pessoa.
Prompt.HydratedEntities.Entity.EmailAddresses Lista de endereços de e-mail para a entidade pessoa.
Prompt.HydratedEntities.Entity.ReferenceId ID exclusivo para mapeamento de instrumentação.
Prompt.HydratedEntities.Entity.FileName Nome da entidade de ficheiro.
Prompt.HydratedEntities.Entity.AccessUrl URL de acesso da entidade de ficheiro.
Prompt.HydratedEntities.Entity.SpoId Identificador de Documento do SharePoint para a entidade Ficheiro.
Prompt.HydratedEntities.Entity.OriginalId ID da reunião da entidade do evento.
Prompt.HydratedEntities.Entity.Subject Assunto da entidade do evento.
Prompt.HydratedEntities.Entity.SkypeTeamsMeetingUrl URL da entidade de evento.
Prompt.HydratedEntities.Entity.Start Hora de início da entidade do evento.
Prompt.HydratedEntities.Entity.End Hora de fim da entidade do evento.
Prompt.HydratedEntities.Entity.OrganizerName Nome do Organizador da entidade do evento.
Prompt.HydratedEntities.Entity.OrganizerAddress Endereço do Organizador da entidade do evento.
Prompt.HydratedEntities.Entity.Attendees Lista de participantes da entidade do evento.

Exportar ficheiro para os pedidos partilhados com uma equipa específica

O nome do ficheiro tem o prefixo "Grupo" e o ID da equipa. O ficheiro tem as propriedades listadas na tabela seguinte.

Propriedade Descrição
Prompts Uma matriz de utilizadores guardadas ou partilhadas solicita informações.
Prompt.Title Título do pedido fornecido pelo utilizador ao guardar ou partilhar o pedido.
Prompt.PromptText Texto de pedido
Prompt.Products Uma lista que contém o produto no qual o utilizador guardou ou partilhou o pedido.
Prompt.PublishedTime Hora em que o pedido foi publicado para a equipa.
Prompt.PublishedBy UPN do utilizador que publicou o pedido à equipa.
Prompt.HydratedEntities Lista de entidades com informações de tipo e entidade.
Prompt.HydratedEntities.Type Atualmente, são suportados os tipos de entidade Pessoas, Ficheiro e Reunião.
Prompt.HydratedEntities.Entity Informações de entidade com base no tipo de entidade.
Prompt.HydratedEntities.Entity.Id ID de entidade exclusivo.
Prompt.HydratedEntities.Entity.DisplayName Nome a apresentar da entidade pessoa.
Prompt.HydratedEntities.Entity.EmailAddresses Lista de endereços de e-mail para a entidade pessoa.
Prompt.HydratedEntities.Entity.ReferenceId ID exclusivo para mapeamento de instrumentação.
Prompt.HydratedEntities.Entity.FileName Nome da entidade de ficheiro.
Prompt.HydratedEntities.Entity.AccessUrl URL de acesso da entidade de ficheiro.
Prompt.HydratedEntities.Entity.SpoId Identificador de Documento do SharePoint para a entidade Ficheiro.
Prompt.HydratedEntities.Entity.OriginalId ID da reunião da entidade do evento.
Prompt.HydratedEntities.Entity.Subject Assunto da entidade do evento.
Prompt.HydratedEntities.Entity.SkypeTeamsMeetingUrl URL da entidade de evento.
Prompt.HydratedEntities.Entity.Start Hora de início da entidade do evento.
Prompt.HydratedEntities.Entity.End Hora de fim da entidade do evento.
Prompt.HydratedEntities.Entity.OrganizerName Nome do Organizador da entidade do evento.
Prompt.HydratedEntities.Entity.OrganizerAddress Endereço do Organizador da entidade do evento.
Prompt.HydratedEntities.Entity.Attendees Lista de participantes da entidade do evento.

Compreender Galeria de prompts no Copilot

Gerir pedidos agendados para o Microsoft 365 Copilot

Gerir cenários do Microsoft 365 Copilot no Centro de administração do Microsoft 365