Copilot Memory permite que Copilot aprenda sobre sua base de código e suas preferências pessoais, ajudando os agentes Copilot a trabalharem com mais eficiência. Para obter mais informações, consulte Sobre a Memória do GitHub Copilot.
Habilitando o Copilot Memory
Para assinaturas gerenciadas por empresa e gerenciadas Copilot pela organização, as preferências no nível do usuário estão desativadas por padrão. Um administrador deve habilitar a Copilot Memory política antes que os membros possam usar preferências no nível do usuário.
Depois que essa política estiver habilitada, o armazenamento e o uso das preferências no nível do usuário estarão ativados por padrão para membros que não optaram por não participar. Os membros ainda podem recusar individualmente. Habilitar a política não limpa uma desativação de aplicativo pessoal ou local existente.
Os fatos no nível do repositório são controlados separadamente por meio das configurações de acesso ao repositório, cujo padrão é Todos os repositórios para uma organização. Uma organização pode permitir preferências no nível do usuário sem fatos no nível do repositório ou permitir fatos no nível do repositório sem preferências no nível do usuário, sujeitas a restrições da empresa. Consulte Gerenciar Copilot Memory repositórios.
Observação
Se um usuário for atribuído a uma Copilot assinatura por mais de uma organização, a política de memória do usuário mais restritiva se aplicará. As preferências no nível do usuário não serão usadas, a menos que todas essas organizações as permitam.
Para ver configurações padrão por plano e superfície, consulte Sobre a Memória do GitHub Copilot.
Os usuários em planos pagos compatíveis podem desativar preferências de nível de usuário em suas configurações pessoais Copilot. Isso afeta apenas suas sessões. Ele não desabilita fatos no nível do repositório nem altera as sessões de outros usuários.
As configurações de cliente local, como /memory off em Copilot CLI, podem desabilitar ambos os tipos de memória para esse cliente. Consulte Gerenciamento de memória Copilot para sua conta pessoal.
Habilitando Copilot Memory para uma empresa
O procedimento a seguir define a política da empresa para preferências no nível do usuário — as memórias sobre como os membros individuais querem que Copilot trabalhe com eles. Como proprietário da empresa, você pode permitir ou bloquear essas preferências em todas as organizações ou permitir que os proprietários da organização decidam. Essa é uma política de toda a empresa, não uma alteração nas configurações pessoais de um membro individual.
Os fatos no nível do repositório têm controles de acesso separados. Para desabilitar os dois tipos de Copilot Memory para sua empresa, você precisa desabilitar as preferências no nível do usuário e o acesso à memória do repositório. Para controles no nível do repositório, consulte Gerenciando Copilot Memory repositórios.
-
Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
-
Na parte superior da página, clique em controles de IA.
-
Na barra lateral, clique em Copilot.
-
Em "Recursos &clientes", clique em Configurar recursos e clientes.
-
Role para baixo até "Recursos", localize a configuração Copilot Memory e selecione uma política na lista suspensa.
- As organizações decidem: as preferências no nível do usuário estão desativadas por padrão para todas as organizações na empresa. Os proprietários da organização poderão habilitá-los para sua organização, se desejarem.
- Habilitados em todos os lugares: as preferências no nível do usuário são habilitadas para todas as organizações da empresa e não podem ser desabilitadas no nível da organização. Usuários individuais ainda podem desativar.
- Desabilitado em todos os lugares: as preferências no nível do usuário estão desabilitadas para todas as organizações da empresa e não podem ser habilitadas no nível da organização.
Ativando Copilot Memory para uma organização
Os proprietários da organização podem habilitar ou desabilitar Copilot Memory para armazenar e usar preferências no nível do usuário para todos os membros da organização com uma licença Copilot.
Se a organização pertencer a uma empresa, a capacidade dos proprietários da organização de habilitar ou desabilitar Copilot Memory poderá ser controlada pela política de nível empresarial.
-
No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.
-
Selecione uma organização clicando nela.
-
No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

