Compartilhar via

Visualizar logs de auditoria do Copilot Studio

  • Artigo

Alterações no conteúdo e nas configurações de um agente podem afetar a segurança e o comportamento de agente. É importante auditar essas ações para ajudar a mitigar falhas, conter sistemas de restrições de segurança, aderir aos requisitos de conformidade e agir em ameaças à segurança.

Este artigo lista e descreve as atividades do Copilot Studio registradas e disponíveis usando o portal de conformidade do Microsoft Purview.

Importante

  • As atividades administrativas do Copilot Studio são habilitadas por padrão em todos os locatários. Você não pode desativar a coleta de atividades.
  • Pelo menos um usuário com uma licença do Microsoft 365 E5 ou superior atribuída, conforme exigido pelo Microsoft Purview. Mais informações: Auditando soluções no Microsoft Purview

Visualize os logs de auditoria do Copilot Studio no portal de conformidade do Microsoft Purview

Você pode encontrar logs de atividades do Copilot Studio no centro de conformidade do Microsoft Purview. Esses logs também podem ser acessados pelos desenvolvedores por meio da API de gerenciamento do Office 365.

Acessar os logs

  1. Entre no portal de conformidade do Microsoft Purview como administrador de locatários.

  2. No menu esquerdo, selecione Mostrar tudo.

  3. Selecione Auditoria na categoria Soluções.

    Selecione Auditoria no menu.

Os administradores podem filtrar atividades específicas na lista Atividades . Copilot Studio as atividades estão listadas Here.

Ver eventos auditados

Todo o registro é feito na camada SDK, portanto, uma única ação pode acionar vários eventos registrados. Veja uma lista de eventos que você pode auditar.

Category Evento Description
Agentes BotCreate A criação de um novo agente em Copilot Studio
Agentes BotDelete A exclusão de um agente em Copilot Studio
Agentes BotAuthUpdate Atualizando as configurações de autenticação de um agente em Copilot Studio
Agentes BotIconUpdate Atualizando o ícone agente em Copilot Studio
Agentes BotPublish Publicação de um agente em Copilot Studio
Agentes BotShare Compartilhamento de um agente com outros usuários em Copilot Studio
Agentes BotAppInsightsUpdate Atualizando a configuração de registro do App Insights de um agente em Copilot Studio
Componente agente BotComponentCreate A criação de um componente (como um tópico ou habilidade) para um agente em Copilot Studio
Componente agente BotComponentUpdate A atualização de um componente (por exemplo, tópico, habilidade, etc.) para um agente em Copilot Studio
Componente agente BotComponentDelete A exclusão de um componente (por exemplo, tópico, habilidade, etc.) para um agente em Copilot Studio
Plugin de IA AIPluginOperationCreate Criando um plug-in de IA para um agente em Copilot Studio
Plugin de IA AIPluginOperationUpdate Atualizando um plug-in de IA para um agente em Copilot Studio
Plugin de IA AIPluginOperationDelete Removendo um plug-in de IA para um agente em Copilot Studio
Variável de ambiente EnvironmentVariableCreate Criando uma variável de ambiente para um agente em Copilot Studio
Variável de ambiente EnvironmentVariableUpdate Atualizando uma variável de ambiente para um agente em Copilot Studio
Variável de ambiente EnvironmentVariableDelete Excluindo uma variável de ambiente para um agente em Copilot Studio

Obtenha detalhes sobre o esquema base para registro

Os esquemas definem os campos do Power Automate que são enviados para o portal de conformidade do Microsoft Purview. Alguns campos são comuns para todos os aplicativos que enviam dados de auditoria ao Microsoft 365, enquanto outros são específicos ao Power Automate. O esquema base contém esses campos em comum.

Campos comuns de auditoria

Os esquemas definem quais campos agente são enviados para o portal de conformidade do Purview Microsoft. Alguns campos são comuns para todos os aplicativos que enviam dados de auditoria ao Microsoft Purview, enquanto outros são específicos do Copilot Studio. Os seguintes são campos comuns ao Power Platform.

Nome de exibição do campo Nome lógico Type Obrigatório Description
Date CreationTime Edm.Date No Data e hora da geração do log no UTC.
Identificação ID Edm.Guid No GUID exclusivo para cada linha registrada.
Status do resultado ResultStatus Edm.String No Status da linha registrada.
ID da organização OrganizationId Edm.Guid Sim Identificador exclusivo da organização na qual o log foi gerado.
Operation Operation Edm.String No Nome da operação.
User UserKey Edm.String No Identificador exclusivo do usuário no Microsoft Entra ID.
Tipo de usuário UserType Self.UserType No O tipo de auditoria (administrador, normal ou sistema).

Campos de auditoria do Copilot Studio

Além dos campos comuns às Power Platform atividades do administrador, Copilot Studio inclui os seguintes campos.

Name Type Obrigatório Description
BotId Edm.String No Um identificador exclusivo do agente
BotSchemaName Edm.String No Uma sequência única que identifica o agente
BotUpdateDetails Edm.ComplexType (Coleção) No Detalhes das propriedades atualizadas no agente
BotComponentId Edm.String No Um identificador exclusivo dos componentes agente, como tópicos, entidades
BotComponentSchemaName Edm.String No Uma sequência única que identifica os componentes de agente, como tópicos, entidades
BotComponentType Edm.String No Tipo do componente agente, como tópicos, entidades
BotComponentUpdateDetails Edm.ComplexType (Coleção) No Detalhes das propriedades atualizadas do componente agente
AIPluginOperationId Edm.String No Um identificador exclusivo da operação com o plug-in de IA
AIPluginOperationName Edm.String No Nome da operação com o plug-in de IA
EnvironmentVariableDefinitionSchemaName Edm.String No Nome do esquema para a definição da variável de ambiente associada ao agente
EnvironmentVariableDefinitionId Edm.String No Um identificador exclusivo para a definição da variável de ambiente associada ao agente

Conteúdo relacionado