Código e agentesGitHub

API do GitHub AI Scan: habilitar não significa concluir uma análise

A atualização do GitHub de 13 de novembro adiciona controles repository_scan à API REST do AI Scan. As equipes podem gerenciar as configurações de implantação por código, mas a herança de políticas, as falhas em atualizações conjuntas e as análises manuais ainda precisam de verificações separadas.

Um orc programador de pele verde-musgo ajusta um controle de cobre ligado a peças de repositórios em tom de lavanda, enquanto um cabeçote de varredura de vidro permanece apagado em um braço de madeira.
Ilustração conceitual.

O que muda com a atualização de 13 de novembro

O GitHub adicionou repository_scan aos endpoints existentes de configuração do AI Scan para organizações e repositórios, em prévia pública. GET e PATCH usam /orgs/{org}/code-scanning/ai-scan ou /repos/{owner}/{repo}/code-scanning/ai-scan. A nova propriedade aceita enabled ou disabled, junto do controle pr_scan já existente para pull requests.

Isso permite incorporar uma mudança de configuração a scripts de implantação e definições de infraestrutura. Não transforma esses scripts em um agendador de análises. Para repositórios pertencentes a organizações, o anúncio abrange os públicos e os privados ou internos que contam com GitHub Code Security ou GitHub Advanced Security. O GitHub Enterprise Server não é compatível com esta atualização. Consulte a documentação atual de elegibilidade para o tipo de proprietário e a visibilidade dos repositórios que você usa.

Consulte a hierarquia de políticas antes de alterar uma configuração

Quando uma organização desabilita a análise de repositórios, seus repositórios não podem habilitá-la por conta própria. Quando a organização habilita o recurso, os repositórios elegíveis herdam a configuração e seus administradores podem desabilitá-la individualmente. Uma restrição da empresa continua tendo precedência: uma tentativa de habilitar o AI Scan que contrarie essa restrição retorna 422. O valor desejado para um repositório não pode se sobrepor a uma política de nível superior.

A API também diferencia consulta de administração. Os requisitos dos tokens com permissões granulares variam conforme o endpoint: consultas de organizações exigem permissão de leitura de Administration, enquanto consultas de repositórios exigem permissão de leitura de Code scanning alerts; atualizações exigem permissão de escrita de Administration no nível correspondente. Verifique tanto o papel de quem faz a solicitação quanto as permissões do endpoint específico. Um processo de inventário somente leitura não deve receber acesso de escrita só porque uma etapa posterior da implantação precisa dele.

Uma atualização conjunta bloqueada não altera nenhum dos campos

O GitHub permite incluir pr_scan e repository_scan na mesma solicitação. Se alguma das mudanças solicitadas não puder ser aplicada, a solicitação falha e nenhuma das duas configurações muda. Por exemplo, uma solicitação que altera a análise de pull requests e habilita a análise do repositório não deve ser registrada como uma implantação parcialmente bem-sucedida quando um dos campos estiver bloqueado.

Trate esse processo como uma verificação de que o estado real corresponde ao desejado. Salve os valores iniciais, envie apenas a mudança pretendida e autorizada e depois compare a resposta e uma nova consulta com os valores desejados. Um 422 não comprova que um dos campos foi atualizado, nem identifica sempre a mesma causa: a referência REST também lista falhas de validação. Mantenha o erro retornado no registro da implantação e resolva sua causa real antes de tentar novamente.

Habilitado, analisado e revisado são estados diferentes

Habilitar repository_scan não inicia uma análise. Usuários com acesso de escrita disparam as análises sob demanda; cada execução consome créditos do Code Security AI. A documentação atual limita as análises de repositórios à branch padrão e informa que análises agendadas e automáticas a cada push não são compatíveis. Por isso, o orçamento e a execução da análise precisam de responsáveis e evidências próprios.

Uma análise concluída também é uma busca limitada, não uma prova de que todo o repositório está livre de vulnerabilidades. O GitHub descreve um agente que seleciona o código a examinar dentro de um limite de tempo. A documentação alerta para vulnerabilidades que podem passar despercebidas, alertas duplicados com o CodeQL e resultados imprecisos gerados por IA. Revise cada alerta e suas evidências; não transforme uma configuração habilitada nem um resultado vazio em um certificado de ausência de vulnerabilidades.

Um registro da implantação que outro desenvolvedor possa revisar

Para um piloto pequeno, o Codorc sugere registrar separadamente os pontos de verificação a seguir. São verificações operacionais propostas, não resultados de um teste da API real nem uma avaliação da qualidade de detecção do GitHub.

  • Identifique a organização, a visibilidade do repositório e a política da empresa aplicável. Confirme a elegibilidade, quem é o administrador responsável e qual é o orçamento de créditos aprovado antes de alterar qualquer coisa.
  • Salve as configurações atuais da organização e do repositório com data e hora. Mantenha credenciais fora dos logs e use apenas as permissões necessárias em cada etapa.
  • Registre as mudanças pretendidas nos campos e o status retornado. Em uma atualização conjunta, verifique os dois campos juntos; após uma resposta incerta, consulte o estado antes de enviar outra solicitação de escrita.
  • Registre uma análise disparada deliberadamente separada da habilitação: qual revisão da branch padrão foi examinada, quando a execução terminou e qual consumo foi informado.
  • Designe uma pessoa para revisar os resultados e verificar as correções. Registre por que um alerta foi aceito, descartado ou considerado duplicado e leve em conta as limitações documentadas das novas análises ao conferir uma correção.

A data do evento corresponde ao anúncio original. A data de publicação indica quando o artigo apareceu na Codorc.

Continue lendo

Todas as histórias
Um orc programador verde-musgo escolhe uma chave de fenda com cabo de cobre em um painel de ferramentas lavanda, ao lado de uma caixa de ferramentas fechada, cor de ameixa, com fecho de cobre.
Código e agentesGoogle / Introducing Tool Retrieval in the Gemini API

Gemini Tool Retrieval: confira o limite entre descoberta e execução

O Google apresentou o Tool Retrieval em prévia em 19 de novembro. A API Interactions do Gemini pode carregar esquemas de ferramentas sob demanda, mas os desenvolvedores ainda precisam distinguir descoberta, execução, autorização e o custo total de uma tarefa concluída.

Um orc programador de pele verde-musgo mede um conector de cobre com um paquímetro, ao lado de uma porta em tom de lavanda e de uma pequena lhama de cerâmica cor de creme.
Código e agentesggml-org / Hugging Face

llama.cpp 1.0: confira a API e a ABI antes de atualizar

As versões do llama.cpp e do ggml de 13 de novembro estabelecem limites explícitos de compatibilidade para as bibliotecas. Em uma integração existente, revise as APIs removidas, mantenha cabeçalhos e binários alinhados e verifique os pares RPC antes de trocar a compilação implantada.

Um pequeno robô de oficina verde-musgo encaixa componentes de interface em tom lavanda em uma moldura de latão, ao lado de bandejas de componentes organizadas.
Código e agentesGoogle Developers

A2UI 1.0: confira o suporte dos renderizadores antes de migrar

O Google anunciou a primeira versão estável do protocolo A2UI em 11 de novembro. Para desenvolvedores, o próximo passo útil é verificar a integração versão por versão: um protocolo estável não significa que todos os renderizadores ou ambientes hospedeiros tenham concluído a atualização.