-
Na barra lateral, em "Código, planejamento e automação", clique Copilot e clique em Políticas.
-
Em "Recursos", role para baixo até a configuração para Copilot Memory.
-
Clique no menu suspenso e selecione Habilitado.
As preferências no nível do usuário são habilitadas para todos os membros da organização que têm uma Copilot licença.
Configure informações no nível do repositório separadamente com os controles de acesso do repositório. Consulte Gerenciar Copilot Memory repositórios nas configurações de uma organização posteriormente neste artigo.
Habilitando o Copilot Dreaming
Copilot Dreaming está desabilitado por padrão. Os proprietários da empresa e os proprietários da organização podem controlar Copilot Dreaming em seus repositórios de propriedade da organização e se os usuários que recebem Copilot acesso de sua empresa ou organização podem habilitar o Dreaming pessoal. Para obter mais informações, consulte Sobre o GitHub Copilot Dreaming.
Permitir Copilot Dreaming por meio de uma política corporativa ou organizacional não habilita automaticamente Dreaming pessoal. Os usuários também devem habilitar Copilot Memory e Copilot Dreaming em suas configurações pessoais Copilot — consulte Gerenciamento de memória Copilot para sua conta pessoal. Os usuários não podem ignorar uma política gerenciada aplicável que impede ignorar Copilot Dreaming.
Observação
Copilot Dreaming está dentro de prévia pública e está sujeito a alterações.
Habilitando Copilot Dreaming para uma empresa
-
Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
-
Na parte superior da página, clique em controles de IA.
-
Na barra lateral, clique em Copilot.
-
Em "Recursos &clientes", clique em Configurar recursos e clientes.
-
Localize a seção "Memory".
-
Verifique se a política para Copilot Memory está definida como Permitir que as organizações decidam ou habilitadas em todos os lugares. Habilitar Copilot Memory não habilita, por si só, Copilot Dreaming.
-
Defina a política para Copilot Dreaming:
Policy Effect
Deixe as organizações decidirem | Inicialmente Copilot Dreaming está desabilitado para todas as organizações, mas os proprietários da organização podem habilitar e desabilitar Dreaming. | | Ativado em todos os lugares | Dentro do escopo Copilot Memory, as organizações herdam uma política habilitada e não podem desabilitá-la no nível da organização. | | Desativado em toda parte | As organizações não podem habilitar Copilot Dreaming. |
Para um piloto, selecione Deixar as organizações decidirem e configure apenas as organizações pretendidas.
Alterar uma política de Habilitada em todos os lugares para Permitir que as organizações decidam deixa Copilot Dreaming habilitado para todas as organizações, mas permite que os proprietários da organização o desabilitem.
Ativando Copilot Dreaming para uma organização
Se sua organização pertencer a uma empresa, a empresa deverá selecionar Deixar as organizações decidirem antes que o proprietário de uma organização possa alterar sua Copilot Dreaming política. Uma configuração bloqueada indica que a empresa controla a política.
-
No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.
-
Selecione uma organização clicando nela.
-
No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

