Exclusión del contenido de GitHub Copilot

Configuración de la exclusión de contenido para el repositorio

Puede usar la configuración del repositorio para especificar contenido en el repositorio que GitHub Copilot debe omitir.

          CLI de GitHub Copilot, agente en la nube de Copiloty el modo agente en Chat de Copiloto los IDE, no admiten la exclusión de contenido. Para obtener más información sobre estas Copilot características, consulte [AUTOTITLE](/copilot/concepts/agents/about-copilot-cli), [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) y [AUTOTITLE](/copilot/how-tos/chat-with-copilot/chat-in-ide).

1. En GitHub, navegue hasta la página principal del repositorio.

2. Debajo del nombre del repositorio, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

   

3. En la sección "Código y automatización" de la barra lateral, haga clic en Copilot****Exclusión de contenido.

   Si su repositorio hereda alguna exclusión de su organización principal o de organizaciones de la misma empresa, verá uno o más cuadros grises en la parte superior de la página con detalles de estas exclusiones. No puede editar esta configuración.

4. En el cuadro que sigue a "Rutas de acceso que se excluirán en este repositorio", escriba las rutas de acceso a los archivos desde los que Copilot se debe excluir.

   Use el formato - "/PATH/TO/DIRECTORY/OR/FILE" con cada ruta de acceso en una línea independiente. Puede agregar comentarios iniciando una línea con #.

   Sugerencia

   Puede usar la notación de coincidencia de patrones de tipo fnmatch para especificar rutas de acceso a los archivos. Los patrones no distinguen mayúsculas de minúsculas. Consulte Archivo en la documentación de ruby-doc.org.

Ejemplo de rutas de acceso especificadas en la configuración del repositorio

# Ignore the `/src/some-dir/kernel.rs` file in this repository.
- "/src/some-dir/kernel.rs"

# Ignore files called `secrets.json` anywhere in this repository.
- "secrets.json"

# Ignore all files whose names begin with `secret` anywhere in this repository.
- "secret*"

# Ignore files whose names end with `.cfg` anywhere in this repository.
- "*.cfg"

# Ignore all files in or below the `/scripts` directory of this repository.
- "/scripts/**"

- "/src/some-dir/kernel.rs"

- "secrets.json"

- "secret*"

- "*.cfg"

- "/scripts/**"

# Ignore the `/src/some-dir/kernel.rs` file in this repository.
- "/src/some-dir/kernel.rs"

# Ignore files called `secrets.json` anywhere in this repository.
- "secrets.json"

# Ignore all files whose names begin with `secret` anywhere in this repository.
- "secret*"

# Ignore files whose names end with `.cfg` anywhere in this repository.
- "*.cfg"

# Ignore all files in or below the `/scripts` directory of this repository.
- "/scripts/**"

Configuración de la exclusión de contenido para la organización

Puede usar la configuración de la organización para especificar los archivos que GitHub Copilot deben omitirse. Los archivos pueden estar dentro de un repositorio de Git o en cualquier parte del sistema de archivos que no está bajo control de Git.

1. En la esquina superior derecha de GitHub, haz clic en la foto del perfil y luego en Your organizations.

2. Seleccione una organización haciendo clic en ella.

3. Debajo del nombre de la organización, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

   

4. En la barra lateral izquierda, haga clic en Copilot****Exclusión de contenido.

