配置 Integrations
最近更新:
连接自己的外部服务账号,并授权 Agent 使用。
集成让自定义 Agent 使用已授权的外部服务账号,例如读取 GitHub 中的资料。同一种服务可以配置多个账号,Agent 选择其中一个使用。当前内建目录提供 GitHub。
开始前,准备服务要求的认证资料,并确认该账号可以访问任务需要的资源。
选择服务并配置账号
- Available integrations:可供配置的全局目录定义。
- Configured integrations:当前用户配置好的账号或服务端点。
- Connection:实际选择和绑定的连接实例;同一集成可配置多个账号。
- 在 Available integrations 的 GitHub 卡片上点击 Configure,完成所选认证方式要求的 setup。GitHub 的 OAuth 需要填写 OAuth App 的 Client ID 和 Client Secret;对话框中显示的 OAuth callback URL 需要登记到 GitHub 的 OAuth App 中。
- 在目录卡片中对应认证方式的那一行点击 New integration 创建 Connection,填写 Display name 和清晰的 Alias。保存新的 OAuth Connection 后,AGW 会自动打开授权页面。
- 确认连接状态为 Ready,再将具体连接绑定到 Agent 或 Project。连接卡片上的 Authorize 可以重新授权,Validate 可以重新检查连接。
- 在自定义 Agent 的新回合执行一个读取操作,核对访问的是预期账号。
Alias 创建后不可修改,并在当前用户内唯一;只能使用小写字母、数字和单个连字符,最多 128 个字符,输入的大写字母会转为小写。Connection 工具名称使用 {alias}__{operation},便于区分账号。GitHub 连接提供 {alias}__current_user、{alias}__list_repositories 和 {alias}__clone_repository 三个工具,分别用于读取当前账号、列出可访问的仓库,以及把仓库克隆到当前 Project 工作目录。


所有权与凭据
安装设置和 Connection 都属于当前用户。修改接入设置后,当前用户的相关连接需要重新检查;其他用户的连接不受影响。Agent 只能使用属于当前用户且处于 Ready 状态的连接。凭据读取、OAuth 和工具调用都验证所有权。
当前限制
没有远程 Plugin Marketplace 的下载、签名或升级机制;不执行第三方 Plugin Skill 自带脚本;Connection 不注入任何 External Agent(Claude Code、Codex、Pi)。连接变化不应被理解为实时改写已创建的工具列表,修改后使用新回合验证。