---
title: 连接和控制Agent应用
description: 查找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应用缺失

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

## 相关指南

- [应用和集成概览](../apps-and-integrations)
- [连接、管理和重新连接应用](./connect-manage-reconnect)
- [排查应用连接问题](./troubleshooting)