5. En el cuadro siguiente "Repositorios y rutas de acceso que se van a excluir", escriba los detalles de los archivos de los que Copilot se debe excluir.

   Para excluir archivos ubicados en cualquier lugar (dentro de un repositorio de Git o en otro lugar), escriba "*": seguido de la ruta de acceso al archivo, o archivos, que desea excluir. Si desea especificar varios patrones de ruta de acceso de archivo, enumere cada patrón en una línea independiente.

   Para excluir archivos de un repositorio de Git de Copilot, escriba una referencia al repositorio en una línea, seguida de rutas de acceso a ubicaciones dentro del repositorio, con cada ruta de acceso en una línea independiente. Use el formato siguiente, reemplazando REPOSITORY-REFERENCE por una referencia al repositorio que contiene los archivos que desea excluir:

   REPOSITORY-REFERENCE:
     - "/PATH/TO/DIRECTORY/OR/FILE"
     - "/PATH/TO/DIRECTORY/OR/FILE"
     - ...
   

   Se puede hacer referencia a repositorios mediante varios protocolos. Puede usar cualquiera de las sintaxis siguientes para REPOSITORY-REFERENCE y Copilot coincidirá con ellas independientemente de cómo se clone localmente el repositorio:

   http[s]://host.xz[:port]/path/to/repo.git/
   
   git://host.xz[:port]/path/to/repo.git/
   
   [user@]host.xz:path/to/repo.git/
   
   ssh://[user@]host.xz[:port]/path/to/repo.git/
   

   Las partes user@ y :port de REPOSITORY-REFERENCE se omiten en el cálculo de las rutas de acceso que se omitirán en un repositorio.

   Para Azure DevOps, puede usar el nuevo formato de host (dev.azure.com) o antiguo (visualstudio.com) al especificar REPOSITORY-REFERENCE y Copilot coincidirá con ellos independientemente del host que se haya usado para clonar el repositorio localmente.

   Sugerencia

   Puede usar la notación de coincidencia de patrones de tipo fnmatch para especificar rutas de acceso a los archivos. Los patrones no distinguen mayúsculas de minúsculas. Consulte Archivo en la documentación de ruby-doc.org.

Ejemplo de repositorios y rutas de acceso en la configuración de la organización

# Ignore all `.env` files from all file system roots (Git and non-Git).
# For example, this excludes `REPOSITORY-PATH/.env` and also `/.env`.
# This could also have been written on a single line as:
#
# "*": ["**/.env"]
"*":
  - "**/.env"

# In the `octo-repo` repository in this organization:
octo-repo:
  # Ignore the `/src/some-dir/kernel.rs` file.
  - "/src/some-dir/kernel.rs"

# In the `primer/react` repository on GitHub:
https://github.com/primer/react.git:
  # Ignore files called `secrets.json` anywhere in this repository.
  - "secrets.json"
  # Ignore files called `temp.rb` in or below the `/src` directory.
  - "/src/**/temp.rb"

# In the `copilot` repository of any GitHub organization:
git@github.com:*/copilot:
  # Ignore any files in or below the `/__tests__` directory.
  - "/__tests__/**"
  # Ignore any files in the `/scripts` directory.
  - "/scripts/*"

# In the `gitlab-org/gitlab-runner` repository on GitLab:
git@gitlab.com:gitlab-org/gitlab-runner.git:
  # Ignore the `/main_test.go` file.
  - "/main_test.go"
  # Ignore any files with names beginning with `server` or `session` anywhere in this repository.
  - "{server,session}*"
  # Ignore any files with names ending with `.md` or `.mk` anywhere in this repository.
  - "*.m[dk]"
  # Ignore files directly within directories such as `packages` or `packaged` anywhere in this repository.
  - "**/package?/*"
  # Ignore files in or below any `security` directories, anywhere in this repository.
  - "**/security/**"

"*":
  - "**/.env"

octo-repo:

  - "/src/some-dir/kernel.rs"

https://github.com/primer/react.git:

  - "secrets.json"

  - "/src/**/temp.rb"

git@github.com:*/copilot:

  - "/__tests__/**"

  - "/scripts/*"

git@gitlab.com:gitlab-org/gitlab-runner.git:

  - "/main_test.go"

  - "{server,session}*"

  - "*.m[dk]"

  - "**/package?/*"

  - "**/security/**"

# Ignore all `.env` files from all file system roots (Git and non-Git).
# For example, this excludes `REPOSITORY-PATH/.env` and also `/.env`.
# This could also have been written on a single line as:
#
# "*": ["**/.env"]
"*":
  - "**/.env"

# In the `octo-repo` repository in this organization:
octo-repo:
  # Ignore the `/src/some-dir/kernel.rs` file.
  - "/src/some-dir/kernel.rs"

# In the `primer/react` repository on GitHub:
https://github.com/primer/react.git:
  # Ignore files called `secrets.json` anywhere in this repository.
  - "secrets.json"
  # Ignore files called `temp.rb` in or below the `/src` directory.
  - "/src/**/temp.rb"

