Configuración de Bits Code

Documentación > Bits AI > Bits Code > Configuración de Bits Code

Esta traducción no está actualizada. Para consultar la última versión en inglés, haz clic aquí

Descripción general

Bits Code se integra con proveedores de código fuente para abrir, actualizar e iterar en solicitudes de extracción o fusión basadas en problemas detectados en Datadog. Después de completar la configuración, puede comenzar a usar Bits Code.

Requisitos previos

Para configurar Bits Code, necesita el permiso Bits Code Write (bits_dev_write). Este permiso está incluido en roles gestionados de Datadog, como el rol estándar de Datadog.

Si su organización utiliza roles personalizados, un administrador debe agregar este permiso manualmente. Para obtener más detalles, consulte Access Control.

Configuración

Configure Bits Code para uno de los proveedores de código fuente compatibles.

Instale la integración de GitHub. Para conocer los pasos completos de instalación y configuración, consulte la guía de integración de GitHub.
En su cuenta de GitHub, navegue a Settings > Apps > Datadog para configurar los permisos de GitHub.
1. Para habilitar la funcionalidad básica de Bits Code, establezca los siguientes permisos:
  - Repository permissions
    - Contenido del repositorio: Lectura y escritura
    - Solicitudes de extracción: Lectura y escritura
  - Subscribe to events
    - Push
2. (Opcional) Para permitir que Bits Code utilice registros de CI al iterar en solicitudes de extracción, debe enviar los registros de CI a Datadog y habilitar la función auto-push. Esto requiere permisos adicionales:
  - Repository permissions
    - Verificaciones: Lectura
    - Estados de confirmación: Solo lectura
  - Subscribe to events
    - Ejecución de verificación
    - Conjunto de verificaciones
    - Comentario de incidencia
    - Estado

Instale la integración de código fuente de GitLab. Para conocer los pasos completos de instalación y configuración, consulte la guía de integración de código fuente de GitLab.
Verifique que la cuenta de servicio de GitLab cumpla con los siguientes requisitos:
- La cuenta de servicio debe tener el rol de desarrollador en el proyecto. Este rol puede heredarse de un grupo.
- El token de acceso personal de la cuenta de servicio debe tener los siguientes ámbitos: api, write_repository y read_user.
No puede modificar los ámbitos de un token de acceso personal de GitLab existente. Si necesita crear un token que incluya los ámbitos anteriores, agregue todos los ámbitos requeridos por otros productos de Datadog que utilicen la integración de código fuente de GitLab.

Instale la integración de código fuente de Azure DevOps. Para conocer los pasos completos de instalación y configuración, consulte la guía de integración de código fuente de Azure DevOps.
Verifique que la entidad de servicio de la aplicación de Microsoft Entra sea un Colaborador del proyecto en cada proyecto, o que pertenezca a un grupo personalizado con los siguientes permisos de repositorio:
- Contribuir
- Contribuir a las solicitudes de extracción
- Crear rama
- Leer

Si la validación de correo electrónico del autor de la confirmación está habilitada, agregue no-reply@dtdg.co a las direcciones de correo electrónico permitidas. Bits Code utiliza esta dirección para las confirmaciones que crea.

Configuración adicional

Estas configuraciones opcionales le ayudan a aprovechar al máximo Bits Code.

Configurar el etiquetado de telemetría

Bits Code utiliza las etiquetas de telemetría service y version para hacer coincidir los problemas detectados (como errores o vulnerabilidades) con la versión del código que se estaba ejecutando en ese momento.

Para configurar el etiquetado de telemetría, consulte Etiquete su telemetría de APM con información de Git.

También puede configurar la asignación de servicio a repositorio manualmente en la configuración de Bits Code en Repositories > Service Repository Mapping.

Habilitar auto-push

Auto-push permite que Bits Code cree ramas, envíe código y abra PR o MR cuando detecta algo con lo que puede ayudarle. Auto-push solo abre PR o MR y envía cambios; nunca fusiona código. Cuando auto-push está deshabilitado, debe revisar el código en Datadog antes de que se envíe.

Para habilitar auto-push, navegue a Bits Code > Settings > General.

Consideraciones de seguridad

Permitir que cualquier herramienta basada en IA lea datos no confiables puede permitir que los atacantes influyan en su resultado. El comportamiento de auto-push depende del tipo de datos con los que trabaja Bits Code: los flujos de trabajo que solo usan código operan sobre el código fuente que el Agent puede inspeccionar directamente, mientras que los flujos de trabajo basados en telemetría (como errores o trazas) pueden incluir entradas de tiempo de ejecución no confiables.

