文档应用和集成
连接和控制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应用
- 打开 项目 → 应用 并滚动到 Agent应用。
- 搜索应用或选择类别。
- 选择应用卡打开 应用详情。
- 阅读其描述并检查每个可用工具。
- 关闭Runner不应在此项目中使用的任何工具。
- 输入必需的提供商凭证或选择 连接并授权。
- 完成提供商步骤。如果您的浏览器阻止授权窗口,允许Runner的弹出窗口并重新开始。
- 返回对话框并确认它显示 已连接。
- 稍后选择 管理 以查看工具访问权限或断开应用连接。
连接对话框声明提供商凭证通过连接服务发送,不由Runner存储。您仍应将每个凭证视为机密,仅在应用的凭证字段中输入。
更改工具访问权限
- 在已连接的应用上选择 管理。
- 找到您想更改的工具。
- 打开或关闭其开关。
- 等待 工具已启用 或 工具已禁用。
- 如果Runner显示 无法更新工具,保持对话框打开、在刷新后检查当前开关,仅在保存状态清晰时重试。
禁用工具限制Runner对该工具的使用。它不会删除之前在外部服务中创建的数据。
修复或断开连接
如果目录不再显示可用的连接,打开应用并再次启动 连接 或 连接并授权,然后确认 已连接。
要移除访问权限,选择 管理 → 断开连接、查看确认并选择 确认。这移除登录账户的Agent应用连接,而不仅仅是当前项目的工具访问权限。如果断开连接失败,Runner保持已连接状态;不要假设外部账户已被移除。
如果Agent应用缺失
- 该功能可能未为工作区启用。
- 清除搜索并将类别设置为 全部。
- 如果目录从不离开其加载状态,刷新应用。
- 单个应用可以报告它还不可用于连接。
- 如果工具列表失败,在 应用详情 中选择 重试。
- 在当前工作区出现前,不应承诺任何特定目录条目。