Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo lista e descreve as atividades do Copilot Studio que o portal Microsoft Purview registra e disponibiliza. Os desenvolvedores também podem acessar esses logs por meio da API de Gerenciamento Office 365.
Alterações no conteúdo e nas configurações de um agente podem afetar a segurança e o comportamento do agente. A auditoria dessas ações ajuda a atenuar falhas, conter sistemas de restrições de segurança, aderir aos requisitos de conformidade e lidar com ameaças à segurança.
Copilot Studio registra atividades relacionadas tanto a aspectos administrativos quanto a interações de criadores e usuários com agentes.
Copilot Studio armazena os dados usados para gerar os logs de auditoria de acordo com seus padrões de segurança e conformidade. Para obter mais informações, consulte Microsoft Copilot Studio segurança e conformidade.
Note
Para agentes com IDs do agente Microsoft Entra, a atividade de autenticação também é registrada em Microsoft Entra ID e visível no centro de administração do Microsoft Entra. Saiba mais em Criar automaticamente IDs do agente Microsoft Entra.
Importante
As atividades administrativas do Copilot Studio são habilitadas por padrão em todos os locatários. Você não pode desabilitar a coleta de atividades, mas pode desabilitar logs de auditoria no Purview e usar políticas de retenção para impedir a retenção do texto da mensagem do usuário e do texto da resposta.
Pré-requisitos
- Os usuários devem ter uma licença de Microsoft 365 atribuída para que o Copilot Studio possa registrar eventos de auditoria e salvar transcrições de suas conversas com Microsoft 365 Copilot.
- O locatário não é um locatário do Federal Risk and Authorization Management Program (FedRAMP).
Acesse os registros
Entre no portal do Microsoft Purview como administrador de locatários.
No menu esquerdo, selecione Mostrar tudo.
Em Soluções, selecione Auditoria.
Os administradores podem filtrar as atividades do Copilot Studio na lista Activities. As atividades são mapeadas para tipos e categorias de eventos, conforme listado nas tabelas a seguir neste artigo.
Os gerentes de conformidade também podem usar a solução DSPM (Data Security Posture Management) para IA para exibir transcrições de chat para eventos do CopilotInteraction. Saiba mais em Data Security Posture Management (DSPM).
Ver eventos auditados (autoria do agente)
Todo o registro em log ocorre na camada do SDK, de modo que uma única ação pode disparar vários eventos registrados em log.
Essa tabela lista eventos normalmente relacionados a ações administrativas no Copilot Studio, como excluir um agente ou atualizar o nome, os detalhes ou a configuração de um agente.
| Categoria | Rótulo do evento | Descrição do evento |
|---|---|---|
| Agents | BotDeleteCleanup |
A limpeza de dependências depois que um agente é excluído no Copilot Studio |
| Agents | BotUpdateOperation-BotNameUpdate |
Atualizando o nome do agente no Copilot Studio |
| Agents | BotCreate |
A criação de um novo agente no Copilot Studio |
| Agents | BotDelete |
A exclusão de um agente no Copilot Studio |
| Agents | BotUpdateOperation-BotAuthUpdate |
Atualizando as configurações de autenticação de um agente no Copilot Studio |
| Agents | BotUpdateOperation-BotIconUpdate |
Atualizando o ícone do agente no Copilot Studio |
| Agents | BotUpdateOperation-BotPublish |
Publicação de um agente no Copilot Studio |
| Agents | BotUpdateOperation-BotShare |
Compartilhamento de um agente para outros usuários no Copilot Studio |
| Agents | BotAppInsightsUpdate |
Atualizando a configuração de log do App Insights de um agente no Copilot Studio |
| Componente do agente | BotComponentCreate |
A criação de um componente (como um tópico ou habilidade) para um agente no Copilot Studio |
| Componente do agente | BotComponentUpdate |
A atualização de um componente (como um tópico ou habilidade) para um agente no Copilot Studio |
| Componente do agente | BotComponentDelete |
A exclusão de um componente (como um tópico ou habilidade) para um agente no Copilot Studio |
| Coleção de Componentes do Agente | BotComponentCollectionCreate |
A criação de uma coleção de componentes para um agente no Copilot Studio |
| Coleção de Componentes do Agente | BotComponentCollectionDelete |
A exclusão de uma coleção de componentes para um agente no Copilot Studio |
| Coleção de Componentes do Agente | BotComponentCollectionUpdate |
A atualização de uma coleção de componentes para um agente no Copilot Studio |
| Plugin de IA | AIPluginOperationCreate |
Criando um plug-in de IA para um agente no Copilot Studio |
| Plugin de IA | AIPluginOperationUpdate |
Atualizando um plug-in de IA para um agente no Copilot Studio |
| Plugin de IA | AIPluginOperationDelete |
Removendo um plug-in de IA para um agente no Copilot Studio |
| Variável de ambiente | EnvironmentVariableCreate |
Criando uma variável de ambiente para um agente no Copilot Studio |
| Variável de ambiente | EnvironmentVariableUpdate |
Atualizando uma variável de ambiente para um agente no Copilot Studio |
| Variável de ambiente | EnvironmentVariableDelete |
Excluindo uma variável de ambiente para um agente no Copilot Studio |
Consultar eventos auditados (uso do agente)
Note
Todo o registro em log ocorre na camada do SDK, de modo que uma única ação pode disparar vários eventos registrados em log.
Alguns canais são excluídos do registro em log.
Para eventos listados na solução de auditoria no Purview, o campo JSON CopilotEventData do evento auditado inclui o canal como o AppHost valor.
Na solução DSPM para IA, o canal é exibido no campo Aplicativo acessado em.
Esta tabela lista eventos que são interações do usuário com agentes Copilot em Copilot Studio, como fazer perguntas e visualizar respostas. O evento auditado contém metadados para essa atividade, incluindo data e hora, organização, IDs de usuário e recurso e a ID do thread de transcrição.
Copilot Studio salva o texto do chat (a transcrição) separadamente do evento auditado no Purview. Você pode ver ou acessar a transcrição diretamente a partir do evento registrado, conforme ele aparece na solução Data Security Posture Management (DSPM) para IA.
Importante
Os logs de auditoria na solução Audit não incluem o texto completo ou a transcrição das interações entre um usuário e o agente, apenas a ID do tópico de transcrição. A solução Data Security Posture Management (DSPM) para IA tenta recuperar o texto do chat relacionado ao evento com links para recursos que foram acessados como parte do evento registrado.
| Categoria | Rótulo do evento | Descrição do evento |
|---|---|---|
| Usuários | CopilotInteraction |
Interações do usuário com um agente do Copilot criado em Copilot Studio, como fazer perguntas e exibir respostas |
Saiba mais sobre eventos de interação do Copilot no Microsoft 365 em Visão geral dos eventos de interação do Copilot.
Campos de auditoria do esquema
Esquemas definem quais campos de agente são enviados para o portal Microsoft Purview. Alguns campos são comuns a todos os aplicativos que enviam dados de auditoria para Microsoft Purview, enquanto outros são específicos para Copilot Studio. Os campos a seguir são comuns ao Power Platform.
| Nome de exibição do campo | Nome lógico | Tipo | Obrigatório | Description |
|---|---|---|---|---|
| Data | CreationTime |
Edm.Date |
Não | Data e hora da geração do log no UTC. |
| ID | ID |
Edm.Guid |
Não | GUID único e exclusivo para cada linha logada. |
| Status do resultado | ResultStatus |
Edm.String |
Não | Status da linha logada. |
| ID da organização | OrganizationId |
Edm.Guid |
Sim | Identificador exclusivo da organização na qual o log foi gerado. |
| Operation | Operation |
Edm.String |
Não | Nome da operação, incluindo o rótulo do evento. |
| User | UserKey |
Edm.String |
Não | Identificador exclusivo do usuário em Microsoft Entra ID. |
| Tipo de usuário | UserType |
Self.UserType |
Não | O tipo de auditoria (administrador, normal ou sistema). |
Campos de auditoria do Copilot Studio
Além dos campos comuns às atividades de administrador do Power Platform, Copilot Studio inclui os campos a seguir.
| Name | Tipo | Obrigatório | Description |
|---|---|---|---|
BotId |
Edm.String |
Não | Um identificador exclusivo do agente |
BotSchemaName |
Edm.String |
Não | Uma cadeia de caracteres exclusiva que identifica o agente |
BotUpdateDetails |
Edm.ComplexType (coleção) |
Não | Detalhes das propriedades atualizadas no agente |
BotComponentId |
Edm.String |
Não | Um identificador exclusivo dos componentes agente, como tópicos ou entidades |
BotComponentSchemaName |
Edm.String |
Não | Uma cadeia de caracteres exclusiva que identifica os componentes de um agente, como tópicos ou entidades |
BotComponentType |
Edm.String |
Não | O tipo de componente do agente, como tópicos ou entidades |
BotComponentUpdateDetails |
Edm.ComplexType (coleção) |
Não | Detalhes das propriedades atualizadas do componente do agente |
AIPluginOperationId |
Edm.String |
Não | Um identificador exclusivo para a operação com o plug-in de IA |
AIPluginOperationName |
Edm.String |
Não | O nome da operação com o plugin de IA |
EnvironmentVariableDefinitionSchemaName |
Edm.String |
Não | Nome do esquema para a definição da variável de ambiente associada ao agente |
EnvironmentVariableDefinitionId |
Edm.String |
Não | Um identificador exclusivo para a definição da variável de ambiente associada ao agente |
Desativar registro de auditoria
Você pode desabilitar o registro de todos os eventos de auditoria em seu locatário no Purview.
Para evitar a retenção de texto de usuário e agente, você pode criar uma política de Gerenciamento do Ciclo de Vida de Dados no Purview, que estabelece uma política de retenção de 0 dias para experiências do Copilot.
Saiba mais em Criar e configurar políticas de retenção.