Para equilibrar la seguridad y la automatización, puede configurar el comportamiento de auto-push en Datadog (por ejemplo, limitando auto-push a flujos de trabajo que solo usan código o requiriendo una revisión cuando hay telemetría involucrada). Datadog escanea todo el código generado por el Agent antes de enviar los cambios, pero estas medidas de seguridad no son infalibles.

Configurar instrucciones personalizadas

Bits Code ingiere archivos de instrucciones personalizadas desde su repositorio, incluyendo:

AGENTS.md
CLAUDE.md
agent.md
.cursorrules
.windsurfrules
copilot-instructions.md

También puede definir instrucciones personalizadas globales que se apliquen a todas las sesiones de Bits Code en Bits Code > Settings > General, en la sección Global Agent Instructions.

Un archivo de instrucciones personalizadas es un buen lugar para mencionar las habilidades personalizadas que le gustaría que Bits Code utilizara.

Configuración del entorno

Configure el entorno de ejecución de Bits Code, incluidas las políticas de acceso a la red y las herramientas específicas del repositorio.

Configurar el acceso a internet

De forma predeterminada, Bits Code no tiene acceso a internet durante la ejecución del agente. Para configurar a qué dominios externos pueden acceder los agentes, navegue a Bits Code > Settings > General y busque la sección Internet Access. Elija entre las siguientes políticas de acceso: No Internet Access, Default Allowlist, Custom + Default Allowlist o Custom Allowlist.

La lista de permitidos predeterminada incluye los siguientes dominios. Esta lista evolucionará con el tiempo según los comentarios de los usuarios y los cambios en el ecosistema. Para evitar cambios, configure una lista de permitidos personalizada.

Lenguaje	Dominios
Clojure/JVM	`repo.clojars.org`
Go	`pkg.go.dev`, `proxy.golang.org`, `sum.golang.org`, `vuln.go.dev`
Java/JVM	`repo1.maven.org`
JavaScript/TypeScript	`registry.npmjs.org`, `registry.yarnpkg.com`, `repo.yarnpkg.com`
.NET/C#	`api.nuget.org`
PHP	`packagist.org`, `repo.packagist.org`
Python	`files.pythonhosted.org`, `pypi.org`, `pypi.python.org`, `pythonhosted.org`
Ruby	`api.rubygems.org`, `index.rubygems.org`, `rubygems.org`
Rust	`index.crates.io`, `static.crates.io`
Ubuntu	`archive.ubuntu.com`, `ports.ubuntu.com`, `security.ubuntu.com`

Configurar el entorno del repositorio

Configure un entorno personalizado para que Bits Code instale las dependencias, formateadores, linters y herramientas de compilación que se necesitan para su base de código. Cada repositorio se ejecuta en su propio sandbox aislado, y el entorno define la configuración para ese sandbox.

Para configurar un entorno de repositorio:

Vaya a Bits Code > Settings > Repositories, y busque la sección Environments.
Haga clic en Add Environment para crear una configuración de repositorio:
1. Seleccione un repositorio de la lista desplegable.
2. (Opcional) En Pre-installed Languages, haga clic en Select Versions para especificar las versiones de lenguaje que debe usar el sandbox.
3. (Opcional) Defina variables de entorno y secretos. Las variables de entorno están disponibles tanto durante la configuración del entorno como durante la ejecución de Bits Code. Los secretos están disponibles como variables de entorno solo durante la configuración del entorno.
4. (Opcional) Agregue un script de shell con comandos de configuración para ejecutar (por ejemplo: pip install -r requirements.txt).
Ejecute el comando de configuración para asegurarse de que se ejecute correctamente.
Guarde la configuración.

Bits Code ejecuta el comando de configuración al inicio y puede usar cualquier herramienta instalada en su entorno. El comando de configuración se ejecuta con acceso a la red habilitado para descargar dependencias. Después de completar la configuración, su política de acceso a internet controla el acceso a la red saliente durante la ejecución del agente. Debido a que los comandos de configuración se ejecutan en el código de su repositorio, habilítelos solo si confía en el código del repositorio.

Nota: Para obtener mejores resultados, agregue un archivo de instrucciones personalizadas (como claude.md) a su repositorio con instrucciones sobre cómo compilar y probar su código.

Solución de problemas

La creación de PR de GitHub falla inesperadamente

En algunos casos, especialmente en repositorios con muchas ramas, GitHub no ejecuta la verificación de permisos al crear una rama para la sesión. Si utiliza una aplicación de GitHub personalizada, puede solucionar este problema agregando el permiso workflows:write a su aplicación en la integración de GitHub.

Nota: Este permiso permite que Bits AI cree flujos de trabajo en su repositorio y tiene implicaciones de seguridad.