Código y agentesGitHub

API de GitHub AI Scan: activar la función no equivale a completar un análisis

La actualización de GitHub del 13 de noviembre añade controles repository_scan a la API REST de AI Scan. Los equipos pueden gestionar la configuración del despliegue mediante código, pero la herencia de políticas, los fallos en actualizaciones conjuntas y los análisis manuales siguen necesitando comprobaciones independientes.

Un orco programador de color verde musgo ajusta un mando de cobre conectado a unas fichas de repositorios de color lavanda, mientras un cabezal de escaneo de cristal permanece apagado en un brazo de madera.
Ilustración conceptual.

Qué cambia con la actualización del 13 de noviembre

GitHub ha añadido repository_scan a los endpoints existentes de configuración de AI Scan para organizaciones y repositorios, en versión preliminar pública. GET y PATCH utilizan /orgs/{org}/code-scanning/ai-scan o /repos/{owner}/{repo}/code-scanning/ai-scan. La nueva propiedad admite enabled o disabled, junto con el control pr_scan ya existente para las solicitudes de cambios.

Esto permite incorporar un cambio de configuración a scripts de despliegue y definiciones de infraestructura. No convierte esos scripts en un programador de análisis. Para los repositorios de organizaciones, el anuncio incluye los públicos y los privados o internos que cuentan con GitHub Code Security o GitHub Advanced Security. GitHub Enterprise Server no es compatible con esta actualización. Consulta la documentación actual de requisitos para el tipo de propietario y la visibilidad de los repositorios que utilizas.

Consulta la jerarquía de políticas antes de modificar una opción

Si una organización desactiva el análisis de repositorios, sus repositorios no pueden activarlo por su cuenta. Cuando la organización lo activa, los repositorios aptos heredan esa configuración y sus administradores pueden desactivarla individualmente. Las restricciones de la empresa siguen teniendo prioridad: un intento de activar AI Scan que incumpla una de ellas devuelve 422. El valor deseado para un repositorio no puede imponerse a una política de nivel superior.

La API también distingue entre consultar y administrar. Los requisitos de los tokens de permisos detallados varían según el endpoint: las consultas de organizaciones requieren permiso de lectura de Administration, mientras que las de repositorios requieren permiso de lectura de Code scanning alerts; las actualizaciones necesitan permiso de escritura de Administration en el nivel correspondiente. Verifica tanto el rol de quien realiza la solicitud como los permisos del endpoint concreto. Un proceso de inventario de solo lectura no debe recibir permisos de escritura simplemente porque una fase posterior del despliegue los necesite.

Una actualización conjunta bloqueada no modifica ninguno de los campos

GitHub permite incluir pr_scan y repository_scan en una misma solicitud. Si alguno de los cambios solicitados no puede aplicarse, la solicitud falla y ninguna de las dos opciones cambia. Por ejemplo, una solicitud que modifica el análisis de solicitudes de cambios y activa el análisis del repositorio no debe registrarse como un despliegue parcialmente correcto si uno de los campos está bloqueado.

Trata este proceso como una comprobación de que el estado real coincide con el deseado. Guarda los valores iniciales, envía únicamente el cambio previsto y autorizado y compara después la respuesta y una nueva consulta con los valores deseados. Un 422 no demuestra que uno de los campos se haya actualizado, y tampoco identifica siempre la misma causa: la referencia REST también contempla errores de validación. Conserva el error devuelto en el registro del despliegue y resuelve su causa real antes de reintentar.

Activado, analizado y revisado son estados distintos

Activar repository_scan no inicia un análisis. Los usuarios con permiso de escritura ejecutan los análisis bajo demanda; cada ejecución consume créditos de Code Security AI. La documentación actual limita los análisis de repositorios a la rama predeterminada e indica que no se admiten análisis programados ni automáticos al hacer push. Por tanto, el presupuesto y la ejecución del análisis necesitan responsables y pruebas propios.

Un análisis terminado también es una búsqueda limitada, no una prueba de que todo el repositorio esté libre de vulnerabilidades. GitHub describe un agente que selecciona el código que examina dentro de un límite de tiempo. Su documentación advierte de vulnerabilidades que pueden pasar desapercibidas, alertas duplicadas con CodeQL y hallazgos de IA inexactos. Revisa cada alerta y sus pruebas; no conviertas una opción activada ni un resultado vacío en un certificado de ausencia de vulnerabilidades.

Un registro del despliegue que otro desarrollador pueda revisar

Para una prueba piloto pequeña, Codorc propone registrar por separado los siguientes puntos de control. Son comprobaciones operativas propuestas, no resultados de una prueba real de la API ni una evaluación de la calidad de detección de GitHub.

  • Identifica la organización, la visibilidad del repositorio y la política de empresa aplicable. Confirma que se cumplen los requisitos, quién es el administrador responsable y cuál es el presupuesto de créditos aprobado antes de cambiar nada.
  • Guarda la configuración actual de la organización y del repositorio con una marca de tiempo. Evita que las credenciales aparezcan en los registros y utiliza solo los permisos que necesita cada fase.
  • Registra los cambios previstos en los campos y el estado devuelto. En una actualización conjunta, verifica ambos campos a la vez; si la respuesta es incierta, consulta el estado antes de enviar otra escritura.
  • Registra un análisis iniciado deliberadamente por separado de la activación: qué revisión de la rama predeterminada se examinó, cuándo terminó la ejecución y qué consumo se notificó.
  • Asigna a una persona la revisión de los hallazgos y la verificación de las correcciones. Registra por qué una alerta se aceptó, se descartó o se consideró duplicada, y ten presentes las limitaciones documentadas de los nuevos análisis al comprobar una corrección.

La fecha del suceso corresponde al anuncio original. La fecha de publicación indica cuándo apareció el artículo en Codorc.

Continúa leyendo

Todas las historias
Un orco programador de color verde musgo elige un destornillador con mango de cobre de un panel de herramientas lavanda, junto a un arcón de herramientas cerrado de color ciruela con un cierre de cobre.
Código y agentesGoogle / Introducing Tool Retrieval in the Gemini API

Gemini Tool Retrieval: comprueba el límite entre descubrir y ejecutar herramientas

Google presentó Tool Retrieval en versión preliminar el 19 de noviembre. La API Interactions de Gemini puede cargar esquemas de herramientas cuando se necesitan, pero los desarrolladores aún deben distinguir entre descubrimiento, ejecución, autorización y el coste total de completar una tarea.

Un orco programador de color verde musgo mide un conector de cobre con un calibrador, junto a un puerto de color lavanda y una pequeña llama de cerámica color crema.
Código y agentesggml-org / Hugging Face

llama.cpp 1.0: comprueba la API y la ABI antes de actualizar

Las versiones de llama.cpp y ggml del 13 de noviembre establecen límites explícitos de compatibilidad para sus bibliotecas. Si ya tienes una integración, revisa las API eliminadas, mantén alineadas las cabeceras y los binarios, y comprueba los pares RPC antes de cambiar la compilación desplegada.

Un pequeño robot de taller verde musgo encaja componentes de interfaz de color lavanda en un marco de latón, junto a bandejas de componentes ordenadas.
Código y agentesGoogle Developers

A2UI 1.0: comprueba el soporte de los renderizadores antes de migrar

Google anunció la primera versión estable del protocolo A2UI el 11 de noviembre. Para los desarrolladores, el siguiente paso útil es comprobar la integración versión por versión: que el protocolo sea estable no significa que todos los renderizadores o entornos anfitriones hayan completado su actualización.