-
Na barra lateral, em "Código, planejamento e automação", clique Copilot e clique em Políticas.
-
Localize a seção "Memory".
-
Examine a configuração de acesso do Repositório antes de habilitar Copilot Dreaming. Quando você habilitar Copilot Dreaming, ele será habilitado para todos os repositórios cobertos pela configuração de acesso do repositório atual.
-
** Dreaming ** Na lista suspensa, selecione Habilitado.
A opção Habilitada só se aplica a repositórios na seleção de repositório Copilot Memory. Remover um repositório dessa seleção desabilita tanto Copilot Memory quanto Copilot Dreaming para esse repositório.
Visualizar Copilot Dreaming resulta em Copilot app
As configurações no GitHub.com controlam se Copilot Dreaming está habilitado, mas não exibem resultados de execução individuais para Dreaming. Para ver o que uma execução produziu, use o Copilot app.
Entre com a GitHub.com conta cujas execuções pessoais você deseja exibir ou uma conta com acesso aos repositórios relevantes.
Adicionando um repositório ao Copilot app
As execuções de repositório são exibidas para repositórios que você adicionou ao Copilot app. Se o repositório já estiver listado na barra lateral, você poderá ignorar esse procedimento. Você não precisa adicionar um repositório para visualizar execuções de sonhos pessoais.
- Na Copilot app barra lateral, à direita do título "Sessões", clique no ícone de mais da nova sessão.
- Clique em Adicionar GitHub repositório.
- Pesquise o repositório pelo
OWNER/REPOSITORYnome e selecione-o nos resultados da pesquisa. - Repita para cada repositório cujas execuções você deseja exibir.
Abrindo uma execução e revisando sua saída
-
Na barra lateral do aplicativo, clique em Automações.
-
Clique na guia Dreaming.
Se isso não for exibido, atualize sua versão do Copilot.
-
Encontre sua execução em execuções do Dream pessoal ou execuções do Dream do repositório.
Observação
Copilot Dreaming é executado automaticamente em um agendamento gerenciado por GitHub. Uma execução pode não aparecer imediatamente depois que você habilitar Copilot Dreaming.
-
Clique em uma execução para abrir seus detalhes.
-
Examine os detalhes:
- Examine o status da execução (por exemplo, "Executando", "Concluído" ou "Falha") e, quando disponível, o breve resumo da execução. Verifique se há avisos ou detalhes de falha.
- Para uma execução de curadoria de memória, examine as Memory atualizações disponíveis, rotuladas adicionadas, atualizadas ou removidas. As memórias atualizadas mostram o texto Antes e Depois quando disponível.
- Se a execução incluir um link de pull request, abra o pull request para examinar as instruções ou as alterações de habilidade propostas em GitHub.com.
-
Para recarregar a lista de execuções, retorne à guia Dreaming e clique em Atualizar execuções.
As execuções de atualização recarrega a lista. Ele não inicia as execuções. Você não pode iniciar execuções manualmente ou editar seus agendamentos, prompts ou o modelo usado por Copilot Dreaming.
Gerenciando a retenção Copilot Memory
Por padrão, os fatos no nível do repositório e as preferências no nível do usuário expiram 90 dias depois de serem criados ou receberem um voto positivo de Copilot pela última vez. A simples recuperação de uma lembrança não estende esse período. Os proprietários da empresa e da organização podem configurar o período de retenção para que os dados no nível do repositório fiquem entre 7 e 180 dias.
Observação
- O período de retenção configurável aplica-se somente a fatos no nível do repositório. As preferências no nível do usuário sempre usam o período de retenção padrão.
- Se uma organização e uma empresa definirem um período de retenção, o menor dos dois se aplicará.
- Alterar o período de retenção não altera a data dos fatos que já estão armazenados. Um fato existente só adota o novo período na próxima vez que Copilot o reforçar.
Como gerenciar a retenção de Copilot Memory em uma organização
- Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
- Na parte superior da página, clique em controles de IA.
- Na barra lateral, clique em Copilot.
- Em "Recursos &clientes", clique em Configurar recursos e clientes.
- Role para baixo até "Funcionalidades" e localize as configurações Copilot Memory.
- Edite o número de dias na Copilot Memoryconfiguração de retenção e clique em Salvar.
Gerenciando a Copilot Memory retenção para uma organização
-
No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.
-
Selecione uma organização clicando nela.
-
No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

