Runner AI
文档应用和集成

连接和控制Agent应用

查找Agent应用、选择其允许的工具、连接它并管理访问权限。

Agent应用让Runner Agent在处理您的项目时使用外部服务。您可以检查应用的工具并关闭您不希望Agent使用的工具。

开始前

入口路径: 项目 → 应用 → Agent应用

Agent应用是条件性的。该部分可能被隐藏、单个应用可能不可用或目录可能无法加载。可用性可能因工作区、项目、提供商和分阶段产品访问而异。

您需要:

  • 访问项目的权限;
  • 所选提供商接受的账户或凭证;以及
  • 允许Runner使用您保留启用的工具的权限。

在连接前查看每个工具。工具访问适用于当前项目,可以允许Agent在外部服务中读取或更改数据。

外部账户连接属于您登录的Runner账户,而工具开关为当前项目保存。因此,断开连接可能会移除其他项目使用的连接,即使它们的工具选择是分开的。

查找和检查应用

控件或状态为什么有用接下来会发生什么
搜索应用一起过滤存储应用和Agent应用。目录显示匹配的名称和描述。
类别选择器缩小Agent应用目录范围。选择 全部 以移除类别过滤器。
上一页下一页在长目录中移动。Runner显示匹配应用的前一页或后一页。
应用卡显示应用名称、描述和连接状态。选择它打开 应用详情
未找到应用显示当前过滤器没有匹配项。清除搜索 重置搜索和类别。
加载占位符显示Runner正在获取目录。在选择应用前等待卡加载。

应用详情控件

控件或状态为什么有用接下来会发生什么
应用描述和类别帮助确认您打开了预期的服务。查看详情不会授予外部访问权限。
工具开关限制Runner可以要求已连接应用执行的操作。在连接前,Runner使用您的选择保存连接。连接后,更改会立即保存。
工具列表中的 上一页下一页查看具有许多工具的应用。在不关闭对话框的情况下在工具间移动。
必需凭证字段支持不使用浏览器授权的应用。在填充必需字段前 连接 保持不可用。类似密钥的字段被掩盖。
连接在需要该策略时提交提供商凭证。Runner尝试使用您选择的工具访问进行连接。
连接并授权启动提供商授权。Runner打开授权窗口。
连接中...显示授权正在进行中。在Runner收到结果前该操作保持不可用。
已连接确认Runner识别了账户。关闭对话框或管理工具访问权限。
管理重新打开已连接的应用。查看和更改其启用的工具或断开连接。
断开连接开始移除。Runner询问 您确定要断开连接吗?
取消确认解决断开连接警告。取消保持访问权限;确认从Runner移除账户级Agent应用连接。项目工具设置是分开的。

连接Agent应用

  1. 打开 项目 → 应用 并滚动到 Agent应用
  2. 搜索应用或选择类别。
  3. 选择应用卡打开 应用详情
  4. 阅读其描述并检查每个可用工具。
  5. 关闭Runner不应在此项目中使用的任何工具。
  6. 输入必需的提供商凭证或选择 连接并授权
  7. 完成提供商步骤。如果您的浏览器阻止授权窗口,允许Runner的弹出窗口并重新开始。
  8. 返回对话框并确认它显示 已连接
  9. 稍后选择 管理 以查看工具访问权限或断开应用连接。

连接对话框声明提供商凭证通过连接服务发送,不由Runner存储。您仍应将每个凭证视为机密,仅在应用的凭证字段中输入。

更改工具访问权限

  1. 在已连接的应用上选择 管理
  2. 找到您想更改的工具。
  3. 打开或关闭其开关。
  4. 等待 工具已启用工具已禁用
  5. 如果Runner显示 无法更新工具,保持对话框打开、在刷新后检查当前开关,仅在保存状态清晰时重试。

禁用工具限制Runner对该工具的使用。它不会删除之前在外部服务中创建的数据。

修复或断开连接

如果目录不再显示可用的连接,打开应用并再次启动 连接连接并授权,然后确认 已连接

要移除访问权限,选择 管理 → 断开连接、查看确认并选择 确认。这移除登录账户的Agent应用连接,而不仅仅是当前项目的工具访问权限。如果断开连接失败,Runner保持已连接状态;不要假设外部账户已被移除。

如果Agent应用缺失

  • 该功能可能未为工作区启用。
  • 清除搜索并将类别设置为 全部
  • 如果目录从不离开其加载状态,刷新应用。
  • 单个应用可以报告它还不可用于连接。
  • 如果工具列表失败,在 应用详情 中选择 重试
  • 在当前工作区出现前,不应承诺任何特定目录条目。

相关指南