# In the `copilot` repository of any GitHub organization:
git@github.com:*/copilot:
  # Ignore any files in or below the `/__tests__` directory.
  - "/__tests__/**"
  # Ignore any files in the `/scripts` directory.
  - "/scripts/*"

# In the `gitlab-org/gitlab-runner` repository on GitLab:
git@gitlab.com:gitlab-org/gitlab-runner.git:
  # Ignore the `/main_test.go` file.
  - "/main_test.go"
  # Ignore any files with names beginning with `server` or `session` anywhere in this repository.
  - "{server,session}*"
  # Ignore any files with names ending with `.md` or `.mk` anywhere in this repository.
  - "*.m[dk]"
  # Ignore files directly within directories such as `packages` or `packaged` anywhere in this repository.
  - "**/package?/*"
  # Ignore files in or below any `security` directories, anywhere in this repository.
  - "**/security/**"

Configuración de la exclusión de contenido para la empresa

Como propietario de la empresa, puede usar la configuración de empresa para especificar los archivos que GitHub Copilot deben omitirse. Los archivos pueden estar dentro de un repositorio de Git o en cualquier parte del sistema de archivos que no está bajo control de Git.

1. Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.
2. En la parte superior de la página, haga clic en controles de IA.
3. En la barra lateral, haga clic en Copilot.
4. Haga clic en Exclusión de contenido.
5. Usa rutas de acceso para especificar qué contenido se debe excluir. Consulte la sección anterior, Configuración de la exclusión de contenido para la organización.

Prueba de los cambios en la exclusión de contenido

Puede utilizar su IDE para confirmar que los cambios en las exclusiones de contenido están funcionando como se esperaba.

Propagación de los cambios de exclusión de contenidos a su IDE

Después de agregar o cambiar las exclusiones de contenido, puede tardar hasta 30 minutos en surtir efecto en los IDE en los que la configuración ya está cargada. Si no desea esperar, puede volver a cargar manualmente la configuración de exclusión de contenido mediante las instrucciones siguientes.

• Para los IDE de JetBrains y Visual Studio, vuelva a cargar la configuración de exclusión de contenido cerrando y reabrindo la aplicación.
• Para Visual Studio Code, siga estos pasos para volver a cargar la configuración de exclusión de contenido:
  1. Accede a la paleta de comandos. Por ejemplo, presionando Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux).
  2. Escriba: reload.
  3. Seleccione Programador: Volver a cargar ventana.
• Para Vim/Neovim, las exclusiones de contenido se capturan automáticamente de GitHub cada vez que abre un archivo.

Prueba de las exclusiones de contenido

Puede comprobar que las exclusiones de contenido configuradas funcionan según lo previsto.

1. En primer lugar, confirme que la exclusión de contenido funciona en archivos que no están sujetos a la exclusión de contenido. Para hacer esto:
   • En el IDE, abre un archivo que no esté sujeto a la exclusión de contenido.
   • Realice una edición que normalmente generaría una sugerencia en línea. Se debería ofrecer una sugerencia
2. Abra un archivo que se deba excluir y realice la misma edición. No se debería ofrecer una sugerencia.
3. Para probar la exclusión de contenido para Chat de Copiloto:

   • En su IDE, abra el panel Chat de Copiloto.

   • Abra un archivo que se deba excluir y cierre cualquier otro archivo que esté abierto en el editor.

   • Asegúrese de que el archivo abierto está asociado al mensaje como archivo de contexto.

   • Escribe el símbolo del sistema explain this file.

     Si se excluye el archivo, Chat de Copiloto no podrá usar el archivo para generar una respuesta. El archivo no aparecerá como una referencia en la respuesta de Copilot.

Administración de exclusiones de contenido con la API REST

Los propietarios de la organización y los propietarios de empresas también pueden administrar exclusiones de contenido mediante programación mediante la GitHub API REST.

Para más información, consulta Puntos de conexión de la API REST para la administración de exclusión de contenido de Copilot.

Información adicional

• Exclusión de contenido para GitHub Copilot
• Revisión de los cambios en las exclusiones de contenido para GitHub Copilot
• Configuración de la exclusión de contenido para Visual Studio en la documentación de Microsoft Learn