Vercel News

Vercel Connect support in GitHub Tools

8.5内容质量

TL;DR · AI 摘要

Vercel Connect 现在通过 GitHub Tools 提供更安全的 GitHub 集成方式，使用短期令牌替代长期密钥。

核心要点

  • 使用短期令牌替代长期密钥，消除秘密存储和泄露风险
  • Vercel 部署自动通过 OIDC 令牌认证，无需手动配置
  • 支持 code-review 等 3 种预设权限范围自动映射 Connect scopes

结构提纲

按章节快速跳转。

  1. §引言

    宣布 GitHub Tools 新增 Vercel Connect 专有集成支持

  2. ·核心机制

    通过 @github-tools/sdk/connect 子路径实现令牌动态生成

  3. ›安全优势

    消除长期密钥存储需求，采用短期作用域令牌

  4. ·集成方式

    提供 code-review 等 3 种预设权限配置方案

  5. ›部署配置

    Vercel 部署自动使用 OIDC 令牌认证

  6. ·扩展能力

    支持多租户配置和自定义工具工厂实现

思维导图

用一张图看清主题之间的关系。

查看大纲文本（无障碍 / 无 JS 友好）
  • Vercel Connect GitHub集成
    • 核心机制
      • 动态令牌生成
    • 安全优势
      • 无长期密钥存储
      • 作用域限定
    • 集成特性
      • 3种预设权限
      • OIDC自动认证

金句 / Highlights

值得收藏与分享的关键句。

#Vercel#GitHub Tools#CI/CD#安全#DevOps
打开原文

GitHub Tools 中的 Vercel Connect 支持 - Vercel

GitHub Tools 现在通过新的 @github-tools/sdk/connect 子路径原生支持 Vercel Connect。不再需要存储长期有效的个人访问令牌，您的代理会通过连接器在运行时生成短期、作用域限定的 GitHub 令牌。无需存储、轮换或泄露任何密钥。

将 GitHub 连接器附加到您的项目并选择预设：

code
1
import
{
connectGithubTools
}
from
"@github-tools/sdk/connect"
;
2
import
{
generateText
}
from
"ai"
;
3
4
const
tools
=
connectGithubTools
(
"github/my-connector"
,
{
5
preset
:
"code-review"
,
6
}
)
;
7
8
const
{
text
}
=
await
generateText
(
{
9
model
:
"anthropic/claude-sonnet-5"
,
10
tools
,
11
prompt
:
"Summarize open PRs on vercel-labs/github-tools."
,
12
}
)
;

使用自定义代理审阅 GitHub PR

  • 预设范围映射：code-review、issue-triage 和 maintainer 等预设会自动映射到 Connect 范围，因此令牌仅包含工具集所需的权限。
  • 支持 eve：从 @github-tools/sdk/connect/eve 导入，并在 agent/tools/ 中添加一个文件即可通过 Connect 认证注册完整工具集。
  • 多租户就绪：可通过覆盖 installationId、repositories 或 scopes 参数，针对特定安装或限制单个仓库的访问权限。
  • Vercel 零配置：部署会自动使用 OIDC 令牌进行认证。本地开发时运行 vercel link 和 vercel env pull。

对于自定义工具工厂，connectGithubToken 返回一个惰性令牌提供者，可直接传递给 createGithubTools。

通过创建 GitHub 连接器并阅读文档来入门。