编程与代理GitHub

GitHub AI Scan API:启用不等于完成扫描

GitHub 在 11 月 13 日的更新中,为 AI Scan REST API 加入了 repository_scan 控制项。团队可以通过代码管理分阶段启用的设置,但策略继承、联合更新失败以及手动扫描,仍需分别检查。

一个苔绿色编程兽人调整铜制控制器,控制器通过导线连接着淡紫色仓库模块,旁边独立的玻璃扫描头未点亮,停放在木制支臂上。
概念插画。

11 月 13 日的更新改变了什么

GitHub 在现有的组织与仓库 AI Scan 设置端点中加入了 repository_scan,目前处于公开预览阶段。GET 和 PATCH 使用 /orgs/{org}/code-scanning/ai-scan 或 /repos/{owner}/{repo}/code-scanning/ai-scan。新属性接受 enabled 或 disabled,与用于控制拉取请求扫描的现有 pr_scan 属性并列。

这让上线脚本和基础设施定义能够修改配置,但并不会使脚本自动成为扫描调度器。对于组织所属仓库,公告涵盖公开仓库,以及已启用 GitHub Code Security 或 GitHub Advanced Security 的私有或内部仓库。本次更新不支持 GitHub Enterprise Server。请根据实际使用的仓库所有者和可见性,核对当前的适用条件文档。

写入设置前,先读懂策略层级

如果组织关闭仓库扫描,其下属仓库就不能自行开启。如果组织开启扫描,符合条件的仓库会继承该设置,而仓库管理员可以选择退出。企业层面的限制仍然优先:如果启用 AI Scan 的请求违反该限制,API 会返回 422。仓库层面期望设置的值,不能覆盖上级策略。

API 还区分读取与管理操作。细粒度访问令牌的要求因端点而异:组织设置的读取操作要求 Administration read,仓库设置的读取操作要求 Code scanning alerts read;更新操作则要求相应层级的 Administration write。请同时核实调用方角色和具体端点权限。不能仅因为后续上线阶段需要写入,就给只读盘点阶段授予写权限。

联合更新被阻止时,两个字段都不会改变

GitHub 允许在同一个请求中包含 pr_scan 和 repository_scan。如果任一请求变更无法应用,整个请求就会失败,两个设置都不会改变。例如,某个计划提交的请求同时修改拉取请求扫描并开启仓库扫描时,若其中一个字段被阻止,就不能把这次上线记录为部分成功。

应将此视为一次状态核对。记录初始值,只提交预期且已获授权的变更,再将响应和重新读取的状态与目标值比较。返回 422 并不能证明某个字段已成功更新,也不是所有 422 都指向同一种原因:REST 参考文档还列出了验证失败。应在上线记录中保留返回的错误,查明并解决实际原因后再重试。

已启用、已扫描与已审查是不同状态

启用 repository_scan 不会启动扫描。拥有写权限的用户需要按需触发扫描,每次运行都会消耗 Code Security AI credits。当前文档将仓库扫描限制在默认分支,并说明不支持定时扫描或推送后的自动扫描。因此,预算和扫描执行需要各自明确负责人,并保留证据。

一次完成的扫描,也只是在限定范围内进行的查找,不能证明整个仓库没有漏洞。GitHub 描述的方式是由代理在时间预算内选择要检查的代码。其文档提醒,可能存在漏报、与 CodeQL 告警重复,以及 AI 发现结果不准确等情况。应逐一审查告警及其证据,不能把一个启用标志或空结果当成仓库安全无漏洞的证明。

让另一位开发者也能审阅上线记录

对于小规模试点,Codorc 建议分别记录以下检查点。这些是拟议的运维检查,并非线上 API 测试结果,也不是对 GitHub 检测质量的评估。

  • 写明组织、仓库可见性及适用的企业策略。在做任何修改之前,确认适用条件、负责的管理员和获批的积分预算。
  • 带上时间戳,保存当前组织与仓库设置。日志中不要包含凭据,每个阶段仅使用其所需权限。
  • 记录计划修改的字段和返回状态。对于联合更新,要一并核验两个字段;响应结果不明确时,先读取状态,再决定是否再次写入。
  • 将主动触发的扫描与启用操作分开跟踪:检查了默认分支的哪个版本、扫描何时结束,以及报告了多少用量。
  • 指定专人审查发现结果并验证修复。记录告警被接受、驳回或认定为重复的原因;检查修复时,也要保留文档所列的重扫限制说明。

事件日期指原始公告日期,发布日期指本文首次刊登于 Codorc 的日期。

继续阅读

全部报道
一位苔绿色的编程兽人从淡紫色工具挂板上挑选一把铜柄螺丝刀,旁边放着一个用铜搭扣扣紧的深紫色工具箱。
编程与代理Google / Introducing Tool Retrieval in the Gemini API

Gemini Tool Retrieval:核对工具发现与实际执行之间的边界

Google 于 11 月 19 日推出 Tool Retrieval 预览版。Gemini Interactions API 可以按需加载工具参数模式,但开发者仍需区分工具发现、执行、授权,以及完成任务的全部成本。

一个苔绿色编程兽人用卡尺测量铜制连接件,旁边放着淡紫色接口模块和一只奶油色陶瓷羊驼。
编程与代理ggml-org / Hugging Face

llama.cpp 1.0:升级前先检查 API 与 ABI

11 月 13 日发布的 llama.cpp 和 ggml 为库兼容性划定了明确边界。对于现有集成,应先检查被移除的 API,确保头文件与二进制库一致,并核对 RPC 对端,再更换部署版本。

一个苔绿色的工作坊小机器人,将淡紫色界面组件装入黄铜窗口框架,旁边摆着分类整齐的组件托盘。
编程与代理Google Developers

A2UI 1.0:迁移前先确认渲染器的支持情况

Google 于 11 月 11 日宣布推出 A2UI 的首个稳定协议版本。对开发者而言,接下来最有价值的工作是逐项核对集成版本:协议稳定,并不意味着每个渲染器或宿主都已完成升级。