-
Na barra lateral, em "Código, planejamento e automação", clique Copilot e clique em Políticas.
-
Em "Funcionalidades", role para baixo até as configurações Copilot Memory.
-
Edite o número de dias na Copilot Memory configuração de retenção e clique em Salvar período de retenção.
Gerenciando preferências de usuário
Os proprietários de empresas e organizações podem gerenciar preferências de nível de usuário para usuários cujas Copilot licenças são atualmente faturadas para sua empresa ou organização. Os usuários também podem gerenciar suas próprias preferências. Consulte Gerenciamento de memória Copilot para sua conta pessoal.
Gerenciando preferências de nível de usuário para uma empresa
Como administrador, você pode exportar ou excluir todas as preferências de nível de usuário que foram geradas com sua organização ou empresa como a entidade de cobrança ativa. Para obter mais informações sobre o modelo de propriedade, consulte Sobre a Memória do GitHub Copilot.
Baixando preferências no nível do usuário para uma organização
Você pode exportar preferências no nível do usuário no formato JSONL. Você pode fazer isso para todos de uma vez ou para usuários individuais.
-
Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
-
Na parte superior da página, clique em Billing and licensing.
-
Na barra lateral "Cobrança e licenciamento", clique em Licenciamento.
-
Na seção "Copilot", clique em Gerenciar.
-
A partir daqui, você pode exportar preferências para todos ou para um usuário individual.
-
Para um usuário individual: ao lado do nome do usuário, clique em e clique em Export Copilot memories.
-
Para todos: clique na lista suspensa Receber relatórios perto da parte superior da página e clique em Fazer download das memórias do usuário.
Observação
Você também pode baixar todas as preferências no nível do usuário na página "Recursos & clientes" na guia "Controles de IA" (Controles de IA > Copilot > Configurar recursos & clientes).
-
-
Na caixa de diálogo de confirmação, clique em Download Memories. Isso confirma que você tem permissão para acessar as memórias dos usuários. O download é iniciado quando a exportação está pronta.
As exportações são reutilizáveis por até duas horas, portanto, um download repetido pode não refletir alterações recentes. Somente o administrador que solicitou uma exportação pode verificar seu status ou baixá-lo. Outro administrador não pode solicitar a mesma exportação em massa ou por usuário enquanto essa exportação reutilizável existe. A criação de novas exportações é limitada a 10 por hora por empresa, mas as exportações reutilizados não contam para esse limite.
Excluindo preferências de nível de usuário para uma organização
Você pode excluir preferências de nível de usuário em massa ou para usuários individuais.
-
Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
-
Na parte superior da página, clique em Billing and licensing.
-
Na barra lateral "Cobrança e licenciamento", clique em Licenciamento.
-
Na seção "Copilot", clique em Gerenciar.
-
A partir daqui, você pode excluir preferências para todos ou para um usuário individual.
- Para um usuário individual: ao lado do nome do usuário, clique em e, em seguida, clique em Excluir memórias do Copilot.
- Para todos: clique na lista suspensa Get reports perto da parte superior da página e clique em Delete user memories.
-
Examine os usuários incluídos na caixa de diálogo de confirmação e clique em Excluir lembranças. A exclusão é permanente e não pode ser desfeita.
Gerenciando preferências de nível de usuário para uma organização
Como proprietário da organização, você pode exportar ou excluir as preferências desses usuários que foram geradas com sua organização como a entidade de cobrança ativa. Para obter mais informações sobre o modelo de propriedade, consulte Sobre a Memória do GitHub Copilot.
O proprietário de uma preferência no nível do usuário é definido quando a preferência é criada por Copilot Memory e ela não é alterada posteriormente. Se a licença de um usuário for movida para uma organização ou empresa diferente, as preferências geradas anteriormente permanecerão associadas à conta que as possuía no momento.
Observação
Os fatos no nível do repositório não pertencem a uma entidade de faturamento. Eles pertencem ao repositório no qual foram criados e são gerenciados lá, independentemente de qualquer alteração na licença de um usuário individual.
Exportando preferências de nível de usuário para uma organização
Você pode exportar preferências no nível do usuário no formato JSONL. Você pode fazer isso para todos de uma vez ou para usuários individuais.
-
Em GitHub, acesse a página principal da organização.
-
No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

-
Na barra lateral, em "Código, planejamento e automação", clique Copilot e clique em Access.
-
A partir daqui, você pode exportar preferências para todos ou para um usuário individual.
- Para um usuário individual: ao lado do nome do usuário, clique em e clique em Export Copilot memories.
- Para todos: clique no menu suspenso Obter relatório de uso e, em seguida, clique em Baixar memórias de usuário.
-
Na caixa de diálogo de confirmação, clique em Download Memories. Isso confirma que você tem permissão para acessar as memórias dos usuários. O download é iniciado quando a exportação está pronta.
As exportações são reutilizáveis por até duas horas, portanto, um download repetido pode não refletir alterações recentes. Somente o administrador que solicitou uma exportação pode verificar seu status ou baixá-lo. Outro administrador não pode solicitar a mesma exportação em massa ou por usuário enquanto essa exportação reutilizável existe. A criação de novas exportações é limitada a 10 por hora por organização, mas as exportações reutilizadas não contam para esse limite.
Excluindo preferências de nível de usuário para uma organização
Você pode excluir preferências de nível de usuário em massa ou para usuários individuais.
-
Em GitHub, acesse a página principal da organização.
-
No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

-
Na barra lateral, em "Código, planejamento e automação", clique Copilot e clique em Access.
-
A partir daqui, você pode excluir preferências para todos ou para um usuário individual.
- Para um usuário individual: ao lado do nome do usuário, clique em e, em seguida, clique em Excluir memórias do Copilot.
- Para todos: clique no menu suspenso Obter relatório de uso e, em seguida, clique em Excluir memórias de usuário.
-
Examine os usuários incluídos na caixa de diálogo de confirmação e clique em Excluir lembranças. A exclusão é permanente e não pode ser desfeita.
Gerenciamento Copilot Memory de repositórios
Os proprietários da organização podem gerenciar o acesso a Copilot Memory para repositórios selecionados ou todos os repositórios da organização. Os administradores do repositório podem gerenciar Copilot Memory as configurações do seu repositório.
Gerenciamento de Copilot Memory para repositórios nas configurações de uma organização
Os proprietários da organização podem permitir o armazenamento e o uso de fatos no nível do repositório para todos os repositórios, repositórios selecionados ou nenhum repositório de propriedade da organização, sujeitos a restrições empresariais. A configuração de acesso do repositório padrão é Todos os repositórios. Esse controle é independente da política para preferências no nível do usuário.
-
No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.
-
Selecione uma organização clicando nela.
-
No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

-
Na barra lateral, em "Código, planejamento e automação", clique Copilot e clique em Políticas.
-
Em "Recursos", role para baixo até a configuração para Copilot Memory.
-
Clique no botão suspenso para "Acesso ao Repositório" e escolha uma das opções:
- Nenhum repositório: os fatos no nível do repositório não são armazenados ou usados para quaisquer repositórios pertencentes a essa organização.
- Todos os repositórios: os fatos no nível do repositório são armazenados e usados para todos os repositórios pertencentes a essa organização.
- Repositórios selecionados: os fatos no nível do repositório só são armazenados e usados para os repositórios que você selecionar.
-
Se você escolheu repositórios selecionados, clique no botão ao lado de "Repositórios selecionados" e escolha os repositórios para os quais deseja habilitar fatos no nível do repositório.
Gerenciar Copilot Memory nas configurações de um repositório
Os administradores do repositório podem gerenciar Copilot Memory as configurações do seu repositório.
Desabilitando Copilot Memory para o repositório
Como administrador de repositório, você pode desativar Copilot Memory para o seu repositório.
Quando você desabilitar Copilot Memory para um repositório, Copilot para de criar e aplicar fatos no nível do repositório nesse repositório. Dados que já estavam armazenados não são mais usados, mas não são excluídos ao desabilitar a configuração.
-
Em GitHub, acesse a página principal do repositório.
-
No nome do repositório, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

-
Na barra lateral, em "Código, planejamento e automação", clique Copilote clique em Memória.
-
Clique no botão de alternância Permitir Copilot armazenar e recuperar fatos do repositório para alterá-lo de Ativado para Desativado.
Observação
Desabilitar Copilot Memory para um repositório não afeta as preferências no nível do usuário. As preferências descrevem como um indivíduo gosta de trabalhar em vez de qualquer coisa sobre uma base de código específica, para que eles sigam o usuário e ainda se apliquem nesse repositório. Se você precisar impedir totalmente as preferências de usuário, desabilite Copilot Memory no nível da organização ou da empresa.
Exibindo e excluindo fatos no nível do repositório
Para exibir ou excluir fatos no nível do repositório nas configurações do repositório, você deve ter acesso de gravação ao repositório e às preferências no nível do usuário habilitadas para sua conta, incluindo permissão de qualquer política empresarial ou organizacional aplicável. Esse requisito se aplica à página de configurações. A possibilidade de os agentes usarem fatos no nível do repositório é controlada separadamente pelas configurações de acesso do repositório e pelas configurações de cliente aplicáveis.
Você pode examinar os fatos armazenados e excluir qualquer um que seja inadequado, enganoso ou incorreto. Somente os administradores do repositório podem alterar a configuração Copilot Memory do repositório.
-
Em GitHub, acesse a página principal do repositório.
-
No nome do repositório, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

-
Na barra lateral, em "Código, planejamento e automação", clique Copilote clique em Memória.
-
Para excluir uma memória, clique ao lado dela. Para excluir várias memórias ao mesmo tempo, selecione suas caixas de seleção e clique em Excluir.
Auditoria Copilot Memory
Entradas de ciclo de vida da memória são adicionadas ao log de auditoria da sua organização ou enterprise quando uma memória é criada ou excluída.
As exportações de administrador também geram entradas de log de auditoria quando são solicitadas, concluídas e baixadas. Alterações nas configurações de Copilot Memory e no acesso ao repositório também podem aparecer no log de auditoria.
As entradas de log de auditoria registram que um evento ocorreu, juntamente com metadados, como quem executou a ação e quando. Eles nunca contêm o conteúdo de uma memória, suas citações ou o motivo pelo qual ela foi criada ou excluída.
Para localizar quando as memórias do repositório foram criadas e qual usuário iniciou a atividade, pesquise por action:copilot.memory_created repo:ORG/REPO. Substitua ORG/REPO pelo proprietário e pelo nome do repositório.
Recuperar uma memória, votar nela ou sua expiração automática não cria um evento de auditoria do ciclo de vida da memória.
Exibindo entradas de log de auditoria para uma enterprise
-
Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
-
Na parte superior da página, clique em Configurações.
-
Em "Configurações", clique em Audit log.
-
Insira um dos seguintes no campo de pesquisa.
action:copilot.memorypara atividade no nível do usuárioaction:org.copilot_memorypara atividade de nível de proprietário da organizaçãoaction:business.copilot_memorypara atividade no nível do proprietário da organização
Os tipos de auditoria disponíveis são exibidos em uma lista suspensa.
-
Selecione um tipo de auditoria na lista suspensa e pressione Enter para exibir logs de auditoria para esse tipo de atividade.
Exibindo entradas de log de auditoria para uma organização
-
No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.
-
Selecione uma organização clicando nela.
-
No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

-
Na seção "Archive" da barra lateral, clique em Logs e, em seguida, clique em Audit log.
-
Insira um dos seguintes no campo de pesquisa.
action:copilot.memorypara atividade no nível do usuárioaction:org.copilot_memorypara atividade de nível de proprietário da organização
Os tipos de auditoria disponíveis são exibidos em uma lista suspensa.
-
Selecione um tipo de auditoria na lista suspensa e pressione Enter para exibir logs de auditoria para esse tipo de atividade.